- Using Robots in Oracle Integration 3
- Build a Robot
- Add an Action to a Robot
- Add a List Action
Pre-General Availability: 2024-09-02
Add a List Action
The list action interacts with a list, such as by selecting, deselecting, or getting the value of one or more items.
Use Cases
This action has specific requirements for the page's underlying HTML code.
You can use this action only when a UI element has a web element of
select
. For drop-down and multi-select lists, the HTML code might
wrap the select
element in an option
element.
Add a List Action Using the Recorder
- Open the robot to edit.
- In the navigation pane, select Projects.
- Select the project name.
- In the left toolbar, select Robot .
- In the Robots box, select the
robot to open.The canvas appears.
- Start the
recorder.
- On the canvas, select the action that you want to record after.
- On the toolbar, select Record after the selected action .
- In
the Smart record panel, open the Select
browser tab to target drop-down, and
select the application that you want to work in.
You might need to scroll down to find the
application.If the application doesn't appear in the list, close the Smart record panel, open the application in another tab, and start the recorder again.A splash screen appears, and then the RPA Smart Recording panel appears.
- Select
Begin Recording.
The Smart Recording window appears in the lower-left corner of your browser. Additionally, your mouse cursor can now target elements in the user interface.
- Identify the element in the user interface that the robot needs to interact
with.
- Point to the list that the robot needs to interact with, but don't
select the list yet.
For example, do not select the UI element while the magnifying lens icon appears and the field is shaded purple. The recorder is still collecting information about the UI element.
- After the icon
changes to a target, the shading turns green, and
the mouse icon changes to a hand, select the UI
element.
For more tips, see Quick Start for Building Robots.
The Smart Recorder panel appears with details about the element you selected. - Review and update the fields as needed.
-
Name: Enter the name of the target. This text appears on the robot action in the canvas and in the list of targets that are in the robot.
Your settings determine whether Oracle Integration reuses targets for previously selected UI controls. You can override this setting, if needed. Reusing a target offers benefits. For example, you can update a target one time, and all robots that use the target get the update.
-
Target name: Review the XML Path Language, or XPath, for the element that you selected. Underscores (_) appear in place of invalid characters. You can update the value, if you want.
-
Action: Select how the robot interacts with the list.
Option Description Selection list type Get Selected List Label Get the HTML label attribute of the selected item in a list.
If no items are selected, the robot returns an empty value.
Single Selection List Get Selected List Labels Get the HTML label attribute of each item that is selected in a list.
If no items are selected, the robot returns an empty value.
Multiple Selection List Get Selected List Value Get the HTML value attribute of the selected item in a list.
If no items are selected, the robot returns an empty value.
Single Selection List Get Selected List Values Get the HTML value attribute of each item that is selected in a list.
If no items are selected, the robot returns an empty value.
Multiple Selection List Select From List By Index Select one or more items in a list according to the HTML index attribute that you provide.
The indexes of list options start from 0. That means that the first entry in the list is numbered 0, the second entry is numbered 1, and so on.
Single Selection List
Multiple Selection List
Select From List By Label Select one or more items in a list according to the HTML label attribute that you provide.
Single Selection List
Multiple Selection List
Select From List By Value Select one or more items in a list according to the HTML value attribute that you provide.
Single Selection List
Multiple Selection List
Unselect From List By Index Deselect one or more items in a list according to the HTML index attribute that you provide.
The indexes of list options start from 0. That means that the first entry in the list is numbered 0, the second entry is numbered 1, and so on.
Multiple Selection List
Unselect From List By Label Deselect one or more items in a list according to the HTML label attribute that you provide.
Multiple Selection List
Unselect From List By Value Deselect one or more items in a list according to the HTML value attribute that you provide.
Multiple Selection List
-
- For Save to, specify where to save the text that
you get from the field. You have the following options:
-
Assign the value to a variable.
-
Click within the Save to field, and select Variables .
The Variables panel appears.
-
Determine whether the variable that you need appears in the list. If not, create it. See Create a Variable.
-
Select the variable to assign the value to, and drag it to the Save to field.
-
-
Assign the value to a property of the output property.
-
Click within the Save to field, select More options, and then select Flow Input/Output.
The Input & Output panel appears.
-
Select the Output tab.
-
Determine whether the output property that you need appears in the list. If not, create it. See Create a Trigger's Input or Output.
-
Select the output property to assign the value to, and drag it to the Save to field.
-
-
- Select Save.
- Point to the list that the robot needs to interact with, but don't
select the list yet.
- Choose
the appropriate next step:
-
Add another action using the recorder.
-
To pause the recorder so you can figure out your next steps, select Pause in the Smart Recording window in the lower-left corner of the browser.
-
To stop the recorder and return to the canvas, select Stop in the Smart Recording window in the lower-left corner of the browser.
If you close the application that you're recording in, you can still stop the recorder. Select Stop in the toolbar of the canvas.
-
To customize the action you just added, such as by creating validation or identifying the screenshots to capture, stop the recording, double-click the action on the canvas, and update the action as needed.
All actions are read-only until you stop the recorder.
-
- Above the canvas, select Save.
Add a List Action Using the Low-Code Tools
- Open the robot to edit.
- In the navigation pane, select Projects.
- Select the project name.
- In the left toolbar, select Robot .
- In the Robots box, select the
robot to open.
The canvas appears.
- Add the action
to the robot.
- On the canvas,
point to an action, and click
+.
A menu of available actions appears.
- Select List.
A List action appears on the canvas, and the List panel appears.
- On the canvas,
point to an action, and click
+.
- In the panel, enter a Name and
Description for the
action.
The Name appears on the action in the canvas and should help you and others understand the goal of the action.
- From the Selection List Type drop-down, select the type
of list that the robot interacts with.
Option Description Single Selection List The list allows you to select only one option.
If the robot will select only one option, but the list allows multiple items to be selected, select Multiple Selection List instead.
Multiple Selection List The list allows you to select one or more options. - From Operations, select how the robot interacts with the
list.
Option Description Selection list type Get Selected List Label Get the HTML label attribute of the selected item in a list.
If no items are selected, the robot returns an empty value.
Single Selection List Get Selected List Labels Get the HTML label attribute of each item that is selected in a list.
If no items are selected, the robot returns an empty value.
Multiple Selection List Get Selected List Value Get the HTML value attribute of the selected item in a list.
If no items are selected, the robot returns an empty value.
Single Selection List Get Selected List Values Get the HTML value attribute of each item that is selected in a list.
If no items are selected, the robot returns an empty value.
Multiple Selection List Select From List By Index Select one or more items in a list according to the HTML index attribute that you provide.
The indexes of list options start from 0. That means that the first entry in the list is numbered 0, the second entry is numbered 1, and so on.
Single Selection List
Multiple Selection List
Select From List By Label Select one or more items in a list according to the HTML label attribute that you provide.
Single Selection List
Multiple Selection List
Select From List By Value Select one or more items in a list according to the HTML value attribute that you provide.
Single Selection List
Multiple Selection List
Unselect From List By Index Deselect one or more items in a list according to the HTML index attribute that you provide.
The indexes of list options start from 0. That means that the first entry in the list is numbered 0, the second entry is numbered 1, and so on.
Multiple Selection List
Unselect From List By Label Deselect one or more items in a list according to the HTML label attribute that you provide.
Multiple Selection List
Unselect From List By Value Deselect one or more items in a list according to the HTML value attribute that you provide.
Multiple Selection List
- On the Input tab, specify
input details for the action.
- In another browser window, open the application that the robot needs to work in.
- In the
robot, click within the
Locator field, and select
Target a page element
.
The Target a page element panel appears.
- In the
Target a page element panel, open the
Select browser tab to
target drop-down, select the
application that you want to work in, and select
Go. You might need to
scroll down to find the application.
The application that the robot needs to work in opens.
- In the application that the robot needs to work in, point to the list
that the robot needs to interact with, but don't select the list
yet.
For example, do not select the UI element while the magnifying lens icon appears and the field is shaded purple. The recorder is still collecting information about the UI element.
Regardless of the operation that you chose, always point to the list itself.
- After the icon
changes to a target, the shading turns green, and
the mouse icon changes to a hand, select the UI
element.
For more tips, see Quick Start for Building Robots.
The recorder enters a value in the Locator field in the robot.
Tip:
Your settings determine whether Oracle Integration reuses targets for previously selected UI controls. You can override this setting, if needed. Reusing a target offers benefits. For example, you can update a target one time, and all robots that use the target get the update.
- On the
Input tab, specify whether
to capture any screenshots as part of the
action.
See Capture Screenshots in Robots.
If you choose an operation that gets a label or value, Oracle recommends taking a screenshot of the list.
- On the Output tab, specify where to save the value(s)
that you got from the action.
The Output tab appears for only some operations, including Get Selected List Label(s) and Get Selected List Value(s).
-
Assign the value to a variable.
-
Click within the Save to field, and select Variables .
The Variables panel appears.
-
Determine whether the variable that you need appears in the list. If not, create it. See Create a Variable.
-
Select the variable to assign the value to, and drag it to the Save to field.
If the action interacts with a multiselect list, you must select a collection variable, even if the operation gets a single value. If the action interacts with a single-select list, you must select a non-collection variable. Otherwise, an error occurs for the action when you save the robot.
-
-
Assign the value to a property of the output property.
-
Click within the Save to field, select More options, and then select Output.
The Output panel appears.
-
Determine whether the output property that you need appears in the list. If not, create it. See Create a Trigger's Input or Output.
-
Select the output property to assign the value to, and drag it to the Save to field.
If the action interacts with a multiselect list, you must select a collection variable, even if the operation gets a single value. If the action interacts with a single-select list, you must select a non-collection variable. Otherwise, an error occurs for the action when you save the robot.
-
-
- On the Pre Validate and Post Validate tabs, specify whether to complete any validation before and after the action.
- Click OK.
- Above the canvas, select Save.