Merge branch 'main' into main

wprichard · Aug 3, 2023 · df240a2 · df240a2
2 parents d94d9ba + bc3149d
commit df240a2
Show file tree

Hide file tree

Showing 1,360 changed files with 15,281 additions and 1,438 deletions.
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
@@ -15,4 +15,4 @@ Please confirm that the following is completed before submitting your PR
 - [ ] Filenames are descriptive
 - [ ] Your workshop folder structure should be similar to the one used in the sample workshop (https://github.com/oracle-livelabs/common/tree/main/sample-livelabs-templates/sample-workshop)
 - [ ] Are you using multiple versions (desktop/, sandbox/, tenancy/)? Make sure that each of them contains a manifest.json and an index.html
-- [ ] Image references in markdown contain an alternate text
+- [ ] Image references in markdown contain an alternate text 
diff --git a/common-labs/create-dataset/create-dataset.md b/common-labs/create-dataset/create-dataset.md
@@ -22,27 +22,27 @@ This lab assumes you have:
 ## Task 1: Create a Dataset
 In this section, you will upload the Sample Order Lines DS into Oracle Analytics and create a dataset.
 
-1. Once you have downloaded the Sample Order Lines DS dataset, we need to create a dataset in Oracle Analytics. From the homepage, click "Create" and select "Dataset."
+1. Once you have downloaded the Sample Order Lines DS dataset, we need to create a dataset in Oracle Analytics. From the homepage, click **Create** and select **Dataset.**
 
   ![Create dataset](images/create-dataset.png =200x*)
 
-2. Click "Drop data file here or click to browse" and choose the "Sample Order Lines DS" dataset.
+2. Click **Drop data file here or click to browse** and choose the **Sample Order Lines DS** dataset.
 
   ![Drop data file](images/drop-data.png =600x*)
 
-3. Click "OK".
+3. Click **OK**.
 
   ![Click OK](images/click-ok.png)
 
-4. Once the dataset is loaded, click save the dataset by clicking the "Save" button.
+4. Once the dataset is loaded, click save the dataset by clicking the **Save** button.
 
   ![Save dataset](images/save-dataset.png)
 
-5. Enter "Sample Order Lines DS" for "Name" and click "OK".
+5. Enter **Sample Order Lines DS** for **Name** and click **OK**.
 
   ![Enter dataset name](images/enter-name.png =400x*)
 
-6. There are two ways to create a Workbook. Click the "Go Back" button to create a Workbook from the homepage, or click "Create Workbook" on the top right after saving your dataset.
+6. There are two ways to create a Workbook. Click the **Go Back** button to create a Workbook from the homepage, or click **Create Workbook** on the top right after saving your dataset.
 
   ![Create Workbook](images/create-workbook.png)
 
@@ -55,4 +55,4 @@ You may now **proceed to the next lab**.
 
 ## Acknowledgements
 * Author - Nagwang Gyamtso, Product Manager, Analytics Product Strategy
-* Last Updated By/Date - Nagwang Gyamtso, February 2023
+* Last Updated By/Date - Nagwang Gyamtso, July 2023
diff --git a/creating-better-dv/geographical-relationships/geographical-relationships.md b/creating-better-dv/geographical-relationships/geographical-relationships.md
@@ -0,0 +1,90 @@
+# Geographical Relationships
+
+## Introduction
+
+In this lab, you will learn how to visualize geographical relationships using a map and manage color assignments to easily distinguish profits by cities.
+
+Estimated Lab Time: 10 minutes
+
+### Objectives
+
+In this lab, you will:
+* Create a map visualization
+* Manage map properties
+
+### Prerequisites
+
+This lab assumes you have:
+* Access to Oracle Analytics Cloud
+* Access to DV Content Author
+* All previous labs successfully completed
+
+
+## Task 1: Visualize Geographical Relationships
+
+1. Ctrl (Command on Mac) + select **City**, **Profit**, and **Quantity Ordered**. Right-click and select **Pick Visualization...**
+
+	![Pick visualization](images/pick-viz.png)
+
+2. Pick the **Map** visualization.
+
+	![Pick Map](images/pick-map.png =400x*)
+
+3. This is our simple map visualization which shows the Profit bubble by color and Quantity Ordered by the size of the bubble. We can improve this visualization further by using colors to help us identify cities that are in positive profit vs negative profit.
+
+	![Map result](images/default-map.png)
+
+4. Right-click the map visualization and click **Color**. Then click **Manage Assignments...**
+
+	![Manage color assignments](images/manage-assignments.png)
+
+5. Click the drop-down option for **Profit** to change the color gradient.
+
+	![Change color](images/change-profit-color.png =400x*)
+
+6. Select the **Diverging Red-White-Green** gradient.
+
+	![Select gradiaent](images/select-rwg.png =400x*)
+
+7. Click the Red color box to change the color for negative **Profit**.
+
+	![Change color for profit](images/profit-color.png =400x*)
+
+8. Select the rustic-orange preset and click **OK**. This will represent our negative profit values.
+
+	![Select orange](images/select-orange.png =400x*)
+
+9. Click the green color box for positive profit.
+
+	![Positive profit](images/positive-profit.png =400x*)
+
+10. Select the sea-blue color from the preset. This will represent our positive profits. Click **OK**.
+
+	![Select blue](images/select-blue.png =400x*)
+
+11. Click **Done** to apply the new color assignments.
+
+	![Apply new color assignment](images/apply-assignment.png =400x*)
+
+12. As you can see, it's now much easier to identify cities that are either profiting or losing money. This can help us easily decide where we need to re-allocate our resources. Maps are a great way to show geographical relationships in our data.
+
+	![Map result](images/map-result.png =400x*)
+
+13. Change the **Title** of the visualization to **Geographical Relationships** and make the font **Bolded**.
+
+	![Viz properties](images/viz-properties.png =400x*)
+
+14. Rename the canvas to **Geographical Relationships** and click **Save** to save the workbook.
+
+	![Save workbook](images/save-workbook.png)
+
+15. Name the workbook **Choosing the best visualizations** and click **Save**.
+
+	![Save as](images/save-as.png =500x*)
+
+You have completed the Creating Better Data Visualizations with Oracle Analytics hands-on lab!
+
+
+## Acknowledgements
+* Author - Nagwang Gyamtso, Product Manager, Analytics Product Strategy
+* Last Updated By/Date - Nagwang Gyamtso, July, 2023
diff --git a/creating-better-dv/geographical-relationships/images/apply-assignment.png b/creating-better-dv/geographical-relationships/images/apply-assignment.png
diff --git a/creating-better-dv/geographical-relationships/images/change-profit-color.png b/creating-better-dv/geographical-relationships/images/change-profit-color.png
diff --git a/creating-better-dv/geographical-relationships/images/default-map.png b/creating-better-dv/geographical-relationships/images/default-map.png
diff --git a/creating-better-dv/geographical-relationships/images/manage-assignments.png b/creating-better-dv/geographical-relationships/images/manage-assignments.png
diff --git a/creating-better-dv/geographical-relationships/images/map-result.png b/creating-better-dv/geographical-relationships/images/map-result.png
diff --git a/creating-better-dv/geographical-relationships/images/pick-map.png b/creating-better-dv/geographical-relationships/images/pick-map.png
diff --git a/creating-better-dv/geographical-relationships/images/pick-viz.png b/creating-better-dv/geographical-relationships/images/pick-viz.png
diff --git a/creating-better-dv/geographical-relationships/images/positive-profit.png b/creating-better-dv/geographical-relationships/images/positive-profit.png
diff --git a/creating-better-dv/geographical-relationships/images/profit-color.png b/creating-better-dv/geographical-relationships/images/profit-color.png
diff --git a/creating-better-dv/geographical-relationships/images/save-as.png b/creating-better-dv/geographical-relationships/images/save-as.png
diff --git a/creating-better-dv/geographical-relationships/images/save-workbook.png b/creating-better-dv/geographical-relationships/images/save-workbook.png
diff --git a/creating-better-dv/geographical-relationships/images/select-blue.png b/creating-better-dv/geographical-relationships/images/select-blue.png
diff --git a/creating-better-dv/geographical-relationships/images/select-orange.png b/creating-better-dv/geographical-relationships/images/select-orange.png
diff --git a/creating-better-dv/geographical-relationships/images/select-rwg.png b/creating-better-dv/geographical-relationships/images/select-rwg.png
diff --git a/creating-better-dv/geographical-relationships/images/viz-properties.png b/creating-better-dv/geographical-relationships/images/viz-properties.png
diff --git a/creating-better-dv/introduction/introduction.md b/creating-better-dv/introduction/introduction.md
@@ -0,0 +1,23 @@
+# Introduction
+
+## About this Workshop
+
+This workshop is the hands-on portion of the "Creating Better Data Visualizations with Oracle Analytics" session hosted by the Oracle Analytics Technical Enablement team. To convey the right message in data visualizations, we must know how to pick the correct visualization type, otherwise, the chart types we select may contradict with our message.
+
+In this workshop, we explore different ways to visualize time comparison and geographical relationships in Oracle Analytics Cloud.
+
+Estimated Workshop Time: 25 minutes
+
+### Objectives
+
+In this workshop, you will learn how to:
+* Create various data visualization types
+* Format visualizations
+
+## Learn More
+* [Visualize Data](https://docs.oracle.com/en/cloud/paas/analytics-cloud/visualize-data.html)
+* [Chart chooser](https://extremepresentation.typepad.com/files/chart-chooser-2020.pdf)
+
+## Acknowledgements
+* **Author** - Nagwang Gyamtso, Product Manager, Analytics Product Strategy
+* **Last Updated By/Date** - Nagwang Gyamtso, July, 2023
diff --git a/creating-better-dv/other-livelabs/other-livelabs.md b/creating-better-dv/other-livelabs/other-livelabs.md
@@ -0,0 +1,10 @@
+# Other LiveLabs you might like
+
+
+- [Leveraging Oracle Analytics Cloud with Autonomous Data Warehouse](https://apexapps.oracle.com/pls/apex/f?p=133:180:9186177853010::::wid:812)
+
+- [Red Bull Racing Honda Win: Develop an Interactive Map of a Racetrack](https://apexapps.oracle.com/pls/apex/r/dbpm/livelabs/view-workshop?wid=896&clear=RR,180&session=9186177853010)
+
+- [Get Started With Oracle Analytics](https://apexapps.oracle.com/pls/apex/f?p=133:180:7676331286034::::wid:3575)
+
+- [Import, Analyze, and Share Your Data With Oracle Analytics](https://apexapps.oracle.com/pls/apex/f?p=133:180:7676331286034::::wid:3592)
diff --git a/creating-better-dv/time-comparison/images/add-canvas.png b/creating-better-dv/time-comparison/images/add-canvas.png
diff --git a/creating-better-dv/time-comparison/images/add-to-workbook.png b/creating-better-dv/time-comparison/images/add-to-workbook.png
diff --git a/creating-better-dv/time-comparison/images/bold-title.png b/creating-better-dv/time-comparison/images/bold-title.png
diff --git a/creating-better-dv/time-comparison/images/change-title.png b/creating-better-dv/time-comparison/images/change-title.png
diff --git a/creating-better-dv/time-comparison/images/close-auto-insights.png b/creating-better-dv/time-comparison/images/close-auto-insights.png
diff --git a/creating-better-dv/time-comparison/images/color-box.png b/creating-better-dv/time-comparison/images/color-box.png
diff --git a/creating-better-dv/time-comparison/images/create-workbook.png b/creating-better-dv/time-comparison/images/create-workbook.png
diff --git a/creating-better-dv/time-comparison/images/custom-title.png b/creating-better-dv/time-comparison/images/custom-title.png
diff --git a/creating-better-dv/time-comparison/images/done.png b/creating-better-dv/time-comparison/images/done.png
diff --git a/creating-better-dv/time-comparison/images/drag-drop.png b/creating-better-dv/time-comparison/images/drag-drop.png
diff --git a/creating-better-dv/time-comparison/images/duplicate-viz.png b/creating-better-dv/time-comparison/images/duplicate-viz.png
diff --git a/creating-better-dv/time-comparison/images/manage-assignments.png b/creating-better-dv/time-comparison/images/manage-assignments.png
diff --git a/creating-better-dv/time-comparison/images/order-priority-color.png b/creating-better-dv/time-comparison/images/order-priority-color.png
diff --git a/creating-better-dv/time-comparison/images/position-chart.png b/creating-better-dv/time-comparison/images/position-chart.png
diff --git a/creating-better-dv/time-comparison/images/rename-canvas.png b/creating-better-dv/time-comparison/images/rename-canvas.png
diff --git a/creating-better-dv/time-comparison/images/replace-profit.png b/creating-better-dv/time-comparison/images/replace-profit.png
diff --git a/creating-better-dv/time-comparison/images/select-green.png b/creating-better-dv/time-comparison/images/select-green.png
diff --git a/creating-better-dv/time-comparison/images/select-high.png b/creating-better-dv/time-comparison/images/select-high.png
diff --git a/creating-better-dv/time-comparison/images/select-orange.png b/creating-better-dv/time-comparison/images/select-orange.png
diff --git a/creating-better-dv/time-comparison/images/stacked-area.png b/creating-better-dv/time-comparison/images/stacked-area.png
diff --git a/creating-better-dv/time-comparison/images/stacked-result.png b/creating-better-dv/time-comparison/images/stacked-result.png
diff --git a/creating-better-dv/time-comparison/images/viz-menu.png b/creating-better-dv/time-comparison/images/viz-menu.png
diff --git a/creating-better-dv/time-comparison/time-comparison.md b/creating-better-dv/time-comparison/time-comparison.md
@@ -0,0 +1,125 @@
+# Time comparison
+
+## Introduction
+
+In this lab, you will learn how to create visualizations that deal with time; specifically, comparison over time, and composition over time.
+
+Estimated Time: 10 minutes
+
+### Objectives
+
+In this lab, you will:
+* create a comparison over time chart (a line chart)
+* create a composition over time chart (a stacked area chart)
+
+### Prerequisites
+
+This lab assumes you have:
+* Access to Oracle Analytics Cloud
+* Access to DV Content Author application role
+* Download [Sample Order Lines DS](https://objectstorage.us-phoenix-1.oraclecloud.com/p/TBMVACa7qZgj8ijJ3j5wlILzaVVtw1jo6n4rO8mREaAKjRoWAPX0OVTaEL39buPQ/n/idbwmyplhk4t/b/LiveLabsFiles/o/Sample%20Order%20Lines%20DS.xlsx) dataset
+
+
+## Task 1: Create a Comparison Over Time Chart
+
+1. Login to your OAC instance with the credentials provided. From the homepage, click **Create**. Then click **Workbook**.
+
+	![Create Workbook](images/create-workbook.png)
+
+2. Search for the **Sample Order Lines DS** dataset and click **Add to Workbook**. Make sure you pick the right dataset.
+
+	![Add to workbook](images/add-to-workbook.png)
+
+3. Since we won't be using auto-insights, close the auto-insights panel.
+
+	![Close auto-insights](images/close-auto-insights.png)
+
+4. Ctrl (Command for Mac) + select **Profit** and **Month** from **Order Date_R**. Drag and drop these two columns into the canvas to let Oracle Analytics auto-create a Line chart.
+
+	![Drag and drop](images/drag-drop.png)
+
+5. To format the title for this Line chart, navigate to the properties panel, and for **Title**, click on **Auto**. Then select **Custom**.
+
+	![Custom title](images/custom-title.png)
+
+6. Type **Monthly Data Across Three Years**. To format the title font, click the **Title Font** option. This is where you can customize the Font properties. Click the **Bold** icon.
+
+	![Bold title](images/bold-title.png)
+
+7. This was a simple comparison over time visualization. Now, let's create a composition over time visualization.
+
+## Task 2: Create a Composition Over Time Chart
+
+1. Click the **Menu** icon of our existing chart.
+
+	![Visualization menu](images/viz-menu.png)
+
+2. Click **Edit**, and then click **Duplicate Visualization**.
+
+	![Duplicate visualization](images/duplicate-viz.png)
+
+3. Drag the duplicate visualization and place it above the existing chart.
+
+	![Position chart](images/position-chart.png)
+
+4. From the data panel, drag **Quantity Ordered** and drop it on top of **Profit** to replace Profit.
+
+	![Replace data element](images/replace-profit.png)
+
+5. Drag **Order Priority** into the **Color** section.
+
+	![Drag Order Priority](images/order-priority-color.png)
+
+6. Click the visualization type to change the visualization and select the **Stacked Area** chart.
+
+	![Stacked area chart](images/stacked-area.png =500x*)
+
+7. Here, we have our **Stacked Area** chart, which shows the composition of **Quantity Ordered** based on the **Order Priority** over time.
+
+	![Stacked area](images/stacked-result.png)
+
+8. Let's change the color assignments so that our eyes are drawn to the higher-priority orders. Right-click the visualization and select **Color**. Then click **Manage Assignments...**
+
+	![Manage assignments](images/manage-assignments.png)
+
+9. This is where you can manage the color assignment for your attributes. Click the color box for **1 - Critical**.
+
+	![Click color box](images/color-box.png =400x*)
+
+10. Select the rusty-orange preset and click **OK**.
+
+	![Select new color](images/select-orange.png =400x*)
+
+11. Let's change the color assignment for the high priority orders. Click the color box for **2 - High**.
+
+	![Select new color](images/select-high.png =400x*)
+
+12. Select the light-green preset and click **OK**.
+
+	![Select light-green](images/select-green.png =400x*)
+
+13. We are fine with the other two color assignments for now. After you set the right color assignments, click **Done** to apply the colors.
+
+	![Done](images/done.png =400x*)
+
+14. Let's go ahead and change the **Title** of the **Stacked Area** chart to **2021 Trending Dimensions - Understanding Absolute Changes**.
+
+	![Change title](images/change-title.png)
+
+15. Click the drop-down option on the Canvas and select **Rename**.
+
+	![Rename canvas](images/rename-canvas.png)
+
+16. Name it **Time**, then click **Add Canvas**. We will create a geographical relationship visualization in this new canvas.
+
+	![Add canvas](images/add-canvas.png =400x*)
+
+
+You may now **proceed to the next lab**.
+
+## Learn More
+* [Process Data Using a Sequence of Data Flows](https://docs.oracle.com/en/cloud/paas/analytics-cloud/acubi/process-data-using-sequence-data-flows.html#GUID-CA3C5C48-069B-4D4B-A989-5932A1B421EB)
+
+## Acknowledgements
+* **Author** - Nagwang Gyamtso, Product Manager, Analytics Product Strategy
+* **Last Updated By/Date** - Nagwang Gyamtso, July, 2023
diff --git a/creating-better-dv/workshops/desktop/manifest.json b/creating-better-dv/workshops/desktop/manifest.json
@@ -0,0 +1,39 @@
+{
+    "workshoptitle": "Create Better Data Visualizations with Oracle Analytics",
+    "include": {"starter-file.sql":"../../data-load/files/starter-file.sql",
+                "sample.json":"../../data-load/files/sample.json",
+                "step2.md":"../../data-load/files/step2.md"},
+    "variables": ["../../variables/variables.json",
+                 "../../variables/variables-in-another-file.json"],
+    "help": "livelabs-help-analytics_us@oracle.com",
+    "tutorials": [
+        {
+            "title": "Introduction",
+            "description": "The Introduction is always first. The title and contents menu title match for the Introduction.",
+            "filename": "../../introduction/introduction.md"
+        },
+        {
+            "title": "Get Started",
+            "description": "This is the prerequisites for customers using Free Trial and Paid tenancies, and Always Free accounts (if applicable). The title of the lab and the Contents Menu title (the title above) match for Prerequisite lab. This lab is always first.",
+            "filename": "https://oracle-livelabs.github.io/common/labs/cloud-login/register-free-tier-account.md"
+        },
+        {
+            "title": "Lab 1: Time Comparison",
+            "filename": "../../time-comparison/time-comparison.md"
+        },
+        {
+            "title": "Lab 2: Geographical Relationships",
+            "filename": "../../geographical-relationships/geographical-relationships.md"
+        },
+        {
+            "title": "Need Help?",
+            "description": "Solutions to Common Problems and Directions for Receiving Live Help",
+            "filename":"https://oracle-livelabs.github.io/common/labs/need-help/need-help-freetier.md"
+        },
+        {
+            "title": "Other LiveLabs you might like",
+            "description": "Other LiveLabs you might like",
+            "filename": "../../other-livelabs/other-livelabs.md"
+        }
+    ]
+}
diff --git a/...heatwave-intro/workshops/event/index.html → ...ng-better-dv/workshops/tenancy/index.html b/...heatwave-intro/workshops/event/index.html → ...ng-better-dv/workshops/tenancy/index.html
diff --git a/creating-better-dv/workshops/tenancy/manifest.json b/creating-better-dv/workshops/tenancy/manifest.json
@@ -0,0 +1,43 @@
+{
+    "workshoptitle": "Create Better Data Visualizations with Oracle Analytics",
+    "include": {"starter-file.sql":"../../data-load/files/starter-file.sql",
+                "sample.json":"../../data-load/files/sample.json",
+                "step2.md":"../../data-load/files/step2.md"},
+    "variables": ["../../variables/variables.json",
+                 "../../variables/variables-in-another-file.json"],
+    "help": "livelabs-help-analytics_us@oracle.com",
+    "tutorials": [
+        {
+            "title": "Introduction",
+            "description": "The Introduction is always first. The title and contents menu title match for the Introduction.",
+            "filename": "../../introduction/introduction.md"
+        },
+        {
+            "title": "Get Started",
+            "description": "This is the prerequisites for customers using Free Trial and Paid tenancies, and Always Free accounts (if applicable). The title of the lab and the Contents Menu title (the title above) match for Prerequisite lab. This lab is always first.",
+            "filename": "https://oracle-livelabs.github.io/common/labs/cloud-login/register-free-tier-account.md"
+        },
+        {
+            "title": "Lab 1: Create a Dataset",
+            "filename": "https://oracle-livelabs.github.io/analytics-ai/common-labs/create-dataset/create-dataset.md"
+        },
+        {
+            "title": "Lab 2: Time Comparison",
+            "filename": "../../time-comparison/time-comparison.md"
+        },
+        {
+            "title": "Lab 3: Geographical Relationships",
+            "filename": "../../geographical-relationships/geographical-relationships.md"
+        },
+        {
+            "title": "Need Help?",
+            "description": "Solutions to Common Problems and Directions for Receiving Live Help",
+            "filename":"https://oracle-livelabs.github.io/common/labs/need-help/need-help-freetier.md"
+        },
+        {
+            "title": "Other LiveLabs you might like",
+            "description": "Other LiveLabs you might like",
+            "filename": "../../other-livelabs/other-livelabs.md"
+        }
+    ]
+}