1. Using Robots in Oracle Integration 3
  2. Build a Robot
  3. Add an Action to a Robot
  4. Add a Screenshot Action

Pre-General Availability: 2024-09-02

Add a Screenshot Action

The screenshot action captures a screenshot of a user interface and sends the file to the integration that ran the robot.

The screenshot action is different from the screenshots that you can capture before and after an action occurs as part of troubleshooting. See Capture Screenshots in Robots.

You typically use the screenshot action when the screenshots that are available within an action don't meet your requirements. For instance:

  • If an action opens a new tab or browser, use the screenshot action to capture an image of the new tab.
  • If you need to send a screenshot to another application, use the screenshot action to capture the image.

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 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 mouse cursor points to an action in the canvas and hovers over the plus sign button, which appears at the bottom of the rectangle that represents the action. A plus sign button also appears at the top of the rectangle, for adding an action after the current action.

      A menu of available actions appears.

    2. Select Screenshot.

      A Screenshot action appears on the canvas, and the Screenshot 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. Specify how much of the user interface to capture in the screenshot:

    • Full page: Capture the application's entire page in the screenshot.

    • Element locator: Capture only a specific element in the user interface in the screenshot.

      If you choose this option, the Locator field appears. In this field, specify the element to capture.

      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 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 field from which the robot needs to get text, but don't select the element 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.

        A User ID field is shaded purple, and a magnifying lens icon appears above it

      5. After the icon changes to a target, the shading turns green, and the mouse icon changes to a hand, select the UI element.

        A User ID field is shaded green, and a target icon appears above it

        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.
  5. Click OK.
  6. Above the canvas, select Save.