- Using Robots in Oracle Integration 3
- Build a Robot
- Add an Action to a Robot
- Add a Wait Until Element Is Visible Action
Add a Wait Until Element Is Visible Action
The "wait until element is visible" action pauses a robot until a specific element in a user interface is visible.
Use Cases
Every robot action includes optional validation. This validation is more robust than the "wait until element is visible" action and can handle nearly all wait-related activities.
Therefore, most of the time, you do not need to add the "wait until element is visible" action to any robot. For details about the validation on robot actions, see Add Validation to a Robot Action.
If you opt to add this action to a robot, specify the maximum time to wait, such as 30 seconds. As soon as the element becomes visible, even if the entire time period hasn't elapsed, the robot continues running. If the element doesn't appear within the time, the robot fails.
Add a Wait Until Element Is Visible Action Using the Recorder
Before you add the action, consider creating the robot resources that the robot action requires, such as a variable or a trigger's input and output. Otherwise, just pause the recorder and create the resources when you need them.
- Open the robot to edit.
See Open a Robot.
- Start the
recorder.
- On the canvas, select the action to record after.
- On the toolbar, select Record after the selected
action
.
- In
the panel, from the Select browser tab to target drop-down, select
the application where the robot works. You might need to scroll to find it.
If the application doesn't appear, close the panel, open the application in another tab, and start the recorder again.
A splash screen appears, and 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 field that the robot needs to interact with, but don't select it yet.
For example, if the field is shaded purple and the magnifying lens icon appears, don't click yet. The recorder is still collecting information.
- After the
shading turns green, the icon changes to a target, and the mouse icon changes to a hand,
select the UI element.
For more tips, see Quick Start for Building Robots.
A 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 in the robot.
Your settings determine whether Oracle Integration reuses targets for previously selected UI controls. You can override these settings, if needed. Reusing a target offers benefits. For example, you can update a target one time, and all actions 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.
-
Element: Review the HTML element that you selected. If you selected the wrong element type, select Discard in the panel, and select a different element.
-
Action: Select Wait Until Element Is Visible.
-
- Select Save.
- Point
to the field that the robot needs to interact with, but don't select it yet.
- Choose
the appropriate next step:
-
Add another action using the recorder.
-
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.
-
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.
-
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 Wait Until Element Is Visible Action Using the Low-Code Tools
- Open the robot to edit.
See Open a Robot.
- Add the action
to the robot.
- On the canvas,
point to an action, and click
+.
A menu of available actions appears.
- Select Wait Until Element Is Visible.
A Wait Until Element Is Visible action appears on the canvas, and the Wait Until Element Is Visible 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.
- On the Input tab, specify
input details for the action.
- In another browser window or tab, open the application where the robot works.
- In the robot, click within the Locator field, and
select Target a page element
.
The Target a page element panel appears.
- In the
panel, from the Select browser tab to target drop-down, select the
application where the robot works, and select Go. You might need to
scroll down to find the application.
The application opens.
- In the application that the robot needs to work in, point to the field
that the robot needs to confirm is visible, but don't select the element
yet.
For example, if the field is shaded purple and the magnifying lens icon appears, don't click yet. The recorder is still collecting information.
- After the
shading turns green, the icon changes to a target, 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 these settings, if needed. Reusing a target offers benefits. For example, you can update a target one time, and all actions that use the target get the update. - In the Timeout field, enter the maximum amount of time wait in seconds.
- On the Input tab, specify whether to capture any screenshots as part of the action.
- 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.