Prerequisites

Ensure you use Browser extension (version 3.6.0.0 or later)

Settings

• Double-click or drag Recorder > Structured data extraction.
• Specify the window in which to capture an object. Choose from the Application, Browser, or Variable tab.
  • 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 supported browser tabs such as Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers.
  • Variable: Select an existing window variable to specify the title of the application window title.
• Specify the window in which to capture an object.
• Click Capture object.

  The selected window appears.

• Move the mouse over the specified object which has similar other elements.

  A red rectangular box appears around the object.

• Click the object.
• Review the Object properties table.
  Important: We recommend you deselect properties like HTML ID, Path and any other properties that might change with every page. Include properties like DOMXPath and CSS selector instead.
• From the Set system time out field, select either Basic or Advanced.
  • Basic: In the Wait for system response (in seconds) field, specify the number of seconds the bot must wait for object control to appear on the application window. This wait time includes the wait time for both page load and object search.
    Note: The timeout specified for the bot to wait for the control to appear on the application window applies only if the window in which the control is present exists. The Recorder first looks for the application window and only then searches for the object inside that window. The default time to search for the window is 30 seconds. Hence, even if you specify the wait time as 5 seconds, it still waits for 30 seconds by default if the window does not exist.

    We recommend that you first use the If > Window exists condition, specify a wait time of zero second and ensure that the application window exists. If the window exists then use the Recorder, specify a wait time of 5 seconds, and run the bot to detect the object.

  • Advanced: Use this option to automate websites that are constantly loading and updating with latest data such as a stocks website. These websites are never technically fully loaded on screen. In such cases, the bot does not need to wait for the web page to load completely and can directly proceed with automating the web page after a certain time.

    In the Wait for browser response (in seconds) field, specify the number of seconds the bot must wait for the browser to load. Select one of the below options:

    • Stop the bot and display an error message: If the web page has not loaded completely within the specified time out, select this option to stop the bot and display an error message.
    • Skip and proceed to the object: Select this option to proceed to the object directly and capture it even if the web page has not loaded completely.

    In the Wait for object response (in seconds) field, specify the number of seconds the bot must wait for object control to appear on the application window.

  • Is data lazy loaded: Select this option for pages where data loads dynamically and continues to auto-load.
    • Retry attempts for newly loaded data: Enter the number of retry attempts you need for checking the same data.
    • Wait between retries: Enter the number of seconds you want the automation to wait between retry attempts.
• In the Save the outcome to a variable field, create a Datatable variable to store the output.

  The extracted data is stored in a data table, where similar objects are arranged as rows and their child elements are represented as columns.