Pre-General Availability: 2024-09-02

Add a Checkbox Action

The checkbox action interacts with a checkbox, such as by selecting it, deselecting it, or determining whether it's selected.

You can use the checkbox action only for a UI element with a tag name of INPUT and a type attribute of checkbox.

Note:

You must use the low-code capabilities to add this action to a robot. Keep reading for step-by-step instructions.

1. Open the robot to edit.
   1. In the navigation pane, select Projects.
   2. Select the project name.
   3. In the left toolbar, select Robot .
   4. In the Robots box, select the robot to open.

      The canvas appears.

2. Add the action to the robot.
   1. On the canvas, point to an action, and click +.
      

      A menu of available actions appears.

   2. Select Checkbox.

      A Checkbox action appears on the canvas, and the Checkbox panel appears.

3. 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.

4. From Operations, select how the robot interacts with the checkbox.
   • Select Checkbox: The robot selects a checkbox.
   • Unselect Checkbox: The robot clears a checkbox selection.

   • Is Checkbox Selected: The robot checks whether a checkbox is selected. This option is useful if you need to take a different action depending on whether a checkbox is selected.

5. On the Input tab, specify input details for the action.
   1. In another browser window, open the application that the robot needs to work in.
   2. In the robot, click within the Locator field, and select Target a page element .

      The Target a page element panel appears.

   3. 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.

   4. In the application that the robot needs to work in, point to the checkbox that the robot needs to interact with, but don't select the checkbox 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.

      

   5. 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.
6. On the Input tab, specify whether to capture any screenshots as part of the action.

   See Capture Screenshots in Robots.

7. If you selected the Is Checkbox Selected operation, specify where to save the answer that you get on the Output tab.

   • Assign the value to a variable.

     1. Click within the Save to field, and select Variables .

        The Variables panel appears.

     2. Determine whether the variable that you need appears in the list. If not, create it. See Create a Variable.

     3. 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.

     1. Click within the Save to field, select More options, and then select Output.

        The Output panel appears.

     2. Determine whether the output property that you need appears in the list. If not, create it. See Create a Trigger's Input or Output.

     3. Select the output property to assign the value to, and drag it to the Save to field.

8. On the Pre Validate and Post Validate tabs, specify whether to complete any validation before and after the action.

   See Add Validation to a Robot Action.

9. Click OK.
10. Above the canvas, select Save.