Updated: Created Green button for Implement Data Sharing with ADB Dat…

…a Studio workshop (#379)

* changes

* Update consume-share.md

* Anoosha's feedback

* Update consume-share.md

* updated 2 screens and a sentence

* minor changes

* deleted extra images and added doc references

* new ECPU changes

* more changes to data sharing workshops

* more changes to fork (data studio)

* more changes

* Marty's feedback

* Marty's feedback to plsql workshop too

* Update setup-workshop-environment.md

* Delete 7381.png

* workshop # 3 ADB set up

and a couple of minor typos in workshops 1 and 2

* changes to adb-dcat workshop

* more changes

* minor typos in all 4 workshops

* quarterly qa build data lake

* new lab 11 in build DL with ADW

* minor changes database actions drop-down list

* final changes to build data lake workshop

* AI updates

AI workshop updates

* ai workshop updates

* Update query-using-select-ai.md

* Update query-using-select-ai.md

* updates

* more updates

* Update query-using-select-ai.md

* more new updates to ai workshop

* Update query-using-select-ai.md

* a new screen capture

* push Marty's feedback to fork

Final changes.

* updates sandbox manifest

* updates

* restored sandbox manifest

* Update setup-environment.md

* updates after CloudWorld

* final updates to ai workshop (also new labs 4 and 5)

* marty's feedback

* incorporated feedback

* minor PR edits by Sarah

* removed steps 7 & 8 Lab 2 > Task 3 per Alexey

The customer asked to remove this as it's not a requirement for the bucket to be public.

* more changes

* more changes per Alexey

* Update load-os-data-public.md

* Quarterly QA

I added a new step per the PM's request in the Data Sharing PL/SQL workshop. I also made a minor edit (removed space) in the Data Lake workshop.

* more updates

* Quarterly QA changes

* Update consume-share.md

* minor edit based on workshop user

* quarterly qa November 2023

* Added new videos to the workshop

Replaced 3 old silent videos with new ones. Added two new videos.

* Adding important notes to the two data sharing workshops

Per the PM's request.

* folder structure only  push to production

This push and the PR later is to make sure the folder structure is in the production repo before I start development. Only 1 .md file and the workshops folder.

* typos

* cloud links workshop

* UPDATES

* Update query-view.png

* update

* minor updates to chat ai workshop (Fork)

* test clones

* test pr

* Alexey's feedback

* Update data-sharing-diagram.png

* sarah's edits

* changes to Data Load UI

* removed script causing ML issue

* Update load-local-data.md

* updates: deprecated procedure and new code

* updates and test

* more updates

* minor update

* testing using a building block in a workshop

* updates

* building blocks debugging

* Update manifest.json

* fixing issues

* Update manifest.json

* delete cleanup.md from workshop folder (use common file)

* use common cleanup.md instead of local cleanup.md

* test common tasks

* update data sharing data studio workshop

* Update create-recipient.png

* PM's 1 feedback

* quarterly qa

* missing "Lab 2" from Manifest

* always free note addition

added a note

* always free change

* Update setup-environment.md

* update manage and monitor workshop

* Folder structure for new data share workshop (plus introduction.md)

* Updated Load and Analyze from clone

* Data Lake minor changes from clone

* manage and monitor workshop

* Remove the lab from the workshop per Marty's request

* mark-hornick-feedback

* used marty's setup file

* replaced notebook with a new one

* updates to lab 6 of manage and monitor

* Update adb-auto-scaling.md

* Nilay's feedback

* Update adb-auto-scaling.md

* updates to second ai workshop

* note change

* Changes to Load and Analyze workshop (other minor changes too)

* quarterly qa

* Update diagrams per Alexey (remove delta share icon)

* updated the 15-minutes workshop

* Update analyzing-movie-sales-data.md

* ords updates and misc

* updated data studio workshop

* ORDS and Misc updates

* updated freetier version

* updated livelabs version

* updating the manage and monitor workshop

* more updates

* lab 11 updates

* updated lab 14

* updated freetier

* more updates

* Update adw-connection-wallet.md

* update

* Create purge-scn.png

* livelabs updates

* Update adb-flashback.md

* final updates

* updated screens Ramona's review

* Update click-add-peer-database-second-time.png

* update the adb-dcat workshop

1. New ord 24.1.0 launchpad.
2. New navigation path to create dynamic groups
3. Updated OML UI

* Update see-clone-information-in-details-page-2.png

* Requested changes to the Data Lake workshop

* more updates

* updates to Data Lake workshop

* kscope24 workshop for Alexey

* new lab & other updates

* Update load-os-data-private.md

* Update load-os-data-private.md

* more updates, new lab

* minor update example 2

* Update load-os-data-private.md

* Chat AI workshop changes

* new notebook

* more updates

* minor updates

* New Iceberg Lab

added to the freetier and livelabs workshops

* Update manifest.json

* Update query-iceberg-tables.md

* new livelabs folder to request green button

* folder structure for two more data sharing workshops - green button

* 3rd workshop

* NEW LIVE DATA SHARE WORKSHOP

* Anne's feedback

* update

* Update introduction.md

* changes to manifest files and setup lab

* updated AI Chat workshop

* feedback

* adding the missing lab 4 to the workshop

* Update introduction.md

* Update introduction.md

* notebook update

* Update query-using-select-ai.md

* updated notebook

* changes based on Ramona's qa

* update freetier version

* Green button version for 3881 workshop

* data share cloud links db actions green button version

* (4) data sharing workshops updates (freetier and one sandbox)

* green button for Set up live data sharing between Oracle Databases using Cloud Links and PL/SQL APIs

* Chat with your data in Autonomous Database using generative AI updates

* updated the notebook

* blurred two screens

* workaround for found bug

---------

Co-authored-by: Michelle Malcher <[email protected]>
Co-authored-by: Sarah Hirschfeld <[email protected]>

shared/adw-data-lake/use-data-sharing-data-studio/consume-share/consume-share.md

@@ -23,19 +23,24 @@ In this lab, you will:
 
 ## Task 1: Download the .json Configuration File
 
-As the **`training_recipient`**, you can use the activation link URL that was sent to you by by the **`share_provider`** via email to download the **`delta_share_profile.json`** configuration file. This file (delta profile) contains the required credentials that you need in order to connect to the data share and access the **`CUSTOMER_CONTACT_SHARE`** table in the share.
+As the **`training_recipient`**, you can use the activation link URL that was sent to you by the **`share_provider`** via email to download the **`delta_share_profile.json`** configuration file. This file (delta profile) contains the required credentials that you need in order to connect to the data share and access the **`CUSTOMER_CONTACT_SHARE`** table in the share. **Note:** In our example, you will use the second activation link that you got using the second method in the previous lab.
 
->**Note:** To download the `.json` file as the recipient, it doesn't matter what user you are logged in as. All you need is a web browser.
+>**Note:** _To download the `.json` file as the recipient, it doesn't matter what user you are logged in as. All you need is a web browser._
+
+<!-- text -->
+
+<!--
+Uncomment this when development find a fix for this bug.
 
 1. Open the email message that was sent to you which contains the activation link URL.
 
-    ![Open the email message.](images/open-email.png)
+    ![Open the email message.](images/open-email.png)-->
 
-2. Copy the activation link URL, and then paste it in your web browser's address bar. Alternatively, you can simply click the URL in the email message.
+1. Copy the activation link URL that you obtained using the second method, and then paste it in your web browser's address bar. <!--Alternatively, you can simply click the URL in the email message.-->
 
     ![Paste activation link in the browser.](images/paste-activation-url.png)
 
-3. Press **[Enter]**. The **Autonomous Database Data Sharing** page is displayed. To download the config file, click **Get Profile Information**.
+2. Press **[Enter]**. The **Autonomous Database Data Sharing** page is displayed. To download the config file, click **Get Profile Information**.
 
     ![Click Get Profile Information.](images/click-get-profile.png)
 
@@ -45,17 +50,17 @@ As the **`training_recipient`**, you can use the activation link URL that was se
 
     ![Profile file downloaded.](images/screen-2.png)
 
-4. The **`delta_share_profile`.json** file is downloaded to your browser's **Downloads** directory.
+3. The **`delta_share_profile`.json** file is downloaded to your browser's **Downloads** directory.
 
     ![The downloaded file is displayed.](images/downloaded-file.png)
 
-5. Open the downloaded file to display its content. You will need this file to connect and use the data share.
+4. Open the downloaded file to display its content. You will need this file to connect and use the data share.
 
     ![Open the delta share profile file.](images/open-profile.png)
 
 ## Task 2: Log in as the share_consumer User
 
-1. Log in as the **`share_consumer`** user. On the **Sign-in** page, enter **`share_consumer`** as the username and **`TrainingADW`** as the password, and then click **Sign in**.
+1. Log in as the **`share_consumer`** user. On the **Sign-in** page, enter **`share_consumer`** as the username and **`DataShare4ADW`** as the password, and then click **Sign in**.
 
 2. On the **Database Actions Launchpad** page, click the **Data Studio** tab, and then click the **Data Share** tab.
 
@@ -192,7 +197,7 @@ You may now proceed to the next lab.
 
 * **Author:** Lauran K. Serhal, Consulting User Assistance Developer
 * **Contributor:** Alexey Filanovskiy, Senior Principal Product Manager
-* **Last Updated By/Date:** Lauran K. Serhal, April 2024
+* **Last Updated By/Date:** Lauran K. Serhal, December 2024
 
 Data about movies in this workshop were sourced from Wikipedia.
 
@@ -202,4 +207,4 @@ Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3
 or any later version published by the Free Software Foundation;
 with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-A copy of the license is included in the section entitled [GNU Free Documentation License](files/gnu-free-documentation-license.txt)
+A copy of the license is included in the section entitled [GNU Free Documentation License](https://oracle-livelabs.github.io/adb/shared/adb-15-minutes/introduction/files/gnu-free-documentation-license.txt)

shared/adw-data-lake/use-data-sharing-data-studio/create-share/create-share.md

@@ -56,7 +56,7 @@ END;
 
 As the **`share_provider`** user, create a new data share named **`training_share`**.
 
-1. To create a new data share, click the **PROVIDE SHARE** tool on the Home page. Alternatively,in the Navigation pane on the left, drill-down on the **Data Share** node, and then click **Provide Share**.
+1. To create a new data share, click the **PROVIDE SHARE** tool on the Home page. Alternatively, in the Navigation pane on the left, drill-down on the **Data Share** node, and then click **Provide Share**.
 
     ![Access provide share.](./images/access-provide-share.png " ")
 
@@ -70,7 +70,7 @@ As the **`share_provider`** user, create a new data share named **`training_shar
 
     * **Name:** Enter **`training_share`**.
     * **Email:** Enter the email address for the provider such as **`[email protected]`**.
-    * **Description:** Enter a meaningful description of the provider (required).
+    * **Description:** Enter a meaningful description of the provider (_required_).
 
     ![The General tab.](./images/general-tab.png " ")
 
@@ -114,13 +114,15 @@ As the **`share_provider`** user, create a new data share named **`training_shar
 
     ![The recipient is created.](images/recipient-created.png =75%x*)
 
-13. Click the **Email recipient profile download link** icon to email the activation link to the recipient. 
+_Next, you will learn how to get the activation link that the recipient will need using two methods. In this lab, you'll use the activation link that is generated using the **second method**._
+
+13. **Method 1:** Click the **Email recipient profile download link** icon to email the activation link to the recipient. 
 
     >**Note:** You can also click the **Copy Profile activation link to clipboard** icon as a backup in case the user didn't get the email.
 
     ![Copy activation link to clipboard.](images/copy-activation-link-clipboard.png =70%x*)
 
-14. An email message that will be sent to the recipient is automatically generated and displayed. This email message contains the _personal authorization profile_ (activation link) URL that the recipient will use to download the **`delta_share_profile.json`** configuration file. This file is required to access the data share in the next lab. In our example, we are using Microsoft Outlook as the email client. Click **Send** to send the email to the recipient.
+14. An email message that will be sent to the recipient is automatically generated and displayed. This email message contains the _personal authorization profile_ (activation link) URL that the recipient will use to download the **`delta_share_profile.json`** configuration file. This file is required to access the data share in the next lab. In our example, we are using Microsoft Outlook as the email client. Next, you would cClick **Send** to send the email to the recipient. _**Don't click the Send button. You will use the activation link generated using the second method next.**_
 
     ![Click send email.](images/activation-email.png)
 
@@ -144,7 +146,11 @@ As the **`share_provider`** user, create a new data share named **`training_shar
 
     ![Versioned share type.](images/versioned-share-type.png)
 
-18. Log out of the **`SHARE_PROVIDER`** user. On the **Oracle Database Actions | Data Share** banner, click the drop-down list next to the `SHARE_PROVIDER` user, and then select **Sign Out** from the drop-down menu. If you are prompted to leave, click **Leave**.
+18. **Method 2:** In the **TRAINING_RECIPIENT** tile, click the **Actions** (ellipsis) icon and then select **Copy Profile Activation Link to Profile**. This is the activation link that the recipient will use. Save this activation link to a text editor of your choice as you will need it in the next lab.
+
+    ![Method 2 activation link.](images/method2-activation-link.png)
+
+19. Log out of the **`SHARE_PROVIDER`** user. On the **Oracle Database Actions | Data Share** banner, click the drop-down list next to the `SHARE_PROVIDER` user, and then select **Sign Out** from the drop-down menu. If you are prompted to leave, click **Leave**.
 
 You may now proceed to the next lab.
 
@@ -158,7 +164,7 @@ You may now proceed to the next lab.
 
 * **Author:** Lauran K. Serhal, Consulting User Assistance Developer
 * **Contributor:** Alexey Filanovskiy, Senior Principal Product Manager
-* **Last Updated By/Date:** Lauran K. Serhal, April 2024
+* **Last Updated By/Date:** Lauran K. Serhal, December 2024
 
 Data about movies in this workshop were sourced from Wikipedia.
 
@@ -168,4 +174,4 @@ Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3
 or any later version published by the Free Software Foundation;
 with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-A copy of the license is included in the section entitled [GNU Free Documentation License](files/gnu-free-documentation-license.txt)
+A copy of the license is included in the section entitled [GNU Free Documentation License](https://oracle-livelabs.github.io/adb/shared/adb-15-minutes/introduction/files/gnu-free-documentation-license.txt)

shared/adw-data-lake/use-data-sharing-data-studio/create-user-storage-credentials/create-user-storage-credentials.md

@@ -25,7 +25,11 @@ In this lab, you will:
 
 ## Task 1: Navigate to the SQL Worksheet
 
-After you provisioned an ADB instance in the **Set up the Workshop Environment** lab, the **Autonomous Database details** page was displayed. If the page is active, start with **step 4** below. If the page had timed out, start with **step 1** below.
+<if type="livelabs">
+Your green button reservation includes an ADB instance. You can find the required credentials in the **Reservation Information** dialog box for your reservation. To log in to the Console, click the **Launch OCI** button in the **Reservation Information** dialog box, and then follow the prompts to reset your assigned password. If you get a **_Forbidden_** error, make sure you select your assigned compartment from the **Compartment** drop-down list in the **List Scope** section. Your assigned compartment is listed in the **Reservation Information** dialog box.
+
+ ![The Reservation Information dialog box.](./images/ll-reservation-information.png " ")
+</if>
 
 1. Log in to the **Oracle Cloud Console**, if you are not already logged in.
 
@@ -34,8 +38,6 @@ After you provisioned an ADB instance in the **Set up the Workshop Environment**
 3. On the **Autonomous Databases** page, click your **ADW-Data-Lake** ADB instance.
     ![The Autonomous Database is displayed and highlighted.](./images/adb-page.png " ")
 
-    >**Note:** If you get a _Forbidden_ message on the **Autonomous Databases** page, that indicates that you are in the wrong compartment. Refer to the **Reservation Information** panel for your reservation and make a note of your assigned compartment. Next, on the same page, click the **Compartment** drop-down list in the **Scope** section, and selected your assigned compartment.
-
 4. On the **Autonomous Database details** page, click the **Database actions** drop-down list, and then click **SQL**.
 
     ![From the Database Actions drop-down list, click SQL.](./images/click-db-actions-sql.png " ")
@@ -187,7 +189,23 @@ You should store the data share data in Object Storage. You will then create a l
 
 6. The new bucket is displayed on the **Buckets** page.
 
+<if type="freetier">
+
     ![The new bucket is displayed on the Buckets page.](./images/bucket-created.png " ")
+</if>
+
+<if type="livelabs">
+
+    ![The new bucket is displayed on the Buckets page.](./images/ll-bucket-created.png " ")
+</if>
+
+7. Next, you need to get the name of the namespace (tenancy) where this new bucket was created. You will need this namespace name in this workshop. In the row for the bucket, click the **Actions** icon (ellipsis), and then select **View Object Details** from the context menu.
+
+    ![Get the bucket's namespace.](./images/ll-get-bucket-namespace.png " ")
+
+    The **Bucket Details** page is displayed. The **Namespace** field displays the name of the namespace. The name is blurred for security reasons. Copy this name to your choice of text editor such as Notepad in Windows as you will need it in later steps.
+
+    ![Copy the bucket's namespace.](./images/ll-copy-bucket-namespace.png " ")
 
 ## Task 5: (Optional) Generate an RSA Key Pair and Get the Key's Fingerprint
 [](include:adb-generate-rsa-key-pair.md)
@@ -220,8 +238,9 @@ You will set up a connection to Oracle Object Storage by defining a cloud locati
     + Accept the **Select Credential** option. To access data in the Object Store, you need to enable your database user to authenticate itself with the Object Store using your OCI object store account and a credential. You do this by creating a private CREDENTIAL object for your user that stores this information encrypted in your Autonomous Data Warehouse. This information is only usable for your user schema.
     + Click **Create Credential**.
     + In the **Create Credential** dialog box, specify the following:
-        + **Credential Type:** Select the **Oracle Cloud Infrastructure Signing Keys** option.
         + **Credential Name:** Enter **DELTA\_SHARE\_CREDENTIAL**. **Note:** The credential name must conform to Oracle object naming conventions, which do not allow spaces or hyphens.
+        + **Cloud Service:** Accept the **`Oracle`** default selection.
+        + **Credential Type:** Select the **Oracle Cloud Infrastructure Signing Keys** option.
         + **Fingerprint:** Enter the fingerprint for your RSA key pair that you generated and copied to a text file in the previous task.
         + **Private Key:** Paste your unencrypted private key value.
         Open the private key file in a text editor, and then copy the entire content from the and _including_ **-----BEGIN PRIVATE KEY-----** line to and _including_ the **-----END PRIVATE KEY-----** line.
@@ -236,11 +255,11 @@ You will set up a connection to Oracle Object Storage by defining a cloud locati
     
     The **Add Cloud Store Location** panel is re-displayed. The newly created credential is displayed. If you already have a bucket, select it from the **Select Bucket** drop-down list. This populates the **Bucket URI** text box; otherwise, select the **Bucket URI** option, and then enter your bucket's URI in the **Bucket URI** text box. You identified your bucket's URI in **Task 4**. Remember to use this general structure, swapping in your own values. _Remember, don't include the trailing slash after the **`/o`**; otherwise, you will get an error_.
     
-    >**Note:** Substitute the URI value in the following code with your own bucket's URI. In our example, we replaced the actual tenancy name in the URI value with the **`namespace  name`** place holder for security.
+    >**Note:** Substitute the URI value in the following code with your own bucket's URI . In our example, we replaced the actual tenancy name in the URI value with the **`namespace  name`** place holder for security. Make sure you use the tenancy name for your bucket that you saved in **Task 4 > Step 7** and not the one found in the **Reservation Information** dialog box.
 
-    `https://objectstorage.region name.oraclecloud.com/n/namespace name/b/data-share-bucket/o`
+    `https://objectstorage.region name.oraclecloud.com/n/bucket namespace name/b/data-share-bucket/o`
 
-    In our example, we selected our **data-share-bucket** from the **Select Bucket** drop-down list.
+    In our example, we selected our **data-share-bucket** from the **Select Bucket** drop-down list. The URI is displayed in the **Bucket URI** field.
 
     ![Complete the Add Cloud Store Location.](./images/complete-add-cloud-store-location.png " ")
 
@@ -264,7 +283,7 @@ You may now proceed to the next lab.
 
 * **Author:** Lauran K. Serhal, Consulting User Assistance Developer
 * **Contributor:** Alexey Filanovskiy, Senior Principal Product Manager
-* **Last Updated By/Date:** Lauran K. Serhal, June 2024
+* **Last Updated By/Date:** Lauran K. Serhal, December 2024
 
 Data about movies in this workshop were sourced from Wikipedia.
 
@@ -274,4 +293,4 @@ Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3
 or any later version published by the Free Software Foundation;
 with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-A copy of the license is included in the section entitled [GNU Free Documentation License](files/gnu-free-documentation-license.txt)
+A copy of the license is included in the section entitled [GNU Free Documentation License](https://oracle-livelabs.github.io/adb/shared/adb-15-minutes/introduction/files/gnu-free-documentation-license.txt)

shared/adw-data-lake/use-data-sharing-data-studio/introduction/introduction.md

@@ -93,7 +93,7 @@ You may now proceed to the next lab.
 
 * **Author:** Lauran K. Serhal, Consulting User Assistance Developer
 * **Contributor:** Alexey Filanovskiy, Senior Product Manager
-* **Last Updated By/Date:** Lauran K. Serhal, April 2024
+* **Last Updated By/Date:** Lauran K. Serhal, December 2024
 
 Data about movies in this workshop were sourced from Wikipedia.
 

shared/adw-data-lake/use-data-sharing-data-studio/load-os-data-public/load-os-data-public.md

@@ -65,11 +65,7 @@ In this task, you will load the **customer\_contact** data into your Autonomous
 
     ![The customer_contact target table is displayed.](images/customer_contact-target-table.png " ")
 
-7. Click the **Settings** icon (pencil) for the **customer\_contact** load task to view its settings.
-
-    ![Click the pencil icon to open settings viewer for customer_contact load task](images/click-customer-contact-settings.png =50%x*)
-
-    The **Load Data from Cloud Store Location customer_contact** settings panel is displayed.
+7. Click the **Settings** icon (pencil) for the **customer\_contact** load task to view its settings. The **Load Data from Cloud Store Location customer_contact** settings panel is displayed.
 
 8. The **Database Actions** load job will create a **`CUSTOMER_CONTACT`** table with the listed columns and data types that are based on the selected **`.csv`** file. Review the information and the loading options. In the **Mapping** section, notice that you can change the target column names, data types, and length/precision. Click **Close** to close the settings viewer panel.
 
@@ -117,7 +113,7 @@ You may now proceed to the next lab.
 
 * **Author:** Lauran Serhal, Consulting User Assistance Developer
 * **Contributors:** Alexey Filanovskiy, Senior Principal Product Manager
-* **Last Updated By/Date:** Lauran Serhal, April 2024
+* **Last Updated By/Date:** Lauran Serhal, December 2024
 
 Data about movies in this workshop were sourced from Wikipedia.
 
@@ -127,4 +123,4 @@ Permission is granted to copy, distribute and/or modify this document
 under the terms of the GNU Free Documentation License, Version 1.3
 or any later version published by the Free Software Foundation;
 with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
-A copy of the license is included in the section entitled [GNU Free Documentation License](files/gnu-free-documentation-license.txt)
+A copy of the license is included in the section entitled [GNU Free Documentation License](https://oracle-livelabs.github.io/adb/shared/adb-15-minutes/introduction/files/gnu-free-documentation-license.txt)