Skip to content

Commit

Permalink
936 QA review (#152)
Browse files Browse the repository at this point in the history
* LiveLabs #3683 QA updates

* Updated QA files

* fixed missing copy tag

* fixed image redaction

* screenshot reupload

* wid: 936 QA

* Update access-apex.md

* fixing file names

* fixing file names

* removed PII
  • Loading branch information
denisemyrick authored Nov 7, 2024
1 parent f5daa25 commit b1ea29a
Show file tree
Hide file tree
Showing 42 changed files with 96 additions and 106 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -17,37 +17,36 @@ In this lab, you will:
Watch the video below for a quick walk-through of the lab.
[Create an App from a Spreadsheet](videohub:1_rcmsmco3)

## Task 1: Access the Autonomous Database
## Task 1: Access the Autonomous Database

1. Click the **Navigation Menu** in the upper left, navigate to **Oracle Database**, and select **Autonomous Database**.

![Navigating to Autonomous Database.](images/navigation-menu.png " ")
![Navigating to Autonomous Database.](images/navigation-menu-v2.png " ")

2. Select the compartment provided on **View Login Info**, and click on the **Display Name** for the **Autonomous Database**.
2. Select the compartment provided on **View Login Info**, and click on the **Display Name** for the **Autonomous Database**.

![Selecting Autonomous Database in the Navigation Menu.](images/select-autonomous-database.png " ")
![Selecting Autonomous Database in the Navigation Menu.](images/select-autonomous-database.png " ")

## Task 2: Create a APEX workspace

1. Within your new database, APEX is not yet configured. Therefore, when you first access APEX, you will need to log in as an APEX Instance Administrator to create a workspace.

Click the **Apex Instance URL** provided on the ATP overview screen.
Click the **APEX instance URL** provided on the ATP overview screen.

![Open APEX instance](images/apex-instance.png " ")
![Open APEX instance](images/apex-instance-v2.png " ")

2. Now, click **Launch APEX**

![Launch APEX instance](images/launch-apex-inst.png " ")
![Launch APEX instance](images/launch-apex-inst-v2.png " ")


3. Enter the password for the Administration Services and click **Sign In to Administration**.
The password is the same as the one for the ADMIN user. You can find this password in the **View Login Info** tab.
3. Enter the password for the Administration Services and click **Sign In to Administration**.
The password is the same as the one for the ADMIN user. You can find this password in the **View Login Info** tab.

![Administration Services login page](images/log-in-as-admin.png " ")

4. Click **Create Workspace**.

![Create Workspace page](images/welcome-create-workspace.png " ")
![Create workspace page](images/welcome-create-workspace.png " ")

5. Depending on how you would like to create your workspace, select **New Schema** or **Existing Schema**. If you are getting started, select **New Schema**.

Expand All @@ -61,27 +60,25 @@ Watch the video below for a quick walk-through of the lab.
| Workspace Username | DEMO |
| Workspace Password | **`SecretPassw0rd`** |


Click **Create Workspace**.

![Create Workspace dialog](images/create-workspace.png " ")

7. In the APEX Instance Administration page, click the **DEMO** link in the success message.
7. In the APEX Instance Administration page, click the **DEMO** link in the success message.
>**Note:** This will log you out of APEX Administration so that you can log into your new workspace.
![APEX Instance Administration page](images/log-out-from-admin.png " ")
![APEX Instance Administration page](images/log-out-from-admin.png " ")

8. On the APEX Workspace log in page, enter **``SecretPassw0rd``** for the password, check the **Remember workspace and username** checkbox, and then click **Sign In**.

![APEX Workspace log in page](images/log-in-to-workspace.png " ")


## Summary

At this point, you know how to create an APEX Workspace and you are ready to start building amazing apps, fast.

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

## Acknowledgements
- **Author** - Apoorva Srinivas, Senior Product Manager, Ramu Murakami Gutierrez, Product Manager
- **Last Updated By/Date** - Ramu Murakami Gutierrez, Product Manager, July 2024
- **Author** - Apoorva Srinivas, Senior Product Manager, Ramu Murakami Gutierrez, Product Manager
- **Last Updated By/Date** - Denise Myrick, Product Manager, November 2024
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed spatial-apex/access-apex/images/apex-instance.png
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed spatial-apex/access-apex/images/navigation-menu.png
Binary file not shown.
File renamed without changes
34 changes: 17 additions & 17 deletions spatial-apex/add-spatial-analysis/add-spatial-analysis.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,31 +13,31 @@ Estimated Lab Time: 30 minutes

### Prerequisites

* Lab 3: Create a map from scratch
* Lab 3: Create Map from Scratch

## Task 1: Add a Region for Filters

1. Click on the **Page 3: Airports and States Map** at the top of the tree on the left. Then in the Page properties panel on the right, under Appearance change the Page Template to **Left Side Column**.

![Update Page template](images/add-spatial-analysis-01a.png)
![Update Page template](images/add-spatial-analysis-01a-v2.png)

You should then see **LEFT COLUMN** in the layout.

![Update Page template](images/add-spatial-analysis-01b.png)
![Update Page template](images/add-spatial-analysis-01b-v2.png)

2. Drag a Static Content region to left column.

![Add Static Content Region](images/add-spatial-analysis-01c.png)
![Add Static Content Region](images/add-spatial-analysis-01c-v2.png)

3. Rename to **My Filters Region** or a name of your choosing.

![Rename Region](images/add-spatial-analysis-02.png)
![Rename Region](images/add-spatial-analysis-02-v2.png)

## Task 2: Add an Item for State Selection

1. Drag a Select List item your filters region and update the name to **P3_STATE**.

![Add Select List Item](images/add-spatial-analysis-03.png)
![Add Select List Item](images/add-spatial-analysis-03-v2.png)

2. In the Page Item properties on the right, scroll down to the section for List of Values. Enable **Value Required** using the switch, set the Type as **SQL Query** and enter the following query:

Expand All @@ -59,11 +59,11 @@ Estimated Lab Time: 30 minutes

1. Drag Number Field into your filters region. Update the name to **P3_DISTANCE** and the label to **Proximity (km)**.

![Add Number Field Item](images/add-spatial-analysis-06.png)
![Add Number Field Item](images/add-spatial-analysis-06-v2.png)

2. In the Page Item properties on the right, scroll down to the Validation section and enable **Value Required**.

![Set Validation to Value Required](images/add-spatial-analysis-07.png)
![Set Validation to Value Required](images/add-spatial-analysis-07-v2.png)

3. Scroll down to the section for Default. Set the Type to **Static** and value to **100**.

Expand All @@ -77,25 +77,25 @@ You next create the actions that are invoked when state and/or distance values a

1. Right-click on either your P3\_STATE or P3\_DISTANCE item and select **Create Dynamic Action** (the action we create will be applied to both items).

![Create Dynamic Action](images/add-spatial-analysis-09.png)
![Create Dynamic Action](images/add-spatial-analysis-09-v2.png)

2. In the Dynamic Action properties on the right, set the Name to **Validate and Refresh**. Under the When section, set Event to **Change**, Selection Type to **Items**, and items to the comma separated list **P3\_DISTANCE,P3\_STATE** . Note, the button to the right of the items text box allows you select items from a list. To prevent submitting negative values for distance, under the Client Side Condition section, set Type to **Item >= Value**, item to **P3\_DISTANCE** and Value to **0**.
2. In the Dynamic Action properties on the right, set the Name to **Validate and Refresh**. Under the When section, set Event to **Change**, Selection Type to **Item(s)**, and items to the comma separated list **P3\_DISTANCE,P3\_STATE** . Note, the button to the right of the items text box allows you select items from a list. To prevent submitting negative values for distance, under the Client Side Condition section, set Type to **Item >= Value**, item to **P3\_DISTANCE** and Value to **0**.

![Configure Dynamic Action](images/add-spatial-analysis-10.png)
![Configure Dynamic Action](images/add-spatial-analysis-10-v2.png)

3. Dynamic Actions are configured with TRUE action(s) and FALSE action(s) which are invoked based on conditions that have been configured. In this case the client-side condition (P3\_DISTANCE >= 0) determines whether to invoke the TRUE Action (condition is met) or the FALSE Action (condition is not met). This will allow us to trap negative distance entry.

When the client-side condition is TRUE, the action should submit the input values and refresh the page. Click on the action under True. In the Action properties on the right, under Identification set Action to **Refresh**. Under Affected Elements, set Selection Type to **Region** and Region to **My Map Region** (or the name you used if different.) Observe in the page tree on the left that the True action changes to Refresh.

![Configure Dynamic Action](images/add-spatial-analysis-11.png)
![Configure Dynamic Action](images/add-spatial-analysis-11-v2.png)

4. Next you will configure the action to invoke when the client-side condition is not met, meaning a negative distance value was entered. Under Dynamic Actions for either item, right-click on False and select **Create FALSE Action**.

![Configure Dynamic Action](images/add-spatial-analysis-12.png)
![Configure Dynamic Action](images/add-spatial-analysis-12-v2.png)

5. The FALSE Action invoked when distance is negative will be a popup message to the user. Click on the False action. In the Action properties on the right, under Identification, set Action to **Alert**. Under Settings set the Title to **Invalid distance** (this will be the alert banner) and Message to **Distance must be >= 0** (this will be the alert body). Observe in the page tree on the left that the False action changes to Alert.

![Configure Dynamic Action](images/add-spatial-analysis-13.png)
![Configure Dynamic Action](images/add-spatial-analysis-13-v2.png)

6. Your Map Region currently includes a States layer displaying all states. You now adjust this layer to only display the state selected from the P3\_STATE menu. In the page tree on the left, under Layers click on States. In the Layer properties on the right, under Identification change Name to **Selected State**. Under Source set the Where Clause to **state\_code = :P3\_STATE**. Observe in the page tree on the left that the layer name changes to Selected State.

Expand All @@ -105,7 +105,7 @@ You next create the actions that are invoked when state and/or distance values a
</copy>
```

![Configure WHERE clause](images/add-spatial-analysis-14.png)
![Configure WHERE clause](images/add-spatial-analysis-14-v2.png)

7. Finally you update the Airports layer to return items filtered by the user-specified state and proximity. In the Page tree on the left, click on the Airports layer. In the Layer properties on the right, under Source, change Type to **SQL Query**. For SQL Query enter the following which uses Oracle Database's native SQL "within distance" operator.
Expand All @@ -122,7 +122,7 @@ You next create the actions that are invoked when state and/or distance values a
For Page Items to Submit, enter the comma separated list **P3\_STATE,P3\_DISTANCE** .
![Spatial SQL query](images/add-spatial-analysis-15.png)
![Spatial SQL query](images/add-spatial-analysis-15-v2.png)
8. Your page is now ready to view. Click **Save** and then the green **Run** button at the upper right. Once the page is rendered, for state select **Alabama**. The map displays the selected state and airports within 100km (the default distance).
Expand Down Expand Up @@ -150,4 +150,4 @@ You next create the actions that are invoked when state and/or distance values a
## Acknowledgements
* **Author** - David Lapp, Database Product Management, Oracle
* **Last Updated By/Date** - David Lapp, Database Product Management, March 2023
* **Last Updated By/Date** - Denise Myrick, Database Product Management, November 2024
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
24 changes: 9 additions & 15 deletions spatial-apex/create-map-from-scratch/create-map-from-scratch.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,27 +12,21 @@ Estimated Lab Time: 15 minutes

### Prerequisites

* Lab 2: Create map with wizard
* Lab 2: Create map with Wizard

## Task 1: Create a New Page

1. In the breadcrumbs at the top left, click on the link for your application home. Then click on the **Layout** tab.
![Page layout](images/create-map-15a.png)
1. In the breadcrumbs at the top left, click on the link for your application home.
![Page layout](images/create-map-15a-v2.png)

2. Click on **Create Page**.
![Create page wizard](images/create-map-15b.png)

3. You could select Map here to have the same wizard you saw in the Create App wizard. But this step is to create a map from scratch, for example if you had an existing page. Select **Blank Page** and then click **Next**.
![Select Blank Page](images/create-map-16.png)

4. For name enter **Airports and States Map** and then click **Next**.
![Enter page Name](images/create-map-16a.png)

5. Select the option to create a new navigation menu entry and enter **Airports and States Map**, i.e. the same as the page name. Then click **Next**.
![Create navigation menu entry](images/create-map-17.png)

6. Review the summary and click **Finish**.
![Review summary](images/create-map-18.png)
4. For name enter **Airports and States Map** Select the option to create a new navigation menu entry and enter **Airports and States Map**, i.e. the same as the page name. Review entries and click **Create Page**.
![Enter page Name](images/create-map-16a-v3.png)

## Task 2: Add a Map to the Page

Expand All @@ -49,7 +43,7 @@ Estimated Lab Time: 15 minutes
![Update Layer properties](images/create-map-23.png)

5. Scroll down in the Layer properties panel on the right. Update the **Source** to use the table **EBA\_SAMPLE\_MAP\_AIRPORTS** . To limit the airports rendered in the layer, add the where clause **LAND\_AREA\_COVERED > 2500**. Enable the option Use Spatial Index using the switch.
![Update Layer properties](images/create-map-24.png)
![Update Layer properties](images/create-map-24-v2.png)

6. Scroll down in the Layer properties panel on the right to the **Column Mapping** section. This is where you configure the spatial column for rendering. Select geometry data type **SDO\_GEOMETRY** and geometry column **GEOMETRY**.
![Update Layer properties](images/create-map-25.png)
Expand Down Expand Up @@ -83,11 +77,11 @@ Estimated Lab Time: 15 minutes
5. Observe your map render with States and Airports layers. Click and drag the map to pan, and use the navigation control at the top right to zoom in and out. Click on an Airport to see the info window that you configured. Mouse over a state to see the tooltip that you configured. Turn layers off and on with the checkboxes under the map.
![Interact with the map](images/create-map-30.png)
Congratulations on creating your first map from scratch. In the next Lab you will incorporate spatial analysis into this map.
Congratulations on creating your first map from scratch. In the next Lab, you will incorporate spatial analysis into this map.
This concludes the lab. You may now proceed to the next lab.
This concludes the lab. You may now **proceed to the next lab**.
## Acknowledgements
* **Author** - David Lapp, Database Product Management, Oracle
* **Last Updated By/Date** - David Lapp, Database Product Management, March 2023
* **Last Updated By/Date** - Denise Myrick, Database Product Management, November 2024
4 changes: 2 additions & 2 deletions spatial-apex/create-map-with-wizard/create-map-with-wizard.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,9 +70,9 @@ You will now inspect the Map Region created by the wizard.

Congratulations on creating your first maps. There is a lot of capability beyond the basics you have just explored. Feel free to experiment with adjustments to parameters and then Save and Run to see results. In the next Lab you will configure a new Map Region from scratch.

This concludes the lab. You may now proceed to the next lab.
This concludes the lab. You may now **proceed to the next lab**.

## Acknowledgements

* **Author** - David Lapp, Database Product Management, Oracle
* **Last Updated By/Date** - David Lapp, Database Product Management, March 2023
* **Last Updated By/Date** - Denise Myrick, Database Product Management, November 2024
Loading

0 comments on commit b1ea29a

Please sign in to comment.