Browse

Use this step to open websites in one of the built-in browsers. See Access Websites for details.

Also use the Browse step to work with cookies in the Chromium built-in browser. See Cookie Management in the Desktop Automation built-in browser for details.

Properties

Browser
Select the browser engine you want to use. Kofax RPA provides a Chromium based browser.
Action
Select an action the browser must perform: Load Page or Wait Downloads.
Load Page
  • URL

    Specify the path to a website to open. Use forward slashes in the path. For example:

    https://www.google.com

  • Screen Size

    Select this option to specify the browser window width and height in pixels. The default window size is 1920x1200, which does not include the toolbar.

  • User Agent

    Select this option to specify what the built-in browser sends in the "User-Agent" header for the HTTP requests. The "User-Agent" string contains information about your web browser name, operating system, device type, and other information.

  • Accept Language List

    If this option is not selected, the page loads in the default language of the website. If selected, the page tries to load in the language according to the specified language code. If the website does not offer that language, the website's default language is used.

    Default code: en-US.

  • Ignore Loading State

    Select this option for the browser to ignore background load requests, such as loading of advertising banners and the like.

    By default, CEF browser analyzes its loading state and if the browser is actively loading a webpage or redirecting to another location, it does not allow running location-based guards. The browser waits until the webpage is loaded and the browser switches to a non-loading state.

    Settings in the "Ignore loading state" property allow users to specify URLs or substrings which are used by the browser to determine if it is allowed to execute Location Found, Location Not Found, Location Disappeared, and Tree Stops Changing guards before the browser completely loads a webpage.

    Users can specify comma-separated URL parts. If while loading a webpage the browser finds a match between a webpage URL and a string specified by a user, it lets location-based guards run if any of the guards should be executed after the Open action or action which changes its loading state (such as, click a button or move mouse).

  • Authentication

    Specify user credentials for the web page authentication. This is the authentication that requires to enter credentials in a pop-up dialog box before the page loads. If a web page does not require authentication, these settings are ignored.

  • PDF Settings

    Specify settings for saving a web page in PDF format.

    • Background Graphics: Select to save background graphics of the web page.

    • Headers and Footers: Select to save headers and footers in the PDF document.

    • Scale: Specify the scale level in percentage.

    • Paper Size: Select the paper size for the PDF document.

    • Layout: Select either landscape or portrait layout of the document.

    • Margins: Specify page margins in the document. If you select Custom, enter each side margins in pixels.

      Note If you want to save your web page as PDF, use the PDF button on the right side of the browser window. You may need to scroll all the way to the right if the button is not visible on the screen.

  • Client Certificate: If the website is using client certificates to authenticate the client (user), you can select this option to pass the client certificate to the website server.

    In Certificate Storage, specify a binary variable containing the certificate storage file. In Storage Password, specify a password variable containing the password to the certificate storage.

Wait Downloads

With this action, you can enable a waiting period for the files that are being downloaded. This can be useful when you need to know if a file is finished downloading or how many downloads are still active, just like you can see it in any web browser.

The maximum wait time is 300 seconds (five minutes). When the wait time is reached, and the download has not completed, the step returns the number of downloads that are still active. In this case, you can decide whether you want to continue the download (stay in the download cycle) or terminate it.

Also, you can explicitly cancel the download if it is taking too much time or is no longer needed.

  • Settings

    • Active Downloads: Select this option to enable a waiting period.

    • Cancel Downloads: Select this option to cancel all active downloads. After the Browse/Wait Downloads step set to "Active Downloads," add a new Browse/Wait Downloads step set to cancel all active downloads.

  • Seconds: Specify the wait time. The default is 60 seconds; the minimum and maximum wait time is 0 and 300 seconds, respectively. After the time is reached, the step returns the status of the download in the variable that you specify in Number of Active Downloads below. If the download process is still active, the variable shows the number of downloads in progress. If all downloads have completed, the number is 0.

  • Wait upload to RFS: Select this option to wait for a notification from the Robot File System that the file is successfully saved to it. After the notification is received by the system, the download is stopped, and the robot continues executing next steps. The maximum size of the file that can be uploaded to the Robot File System is 100 MB.

  • Results:

    Number of Active Downloads: Specify an integer variable to contain information about the number of active downloads.