Interrogate and automate applications that run in the Google Chrome browser by using the Pega Chrome extension with the Universal Web Adapter in Pega Robotic Automation.
The Pega Chrome extension is backwards compatible; the newer versions of the extension work with older versions of Pega Robotic Automation. To see when versions of the extension were released, see the Pega Robotic Automation build notes.
Installing the extension
Use the Setup wizard for Robot Studio and Robot Runtime to install the Pega Chrome extension. To update users from the command line, use the command line installation with the INST_Chrome=1 parameter to install the extension. For more information, see the installation instructions for your version of Robot Studio or Robot Runtime.
If you install Robot Studio or Robot Runtime without the Pega Chrome extension and later want to install the extension, use the web installer utility. This utility is located in the Robot Studio or Robot Runtime installation folder. The following is an example of the command you would enter to install the extension and update the messaging host for Chrome.
OpenSpan.WebExtensionInstaller.exe Chrome -i
Enabling the extension
After installing the Pega Chrome extension, the first time any user starts Robot Runtime, that user must decide whether to enable or uninstall the Chrome extension. Automation developers, of course, would enable the extension. Automation end users must enable the extension too, so the automation can automate the browser. If automation end users do not enable the extension, you must perform a manual process to recover and re-install the extension. For more information, contact Pega Support.
Keep in mind the following considerations when you automate applications that run in the Chrome browser:
- To support multiple concurrent adapters, you must have version 8.0.1028 or later. For more information, see Using multiple Chrome adapters within a Studio solution.
- To support frames, you must have version 8.0.1038 or later.
- To have access to the properties, methods, and events of a frame or top-level Windows form in your automation, use non-global webpages. To interrogate non-global webpages, you must have version 8.0.1042 or later.
- Property changed and Cancellable events are not supported in Chrome, but are supported in Internet Explorer.
Automating dialogs in Chrome
To automate the File Open, File Save as, and Print dialogs in Chrome in applications that use the Universal Web Adapter, use Pega Robot Studio version 19.1.98 or later. For more information, see Automating dialogs in Chrome and Edge.
Automating tables in Chrome
You can interrogate rows of data and cells within those rows. Use cloning to work with tables. For more information, see Interrogating HTML tables with the Universal Web Adapter.
Working with the shadow DOM
If your solution interrogates and automates controls that are under Shadow Document Object Models, use Pega Robotic Automation 19.1.62 or later and version 1.1.101 of the Chrome extension, or later.
Using Microsoft Group Policy to control Chrome policies
If you use a Microsoft Group Policy Object (GPO) to control Chrome policies, and you enable the Configure native messaging block list setting in the Native Messaging sectionto block all extensions, perform the following steps to provide Robot Studio and Robot Runtime with the access they need to function correctly.
- Start the Microsoft Local Group Policy Editor.
- Select .
- In the Configure native messaging allowlist setting, add the following messaging-host executableto so that messaging host is not blocked:
- Save your changes and close the Local Group Policy Editor.
Also, if you enable the Control which extensions cannot be installed setting in the Extensions section to block all extensions, add the Extension ID to the Allow specific extensions to be installed setting so that the extension can be installed.