Access Websites in Device Automation

When creating a Device Automation workflow, you can open websites in the built-in browser and use action steps to extract information and navigate sites. The built-in browser is based on the Chromium open-source browser project. To navigate, use Device Automation step actions.

Note Command timeout for browsing websites is set either on the Device Automation tab of the Design Studio Settings window for executing the workflow in Design Studio, or in the Device Automation section on the Security tab of the RoboServer Settings window for roboserver execution. See Runtime > Security in the Kofax Kapow Administrator's Guide.

Kapow browser supports the following protocols:

  • http:
  • about:
  • javascript:
  • https:
  • ftp:
  • file:

To open a website, insert the Open Step and type the address including the protocol in the URI field. Use the Tree Stops Changing guard after any step that includes loading a page or when other changes occur on a webpage. See Guarded Choice Step for more information.

Browser interface
The built-in browser in Device Automation contains the following controls.

Button

Description


Go back button in the built-in Kapow browser

Go back: navigates one page back.


Go forward button in the built-in Kapow browser

Go forward: navigates one page forward.


Reload button in the built-in Kapow browser

Reload: reloads the current page.


URL field

URL field: Contains either the URL of the currently loaded page or the URL you pasted before navigating to the page.


Navigate button

Navigate: goes to the URL entered in the URL field.

Configure proxy settings

Configure Proxy: opens proxy configuration dialog box.

Print to PDF button

Print to PDF: saves the currently open webpage to a pdf file.


Save page button

Save page button: saves the currently open page in HTML format. Note that this button is located in the right corner of the browser toolbar and might not be visible on some screens. If you cannot see the button, scroll the Automation Device view window to the right.

URL in the built-in browser

Browser window contains the URL text field in the toolbar. It shows the URL of the loaded web page. You can select the URL and extract the value into a variable using action steps. The tree view shows the URL as well.

  • To select the text in the URL field, click the URL field using the Click Step.
  • To change the address, click the URL field by using the Click step and enter the address using either the Enter Text step or from a variable.
  • To go to the entered URL, click the Navigate button to the right of the URL field.
Configure proxy
To change proxy settings for the built-in browser in Device Automation, click the Configure Proxy button on the web browser toolbar. The following proxy options are available:
  • Direct: Proxy is not used.
  • Fixed: Specify fixed proxy settings, such as host, port, and a bypass list.
  • PAC: Specify the URL of the proxy auto-configuration script file.
  • Auto: Click this option if your network provides for automatic proxy configuration, such as the Web Proxy Auto-Discovery Protocol.
  • System: select this option to copy proxy settings from the computer running your robot.

Once proxy settings are set, click OK to save the settings and close the dialog box.

Save page as PDF
To save an open webpage in the PDF format, click Print to PDF on the browser toolbar and specify the full path including the file name in the open dialog box. Enter double slashes in the path as follows: C:\\AutomatedDevice\\PDFs\\MyPage.pdf. Click OK to save the file.
Save web page
You can save the currently open webpage in HTML format using the Save page button in the browser. To save the page
  1. Click the Save page button using the Click step. Once you execute the step, the browser opens the Save as dialog box. Note that the dialog box opens in the left top corner of the browser.
  2. If you want to change the path to save the file, click the path text field and insert the new path including the file name either using the Enter Text step or from a variable.
  3. Save the page by clicking the Save button.