Read and Review Automation Anywhere Documentation

Automation 360

Close Contents

Contents

Open Contents

Using Capture area action

  • Updated: 1/11/2021
    • Automation 360 v.x
    • Build
    • RPA Workspace

Using Capture area action

Use the Capture area action in the Screen package to capture a screenshot of the application window area.

Procedure

To capture a specified area of an application window, perform these steps:

  1. In the Actions palette, double-click or drag the Capture area action from the Screen package.
  2. Specify the window in which to capture an object.
    Choose from the Application, Browser, or Variable tab.
    OptionDescription
    Application Select from a list of currently active windows. This option shows a list of all the application and browser windows that are open on the Bot Creator device.
    Browser Select from a list of Google Chrome tabs that are currently open on the Bot Creator device.
    Note: Currently, this option only supports Google Chrome tabs. For all other browsers, use the Application option.
    Variable Select an existing window variable to specify the title of the application window title.
  3. Optional: Insert a wildcard character (*) in the Window title field to search for window titles that can change. You can specify one or more wildcards (*) at the start, middle, or end of the value.
    For example, to perform an operation on any window that has Microsoft in the title, use a wildcard to indicate any string by adding it before or after the value: *Microsoft*. The bot first searches for the exact window title (Microsoft), and if it does not find a match, it searches for windows with the term Microsoft anywhere in the title.

    You can use a regular expression (regex) to identify a window title. Select the regular expression either as a String or Pattern for each regular expression condition and enter the value. By default, the Window title field is case-sensitive. You can enable Case insensitive regex flag to identify a window title that is not case-sensitive.

    For example, you can enter the String value as ((\w*)-Notepad for all the window title names starting with ((\w*)-Notepad, or use Pattern such as ((\w)\s)*document-Notepad for only those window titles that match this pattern.

    Note: During runtime, verify that the TaskBot identifies the correct window. If it does not, do the following:
    1. Open the application or browser window.
    2. Drag a Window > Get active window title action above the Recorder > Capture action.
    3. Insert a string variable into the Assign the window title to variable field.
    4. Drag a Window > Set title action below the Window > Get active window title action.
    5. In the Window field, insert the window variable generated by the Recorder > Capture action.
    6. In the New window title field, insert the string variable from the Get active window title action.
    7. Click Save.
  4. Optional: Select the Resize window option to specify the window dimensions.
    This option delivers a more reliable bot. It resizes the window to the dimensions at which the task was recorded, which enhances the bot's ability to identify the target object.
    • If the window is maximized when you record the task, this option is unselected.
    • If the window is not at the maximum size when you record the task, this option is selected by default and the width and height fields auto-fill with the window dimensions.
    Note: This option is only available for windows that can be resized. It is not available for the Desktop or Taskbar options.
  5. Click the Capture region.
    The pixel coordinates of the captured area are displayed in the X, Y, Width, and Height fields. You can modify these values.
  6. Browse to select the File path to save image.
    The following file extensions are supported: png, bmp, jpeg, tiff, gif, and wmf.
  7. Click Overwrite file to replace an existing file with the same name.
  8. Click Save.
Send Feedback