Skip to content

Commit

Permalink
WMS ID: 11705 - Get Started with Robots in Oracle Integration 3 (#63)
Browse files Browse the repository at this point in the history
RPA updates
  • Loading branch information
chablani authored Aug 13, 2024
1 parent 9ab4fef commit 7ccc61c
Show file tree
Hide file tree
Showing 18 changed files with 66 additions and 49 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -30,29 +30,36 @@ In this lab, you will:

Specify the service URL and login credentials in a robot connection.

1. In the navigation pane, select **Projects** and then click on the project created in the previous lab.
1. In the navigation pane, select **Projects** and then click on the project created for this lab.

2. On the right side of the page, go to the **Robot connections** box and click **+ (Add)**.
The project page is displayed with the **Integration** category selected.
![Projects Overview](images/projects_assets-overview.png "")

3. On the **Create robot connection** panel, select the Default connection type **Oracle RPA web login**.
2. Click on the ![Select Robot category](images/projects_select-robot-category.png "") (**Robot**) icon on the left of your screen.

3. On the **Robot** category section, go to the **Robot connections** box and click **Add** or **+**.

> **Note**: The **Add** button appears if you have no robot connections. The **+** button appears if you have at least one robot connection.
4. On the **Create robot connection** panel, select the Default connection type **Oracle RPA web login**.

![Create robot flow panel](images/create-robot-connection_select-type.png " ")

4. In the **Create robot connection - Oracle RPA web login** panel, fill in the following fields:
5. In the **Create robot connection - Oracle RPA web login** panel, fill in the following fields:
| **Field** | **Required** | **Value** |
| ------------------- | ----------- | ----------- |
| Name | Yes | Enter a name for the login page. <br> For example: `LiveLabs ERP Cloud` |
| Name | Yes | Enter a name for the login page. For example: `LiveLabs ERP Cloud` |
| Identifier | Yes | This entry is autogenerated based on the Name value. |
| Description | No | Provide additional information about the robot connection.|
| URL | Yes | Enter your ERP Cloud login URL. Please follow this format: <br>`https://<your-erp-cloud-hostname>/fscmUI/faces/FuseWelcome?fndThemeName=Vision_Default` |
| URL | Yes | Enter your ERP Cloud login URL. Please follow this format: `https://<your-erp-cloud-hostname>/fscmUI/faces/FuseWelcome?fndThemeName=Vision_Default` |
| Username | Yes | Enter an ERP user who has access to the Procurement module|
| Password | Yes | Enter a valid ERP password for the selected user. |

The connection panel should look as below:

![Create robot flow panel](images/create-robot-connection_configured.png " ")

5. Click **Create**.
6. Click **Create**.

You have successfully completed this lab.

Expand Down
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.
38 changes: 22 additions & 16 deletions oic-gen3/experiential/get-started-rpa/create-robot/create-robot.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,13 +26,17 @@ This lab assumes you have:

When you create a robot, you define its trigger and the actions that the robot performs.

1. In the navigation pane, select **Projects** and then click on the project created in the previous lab.
1. In the navigation pane, select **Projects** and then click on the project created for this lab.

2. On the right side of the page, go to the **Robots** box and click **+ (Add)**.
2. Click on the ![Select Robot category](images/projects_select-robot-category.png "") (**Robot**) icon on the left of your screen.

3. On the **Robot** category section, go to the **Robots** box and click **Add** or **+**.

![Add Robot](images/projects_add-robot.png "")

3. In the **Create robot** panel, fill in the following fields:
> **Note**: The **Add** button appears if you have no robots. The **+** button appears if you have at least one robot.
4. In the **Create robot** panel, fill in the following fields:
| **Field** | **Required** | **Value** |
| --- | ----------- | ----------- |
| Name | Yes | Enter a name for the robot connection type For example: `LiveLabs Robot` |
Expand All @@ -43,7 +47,7 @@ When you create a robot, you define its trigger and the actions that the robot p

![Create robot panel](images/create-robot-add.png " ")

4. Click **Create**.
5. Click **Create**.

The Robot Designer will appear, with a default robot which includes an **Open Application** action.
![Robot Designer Canvas](images/robot-designer_after-create.png " ")
Expand Down Expand Up @@ -129,7 +133,7 @@ Start the robot by adding the Login action.
* Move the ZIP file to a local folder of your choice, such as ```Users\<user>\RPA\plugin```
* Extract the ZIP file to the designated plugin folder.
* In Google Chrome, open the **Extensions** menu, and select **Manage Extensions**.
* Enable **Developer mode** using the slider on the top right corner.
* Enable **Developer mode** using the slider on the top right corner.
![Chrome Developer Mode](images/chrome_enable-developer-mode.png)
* On the **Extensions** page, select **Load unpacked**.
* Navigate to the folder containing the unzipped files, select the *target* folder, and click on **Select Folder**.
Expand All @@ -150,19 +154,20 @@ Start the robot by adding the Login action.

![Robot design Targeting](images/robot-designer_targeting-on.png "")

9. On the Oracle Fusion login page, point to the `User ID` field where the robot will enter the user name.
> **Note**: When using the targeting component, wait until the target icon appears, the field turns green, and your mouse icon changes to a hand before selecting the UI element. By clicking the field before it turns green will result in a regular UI interaction.
9. On the Oracle Fusion login page, point to the `User ID` field where the robot will enter the user name and click on that field when the icon changes to a target (color turns green).

![Robot input username locator select](images/robot-designer_smart-record_select-user-id.png "")

The Targeting will map the `User ID` UI element value to the **Username locator** field in the robot.

> **Note**: When using the targeting component, wait until the target icon appears, the field turns green, and your mouse icon changes to a hand before selecting the UI element. By clicking the field before it turns green will result in a regular UI interaction.
![Robot input username locator select](images/robot-designer_username-locator_mapped.png "")

10. Repeat the previous steps for the following fields:

* **Password locator**: Select the `password` UI element.
* **Submit locator**: Select the `Sign In` button that the robot clicks to sign in to the Oracle Fusion application.
* **Password locator**: Select the `password` UI element after it turns green.
* **Submit locator**: Select the `Sign In` button after it turns green. The robot will click this button to sign in to the Oracle Fusion application.

Your intermediate Login action panel should look as follows:

Expand All @@ -176,11 +181,11 @@ Start the robot by adding the Login action.

While building the rest of the robot, you'll record the actions that the robot completes using the recorder, all while harnessing the power of control and power of the low-code capabilities. We will navigate the Fusion pages using UI actions (e.g. mouse clicks, keyboard entries), which will automatically generate the relevant robot actions on the flow.

1. Open the browser window where the credentials were entered in the previous task. Click **Sign In** to proceed to the next screen in ERP Cloud.
1. Open the browser window with the Oracle Cloud ERP login page. Enter the provided credentials and click **Sign In** to proceed to the ERP Cloud landing page.

![ERP Cloud login](images/erp-cloud_login.png " ")

We will start the robot recording after the login screen.
We will start the robot recording after the login action.

2. Return to the browser tab running the robot designer. On the robot designer canvas, click the **Login** action to enable the record button.

Expand All @@ -200,7 +205,7 @@ While building the rest of the robot, you'll record the actions that the robot c

> **Note**: When recording actions, the recorder can start from any point in time. However, for this task we will record after the Login operation.
7. From the top menu in ERP Cloud, click on **Procurement** when the icon changes to a target.
7. From the top menu in ERP Cloud, click on **Procurement** when the icon changes to a target.

![Click Procurement target elements](images/robot-designer_smart-record_click-procurement.png " ")

Expand Down Expand Up @@ -286,7 +291,7 @@ While building the rest of the robot, you'll record the actions that the robot c
4. Save To: In the field, click ![Select Flow button](images/action-details_output_flow-button.png) (**Output**)
5. Double-click the **SupplierName** property to have it mapped to the **Save to** field.

![Select Flow button](images/action-details_output_assign-supplier.png " ")
![Assign supplier name to output](images/action-details_output_assign-supplier.png " ")

29. Click **Save**.

Expand All @@ -296,8 +301,9 @@ While building the rest of the robot, you'll record the actions that the robot c

We will add a Log action to capture the output value of the robot.

32. Click on the **Robot actions** panel, and drag-and-drop the **Log** action to the tail end of the flow.
![Add Log action](images/robot-designer_add-log-action.png " ")
32. Click on the ![Select Robot actions](images/robot-designer_select-robot-actions.png) (**Robot actions**) panel, and drag-and-drop the **Log** action to the tail end of the flow.

![Add Log action](images/robot-designer_add-log-action.png " ")

33. On the **Log** panel, hover over the **Message** field, click **...** (**More options**), and select **Output**. This assigns the output value to the log message.
![Assign Log Output Message](images/robot-designer_log-action_assign-output.png "")
Expand All @@ -311,7 +317,7 @@ While building the rest of the robot, you'll record the actions that the robot c

The status of your robot should be **Draft**.

![List Draft Robot](images/projects_robot-draft.png)
![Validate Draft state](images/projects_robot-draft.png)

You have successfully completed this lab.

Expand Down
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.
Original file line number Diff line number Diff line change
Expand Up @@ -30,49 +30,53 @@ This lab assumes you have:

Create a scheduled integration that will invoke the robot and pass input parameters.

1. On the project page, move to the **Integrations** box and click **Add**.
1. In the navigation pane, select **Projects** and then click on the project created for this lab.

2. On the **Add integration** panel, click **Create**.
2. Go to the **Integrations** box and click **Add**.

3. On the **Add integration** panel, click **Create**.

![Select Create](images/add-integration_create.png " ")

3. On the next screen, select **Schedule**
4. On the next screen, select **Schedule**

![Select Schedule pattern](images/add-integration_select-schedule.png " ")

4. Enter a name for the integration, leave all other fields as default, and click **Create**.
5. Enter a name for the integration, leave all other fields as default, and click **Create**.

![Enter integration name](images/add-integration_enter-name.png " ")

The Integration Designer will appear, with a default integration.
The Integration designer will appear, with a default integration.

5. However the mouse just below the **Schedule** activity and click on the **+** button.
6. However the mouse just below the **Schedule** activity and click on the **+** button.

![Add Robot activity](images/integration_add-robot-activity.png " ")

6. In the popup **Actions** tab, scroll down until the bottom and select **Robot Flow** action.
7. In the popup **Actions** tab, scroll down until the bottom and select **Robot Flow** action.

![Select Robot flow action](images/integration_select-robot-flow-action.png " ")

7. On the **Configure Basic Info** screen, enter a valid name for the endpoint without spacing.
8. On the **Configure Basic Info** screen, enter a valid name for the endpoint without spacing.

![Enter endpoint name](images/integration_add-robot-activity_enter-endpoint-name.png " ")

8. On the **Configure Configuration** screen, select the previously activated Robot flow.
9. On the **Configure Configuration** screen, select the previously activated Robot flow.

![Select robot flow](images/integration_add-robot-activity_select-robot.png " ")

9. Click **Continue**, then **Finish**.
10. Click **Continue**, then **Finish**.

The designer with Robot action will be displayed.

![Show robot action](images/integration_show-robot-action.png " ")
![Show integration with robot action](images/integration_show-robot-action.png " ")

10. Move below the **Robot process** activity and click on the **+** button.
11. Move below the **Robot process** activity and click on the **+** button.

![Add activity below Robot call](images/integration_add-activity-below-robot.png " ")

11. In the **Configure assign** panel, take the following steps:
12. Select the **Assign** action.

13. In the **Configure assign** panel, take the following steps:

1. Change **Name** to `Response`
2. Click on the **Apply** button to save name change
Expand All @@ -81,16 +85,16 @@ Create a scheduled integration that will invoke the robot and pass input paramet

![Configure Assign action](images/assign-action_configure.png " ")

12. With the side panel displayed, take the following steps:
14. With the side panel displayed, take the following steps:

1. Change **Variable** to ```vSupplierName```
2. On **Input sources** tab, expand **$CallRobot > RPAFlowResponse > ResponseWrapper** and drag `SupplierName` to the **Value** textbox on the right.

![Configure Assign variable](images/assign-action_configure-variable.png " ")

13. Click **Save** to close the panel.
15. Click **Save** to close the panel.

14. On the integration canvas, click **Save**.
16. On the integration canvas, click **Save**.

## Task 2: Add Scheduled parameters

Expand Down
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.
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ The Java Runtime Environment (JRE) is software that Java programs require to run

1. Verify if a JRE is pre-installed on the host machine by running the below command.

For Linux and macOS, run this command in the **Terminal**.
For Linux and macOS, run this command in the **Terminal**.

For Windows, run this command in the **Command Prompt (CMD)**.

Expand All @@ -47,7 +47,7 @@ The Java Runtime Environment (JRE) is software that Java programs require to run

2. If there is no JRE listed in the response, then one needs to be installed. Follow this link to download the latest JRE the applies to your system platform (Linux, macOS or Windows) and processor:

https://www.oracle.com/java/technologies/downloads
<https://www.oracle.com/java/technologies/downloads>

3. Follow the **Installation Instructions** on the Java Downloads page.

Expand All @@ -60,7 +60,7 @@ The Robot Agent must be downloaded and installed on your local host. The agent i
2. On the top right corner of the window, click on **Download**. Then, select **Robot Agent**.
![Download Robot Agent](./images/download-robot-agent.png ' ')

You should receive a confirmation about the agent getting downloaded.
You should receive a confirmation about the agent getting downloaded. This could take a couple of minutes.
![Download Robot Agent notification](./images/download-robot-agent-notification.png ' ')

3. Once the download has completed, navigate to the designated folder on your local machine to obtain the agent installation file ```rpa_agent.zip```. The default location is typically the **Downloads** folder.
Expand Down Expand Up @@ -97,12 +97,12 @@ You must start the robot agent from the computer on which it is installed. If a
5. The robot agent is running successfully when you see below message in the terminal:

```java
INFO - Requesting messages from ControlRoom`
INFO - Requesting messages from ControlRoom
```

You have successfully completed this lab.

## Acknowledgements

* **Author** - Ravi Chablani, Principal Product Manager - Oracle Integration
* **Last Updated By/Date** - Ravi Chablani, June 2024
* **Last Updated By/Date** - Ravi Chablani, June 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.
10 changes: 5 additions & 5 deletions oic-gen3/experiential/get-started-rpa/test-robot/test-robot.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,17 +29,17 @@ This lab assumes you have:

Create an Environment Pool and assign you local computer to it.

1. In the navigation pane, select **Projects**.
1. In the navigation pane, select **Projects** and then click on the project created for this lab.

2. Open the LiveLabs project.
2. Click on the ![Select Robot category](images/projects_select-robot-category.png "") (**Robot**) icon on the left of your screen.

3. In the **Environment Pools** box, select **Add** or **+**.
3. On the **Robot** category section, go to the **Environment Pools** box and click **Add** or **+**.

> **Note**: **Add** button appears if you have no environment pools. The **+** button appears if you have at least one environment pool.
> **Note**: The **Add** button appears if you have no environment pools. The **+** button appears if you have at least one environment pool.
The **Create environment pool** panel appears.

4. Fill in the **Name** field, such as `LiveLabs-EnvPool`.
4. Fill in the **Name** field, such as `LiveLabs EnvPool`.

5. Select **Create**.

Expand Down

0 comments on commit 7ccc61c

Please sign in to comment.