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

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.

Use Cases

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 example:

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

Add a Screenshot Action

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.
  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 or tab, open the application where the robot works.

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

      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, if the field is shaded purple and the magnifying lens icon appears, don't click yet. The recorder is still collecting information.

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

      5. After the shading turns green, the icon changes to a target, 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 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.
  5. Click OK.
  6. Above the canvas, select Save.