Skip to content

Commit ca183ee

Browse files
apoosrinimalchermanooshapilli
authored
WMS: 11481 - Improve text changes and fix issues (#134)
* ocw manifest files * Added Movies-Lab workshop files * ocw manifest files * 22.1 updates to Spreadsheet Lab * 22.1 updates * Update 1-sign-up-apex.md * Updated absolute urls * updated the common urls * updated the urls * Added a NOTE to indicate version difference * updated path for Lab 4 * Updated the paths * Updated the Workshop Title * Update screenshot in Task 2 Step 7 * Added alt text to images * URLS updated in index.html * Updated the steps for Option 2: Sign up for APEX using ADB * alt text for images * Shopping App 22.1 updates * 22.1 updates * archiving Shopping Cart 21.2 * Updated manifest files for OCW * Feedback updated for 22.1 * Updated the PL/SQL code for checkout * Update process-properties.png * Feedback update 22.1 * Hid the old walkthrough videos * Alt text for all images * Delete clothing-images.zip * Updated steps for Livelabs Green Button * Changes to steps for Livelabs Green button * Fixed the comments wrt PR * Updated screenshots in Common * OCW updates to optional labs * Updated filename in manifest for optional lab * OCI console Redwood theme screenshots Replacement of screenshots as per the new Redwood theme for OCI console * Resolved issue in APEX 22.2 for Task 5 Added an additional step to set the source for Region in Task 5. * Update manifest.json Lab 4 was pointing to an invalid lab. I have updated it to the correct folder path. * First Draft for New Workshop All the files related to the Social Media Workshop * Issue fix * Issue fixes * Issue Fix * issue-fix * removed lab 10 * screenshot fix * Replaced Screenshots * Updated screenshots * Replaced Screenshots * Updated Screenshots * Create menu-button.png * Issue fixes and time saver step * Lab 10 steps added * Fixed issues * Renamed Lab titles * Added Task 3 and 4 in Lab 8 * Updated screenshots * uploaded the catch up app * Update 0-introduction.md * Completed app zip files * Added download links from Object Storage * ocw23 folders * 23.1 changes * updated acknowledgements * Archive of 22.1 * Updated Movies and common * Updated APEX version in Intro * Feedback fixes * Grammar edits * Sign up for APEX using Quickstart * Updated Lab 10 Added missing steps to get device location * Added the support lab Added CloudWorld support labs for Movies Watchlist and Social Media Workshop * Updated Getting Started Common Lab Changed the steps to sign up for an APEX Service * Updated missing steps * Changed the title of Spreadsheet workshop * Embedded walkthrough videos Social Media Workshop * Grammar edits * Updated Need Help for OCW * Update 4-Update-table.md * Rename 4-Update-table.md to 4-update-table.md * Delete task-definition.md * Update 4-update-table.md * Fixing bugs * Added video walkthrough files * Update intro.md * Update manifest.json * Updated screenshots in Common * APEX 23.2 updates to Spreadsheet Updates to Spreadsheet and Common Lab * Naming issues fixed * Update 1-sign-up-apex.md * Fixed naming, prereq, obj * Naming issues fixed * Issue fixes in common lab * Changes in common and delete unwanted files * Removed duplicate folders * Updated all labs to 23.2 * Fixed the Manifest file errors * Updated steps and text related to a bug * New Lab added * Update 5-improve-ux.md * Update manifest.json * Update 5-improve-ux.md * fixed issues for new lab * Update introduction.md * Updated to latest files * renamed the images * Fixed issues and feedback * Title and text changes * Improve text and screenshots * Improve text --------- Co-authored-by: Michelle Malcher <48925485+malcherm@users.noreply.github.com> Co-authored-by: Anoosha Pilli <63126232+anooshapilli@users.noreply.github.com>
1 parent 808c5f0 commit ca183ee

File tree

10 files changed

+123
-183
lines changed

10 files changed

+123
-183
lines changed

ai-vision-lab/1-configure-oci/1-configure-oci.md

+15-13
Original file line numberDiff line numberDiff line change
@@ -33,25 +33,25 @@ To Generate the API Keys using OCI Console:
3333

3434
4. The Add API Key dialog is displayed. Select **Generate API Key Pair** to create a new key pair.
3535

36-
5. Click **Download Private Key** and save it to your local device. You do not need to download the public key.
36+
5. Click **Download Private Key**. A *.pem* file is saved to your local device. You do not need to download the public key.
3737

3838
*Note: You will use this private key while configuring the web credentials in Oracle APEX in the upcoming lab.*
3939

4040
6. Click **Add**.
4141

4242
![Profile Menu](images/add-api-key.png " ")
4343

44-
7. The key is added, and the Configuration File Preview is displayed. Copy and save the configuration file snippet from the text box. You will use this information in Oracle APEX Web Credentials.
44+
7. The key is added, and the Configuration File Preview is displayed. Copy and save the configuration file snippet from the text box into a notepad. You will use this information for creating Oracle APEX Web Credentials.
4545

4646
![Profile Menu](images/configuration-preview.png " ")
4747

4848
## Task 2: Create Web Credentials in Oracle APEX
4949

50-
Web credentials are used to authenticate connection to external REST services, or REST Enabled SQL services.
50+
Web credentials are used to authenticate connection to external REST services, or REST Enabled SQL services from APEX.
5151

52-
Creating Web Credentials securely stores and encrypts authentication credentials for use by Oracle APEX components and APIs. Credentials cannot be retrieved back in clear text. Credentials are stored at the workspace level and therefore are visible in all applications.
52+
Creating Web Credentials securely stores and encrypts authentication credentials for use by Oracle APEX components and APIs. Credentials cannot be retrieved back in clear text. Credentials are stored at the workspace level and therefore are visible to all applications.
5353

54-
To create web credentials in Oracle APEX:
54+
To create a Web Credential in Oracle APEX:
5555

5656
1. Login into your Oracle APEX workspace.
5757

@@ -65,30 +65,32 @@ To create web credentials in Oracle APEX:
6565

6666
![Click Workspace Utilities](images/workspace-utilities.png " ")
6767

68-
4. Click **Web Credentials**.
68+
4. Select **Web Credentials**.
6969

7070
![Click Web Credentials](images/sc-web-creds.png " ")
7171

72-
4. Click **Create**.
72+
5. Click **Create**.
7373

7474
![Create Web Credentials](images/create-wc.png " ")
7575

76-
5. Please enter the following details using the configuration file details you copied before and the API Key.
76+
6. Enter the following details using the configuration file you copied in the previous task.
7777

7878
- **Name**: apex\_ai\_cred
7979

8080
- **Authentication Type**: Oracle Cloud Infrastructure (OCI)
8181

82-
- **OCI User ID**: Enter the OCID of the Oracle Cloud user Account. You can find this in the Configuration File Preview generated during API Key creation.
82+
- **OCI User ID**: Enter the OCID of the Oracle Cloud user Account. You can find the OCID in the Configuration File Preview generated during the API Key creation.
8383
Your OCI User ID looks similar to **ocid1.user.oc1..aaaaaaaa\*\*\*\*\*\*wj3v23yla**
8484

85-
- **OCI Private Key**: Enter the API Key. Remove the header, footer, and carriage returns.
85+
- **OCI Private Key**: Open the private key (.pem file) downloaded in the previous task. Copy and paste the API Key.
86+
87+
![Private key file](images/private-key.png " ")
8688

87-
- **OCI Tenancy ID**: Enter OCID for the Tenancy.
89+
- **OCI Tenancy ID**: Enter the OCID for Tenancy. Your Tenancy ID looks similar to **ocid1.tenancy.oc1..aaaaaaaaf7ush\*\*\*\*cxx3qka**
8890

89-
- **OCI Public Key Fingerprint**: Enter the Fingerprint ID.
91+
- **OCI Public Key Fingerprint**: Enter the Fingerprint ID. Your Fingerprint ID looks similar to **a8:8e:c2:8b:fe:\*\*\*\*:ff:4d:40**
9092

91-
![Click App Builder](images/web-creds.png " ")
93+
![Web Credentials page](images/web-creds.png " ")
9294

9395
5. Click **Create**.
9496

Loading

ai-vision-lab/2-import-app/2-import-app.md

+13-36
Original file line numberDiff line numberDiff line change
@@ -4,16 +4,15 @@
44

55
In this lab, you import the Social Media application into your APEX workspace. You will use this imported app to integrate with the OCI Vision service.
66

7-
You can download the Social Media Application [here](https://objectstorage.us-ashburn-1.oraclecloud.com/p/LNAcA6wNFvhkvHGPcWIbKlyGkicSOVCIgWLIu6t7W2BQfwq2NSLCsXpTL9wVzjuP/n/c4u04/b/livelabsfiles/o/developer-library/APEX_Social_Media_HOL_FINAL.zip).
7+
You can download the Social Media Application [here](https://objectstorage.us-ashburn-1.oraclecloud.com/p/0Wfm2hnGpVe92JvuFjLYYIyouK4MgVpFDJyp9mKxuxfjAG6BB3P58m-79eOLKkPV/n/c4u04/b/livelabsfiles/o/developer-library/APEX_Social_Media_HOL_FINAL.zip).
88

99

1010
Estimated Time: 15 Minutes
1111

1212
### Objectives
1313
In this lab, you:
1414

15-
- Import the Social Media Application
16-
- Change the Authentication Type in Social Media Application
15+
- Import the Social Media Application into your APEX workspace
1716
- Add a Column to the Table using Object Browser to store the AI response
1817

1918
## Task 1: Import the Social Media Application
@@ -23,14 +22,15 @@ In this lab, you:
2322

2423
![Click Import](images/import0.png " ")
2524

26-
2. The Import dialog displays. Download and extract the Export Zip File of the APEX Social Media Application and then perform the following steps.
25+
2. The Import dialog displays. Download the [Zip File](https://objectstorage.us-ashburn-1.oraclecloud.com/p/0Wfm2hnGpVe92JvuFjLYYIyouK4MgVpFDJyp9mKxuxfjAG6BB3P58m-79eOLKkPV/n/c4u04/b/livelabsfiles/o/developer-library/APEX_Social_Media_HOL_FINAL.zip) of the APEX Social Media Application and then perform the following steps.
2726
- Drag and drop, or navigate to the file.
2827

2928
- File Type: Indicate the type of export file to be imported. Select **Application, Page, or Component Export**.
3029

3130
- File Character Set: Verify that the File Character Set is correct.
3231

3332
- Click **Next**.
33+
3434
The export file is imported.
3535

3636
![Click Import](images/import1.png " ")
@@ -47,60 +47,37 @@ In this lab, you:
4747

4848
![Click Import](images/edit-app1.png " ")
4949

50-
## Task 2: Change the Authentication Type in Social Media Application
5150

52-
The Social Media application is configured with a custom Security Authentication scheme. In this lab, you change the Authentication Type to Oracle APEX Accounts.
5351

54-
1. On the Workspace home page, click **App Builder**. Select the Social Media application. On the Application home page, click **Shared Components**. The Shared Components page appears.
52+
## Task 2: Add a Column to the Table using Object Browser
5553

56-
![Click Import](images/shared-comp1.png " ")
57-
58-
2. Under Security, select **Authentication Schemes**. The Authentication Schemes page appears.
59-
60-
![Click Import](images/sc-authentication.png " ")
61-
62-
3. To create a new authentication scheme, click **Create**.
63-
64-
![Click Import](images/create-button5.png " ")
65-
66-
4. Specify how the scheme should be created. In this case, select **Based on a pre-configured scheme from the gallery** and click **Next**.
67-
68-
![Click Import](images/create-authentication-scheme.png " ")
69-
70-
5. Specify a **Name** for Authentication Scheme. For Scheme Type, select **Oracle APEX Accounts**.
71-
72-
![Click Import](images/oracle-apex-accounts1.png " ")
73-
74-
6. Click **Create Authentication Scheme**.
75-
76-
77-
## Task 3: Add a Column to the Table using Object Browser
78-
79-
To collect the output generated by OCI AI Vision, you add a new column in the *SM\_POSTS* Table. This addition enables you to store and retrieve the relevant information seamlessly.
54+
To store the output generated by OCI AI Vision service, you add a new column in the SM\_POSTS Table. This addition enables you to store and retrieve the relevant information seamlessly.
8055

8156
To Add a new column to the SM\_POSTS Table:
8257

83-
1. Click **SQL Workshop** and navigate to **Object Browser**. In the object tree, expand Tables and select **SM\_POSTS** table.
58+
1. Click **SQL Workshop** and navigate to **Object Browser**.
8459

8560
![Click Import](images/sql-work.png " ")
8661

87-
![Click Import](images/add-column.png " ")
62+
2. In the object tree, expand Tables and select **SM\_POSTS** table. On the columns tab, click **Add Column**.
8863

89-
2. On the columns tab, click **Add Column**.
64+
![Click Import](images/add-column.png " ")
9065

9166

9267
3. The Add Column wizard is displayed. Configure the Add Column attributes. At a minimum, enter a column name and select a type. Depending upon the column type, specify whether the column requires precision, scale, a default value, or is nullable. For more details on an attribute, see field-level Help.
9368

94-
Enter the following and click **Apply**.
69+
Enter the following:
9570
- **Column**: AI_OUTPUT
9671
- **Data Type**: VARCHAR2
9772
- **Length**: 1000
9873

74+
Click **Apply**.
75+
9976
![Click Import](images/ai-output-column.png " ")
10077

10178
## Summary
10279

103-
You now know how to import the Oracle APEX application, change the authentication type, and add a new column.
80+
You now know how to import an Oracle APEX application, add a new column to a table.
10481

10582
You may now **proceed to the next lab**.
10683

25.6 KB
Loading

ai-vision-lab/3-integrate-oci-vision/3-integrate-oci-vision.md

+20-60
Original file line numberDiff line numberDiff line change
@@ -36,13 +36,13 @@ In this task, you create a REST Data Source with OCI vision REST API as the endp
3636
![Click Timeline](images/rest-method.png " ")
3737

3838
5. Under Create REST Data Source, enter the following attributes and click **Next**.
39-
- **Rest Data Source Type**: Select **Oracle Cloud Infrastructure (OCI)**
39+
- **Rest Data Source Type**: Oracle Cloud Infrastructure (OCI)
4040

41-
- **Name**: Enter **OCI Vision**
41+
- **Name**: OCI Vision
4242

4343
- **URL Endpoint**: https://vision.aiservice.us-ashburn-1.oci.oraclecloud.com/20220125/actions/analyzeImage
4444

45-
*Note: URL Endpoint may differ based on your OCI tenancy. Refer to the following link for more details*- https://docs.oracle.com/en-us/iaas/api/#/en/vision/20220125
45+
**Note**: URL Endpoint may differ based on your OCI tenancy. Refer to the following link for more details- https://docs.oracle.com/en-us/iaas/api/#/en/vision/20220125
4646

4747
![Click Timeline](images/create-rest-data.png " ")
4848

@@ -52,9 +52,9 @@ In this task, you create a REST Data Source with OCI vision REST API as the endp
5252

5353
7. Under Authentication,
5454

55-
- For Authentication: Enable **Authentication Required**
55+
- **Authentication Required**: Toggle the button to **ON**
5656

57-
- For Credentials: Select **apex\_ai\_cred**
57+
- **Credentials**: apex\_ai\_cred
5858

5959

6060
8. Click **REST Source Manually**.
@@ -93,67 +93,27 @@ In this task, you create a REST Data Source with OCI vision REST API as the endp
9393
9494
![Click Timeline](images/post.png " ")
9595
96-
11. Select Operation Parameters Tab and click **Add Parameter**
96+
11. Under Operation Parameters, click **Add Parameter**.
9797
9898
![Click Timeline](images/add-parameter.png " ")
9999
100-
12. Under Edit REST Data Source Parameter:
100+
12. In the **Edit REST Data Source Parameter** wizard, add the following 5 parameters one after the other:
101101
102-
- **Type**: Request or Response Body
102+
| | Type | Name | Direction | Default Value | Static |
103+
|---|-------|------|----------| --------------| ------ |
104+
| 1 | Request or Response Body| COMPARTMENT_ID | In |
105+
| 2 | Request or Response Body| FILE_DATA | In |
106+
| 3 | Request or Response Body| FEATURE_TYPE | In |
107+
| 4 | Request or Response Body| RESPONSE | Out |
108+
| 5| HTTP Header| Content-Type | In | application/json | ON
109+
{: title="POST Operation Parameters"}
103110
104-
- **Name**: COMPARTMENT_ID
105-
106-
- **Direction**: In
107-
108-
Click **Add and Add Another**
109111
110112
![Click Timeline](images/add-comp.png " ")
111113
112-
13. Under Edit REST Data Source Parameter:
113-
114-
- **Type**: Request or Response Body
115-
116-
- **Name**: FILE_DATA
117-
118-
- **Direction**: In
119-
120-
Click **Add and Add Another**
121-
122-
14. Under Edit REST Data Source Parameter:
123-
124-
- **Type**: Request or Response Body
125-
126-
- **Name**: FEATURE_TYPE
127-
128-
- **Direction**: In
129-
130-
Click **Add and Add Another**
131-
132-
15. Under Edit REST Data Source Parameter:
133-
134-
- **Type**: Request or Response Body
135-
136-
- **Name**: RESPONSE
137-
138-
- **Direction**: Out
139-
140-
Click **Add and Add Another**
141114
142115
![Click Timeline](images/response.png " ")
143116
144-
16. Under Edit REST Data Source Parameter:
145-
146-
- **Type**: HTTP Header
147-
148-
- **Name**: Content-Type
149-
150-
- **Direction**: In
151-
152-
- **Default value**: application/json
153-
154-
- **Static**: ON
155-
156-
Click **Add Parameter**.
157117
158118
![Click Timeline](images/content-type.png " ")
159119
@@ -165,15 +125,15 @@ In this task, you create a REST Data Source with OCI vision REST API as the endp
165125
In this task, you create a page process to invoke the OCI Vision REST Data Source implemented in the previous task.
166126
167127
168-
1. Navigate to the application homepage by clicking on the Application ID.
128+
1. Navigate to the application homepage by clicking on the **Application ID**.
169129
170130
![Click Timeline](images/click-app-id11.png " ")
171131
172132
2. Click **1-Timeline** page.
173133
174134
![Click Timeline](images/select-timeline1.png " ")
175135
176-
3. Right-click **Timeline** region under Rendering Pane and click **Create Page Item**.
136+
3. Right-click **Timeline** region in the Rendering Pane and click **Create Page Item**.
177137
178138
![Click Timeline](images/create-page-item2.png " ")
179139
@@ -187,7 +147,7 @@ In this task, you create a page process to invoke the OCI Vision REST Data Sourc
187147
188148
![Click Timeline](images/response-page-item1.png " ")
189149
190-
5. Navigate to the Processing Tab (left pane) and right click on Processing Tab or Processes and click **Create Process**.
150+
5. Navigate to the **Processing** Tab (left pane), right-click **Processes** and select **Create Process**.
191151
192152
![Click Timeline](images/processing.png " ")
193153
@@ -205,7 +165,7 @@ In this task, you create a page process to invoke the OCI Vision REST Data Sourc
205165
206166
![Click Timeline](images/analyze-image1.png " ")
207167
208-
7. Right click on the **Analyze Image** Process you just created and select **Add Child Process**.
168+
7. Right click on the **Analyze Image** Process and select **Add Child Process**.
209169
210170
![Click Timeline](images/add-child-process11.png " ")
211171
@@ -319,7 +279,7 @@ In this task, you create a page process to invoke the OCI Vision REST Data Sourc
319279
15. Click **Save**.
320280
321281
## Task 3: Enhance Timeline Region to include AI Search
322-
In this task, you create a page item P1\_AI\_SEARCH using which the end user can enter the search terms and search through the images.
282+
In this task, you create a search bar where the end user can enter the search terms and search through the images.
323283
324284
1. Go to the Rendering tab, right-click **After Logo** and select **Create Page Item**.
325285

ai-vision-lab/4-run-app/4-run-app.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,13 @@ In this lab, you:
1919

2020
2. Click **Add Post** on the Navigation Bar.
2121

22-
3. Drag and Drop the image from your local system or use the Choose File button to upload image from your local system. Then, click **Post**.
22+
3. Drag and Drop the image from your local system or use the **Choose File** button to upload an image from your local system. Then, click **Post**.
2323

2424
![Click Timeline](images/add-post.png " ")
2525

26-
The image is posted on your timeline.
26+
The image is now posted on your timeline. Similarly, add as many posts as you would like.
2727

28-
4. Now, type your Search Term in the AI Search Field available in the Navigation Bar and then click **Enter**. The app searches and displays all the images that contain the corresponding search term.
28+
4. Now, type your Search Term in the AI Search Field available in the Navigation Bar and then click **Enter**. The app searches for and displays all the images that contain the corresponding search term.
2929
In the following example, when you enter 'Sky' in the AI Search Field, the app displays all the images that has sky in them.
3030

3131
![Click Timeline](images/search-result.png " ")
Loading

0 commit comments

Comments
 (0)