DocsEdge browser extension
The Blue Prism Edge browser extension establishes connectivity with Blue Prism, allowing Blue Prism to interact with Chromium-based Edge applications and web pages so data can be exchanged and elements manipulated.
The Blue Prism browser extension should be installed on any machine that will be used to automate Edge.
For details of browser extension and Blue Prism versions, see browser extension compatibility.
Prerequisites
The following are required:
- Access to the Edge web store for online installations
- Extension package for offline installations
- The ability to configure Edge add-ons
Install the Edge browser extension using the Blue Prism installer
The Blue Prism installer applies a registry key that installs the Blue Prism extension the next time the browser is started. The installer can be run using the graphical user interface or from the command line.
Install from the Blue Prism installer
Using the advanced installation option, you can determine which browser extensions (and other optional features) are installed.
- Run the appropriate Blue Prism installer for your system – 32-bit or 64-bit.
- Select Advanced install from the Install location page of the install wizard.
- Click Next and select the Edge browser extension and any other features you want to install.
Blue Prism 6.10.5
When installing or upgrading to Blue Prism 6.10.5, you can select between installing the Manifest V2 browser extension for Edge (which corresponds to the existing 6.10.4 browser extension) or the Manifest V3 browser extension for Edge. If you have not selected the Advanced install check box on the Install location screen, the Blue Prism 6.10.4 (Manifest V2) browser extension will be installed by default for the Edge browser. For more information, see the Blue Prism 6.10.5 release notes.
Blue Prism 6.10.6
From Blue Prism 6.10.6 onwards, the Edge browser extension can only be installed using Manifest v3. The features provided by the Browser Automation Agent are now included in the Blue Prism installer by default. From version 6.10.6, the Blue Prism installation wizard automatically removes the Browser Automation Agent and the associated Manifest V3 browser extensions if they have been previously installed. For more information, see the Blue Prism 6.10.6 installation guide.
- Click Install and complete the installation.
For 6.10 versions earlier than 6.10.3, follow the steps 1-3 above and continue with the steps below:
- Click Install.
- When installation is complete, open Edge and type edge://extensions in the address bar.
- Enable the browser extension using the slider.
During an upgrade, the settings already applied for the current installation are maintained unless edited in the advanced install options.
Install from the command line
The following command line options are available for installing Blue Prism and setting the registry key for the Edge extension. The commands below are examples only – update the Blue Prism version number and bitness as required.
|
Command |
Description |
|---|---|
|
msiexec /i BluePrism6.10.4_x64 /qn msiexec /i BluePrism6.10.4_x86 /qn |
Installs Blue Prism and sets Edge extension registry key as well as those for Chrome and Firefox. |
|
msiexec /i BluePrism6.10.4_x64 ADDLOCAL=BluePrism,BPServer /qn msiexec /i BluePrism6.10.4_x86 ADDLOCAL=BluePrism,BPServer /qn |
Installs Blue Prism without setting the browser extension registry keys. |
|
Manifest V2 (up to Blue Prism 6.10.5 only) For Blue Prism 6.10.5, Manifest V2 uses the 6.10.4 extension. msiexec /i BluePrism6.10.4_x64 ADDLOCAL=EdgePlugin /qn msiexec /i BluePrism6.10.4_x86 ADDLOCAL=EdgePlugin /qn Manifest V3 msiexec /i BluePrism6.10.5_x64 ADDLOCAL=EdgePluginV3 /qn msiexec /i BluePrism6.10.5_x86 ADDLOCAL=EdgePluginV3 /qn |
Adds the Edge extension registry key to an existing installation of Blue Prism. |
The ADDLOCAL property can also be used to install multiple Blue Prism components by separating them with a comma. The following command installs 64-bit versions of Blue Prism, and the Chrome, Edge, and Firefox extensions:
Manifest V2 (up to Blue Prism 6.10.5 only)
For Blue Prism 6.10.5, Manifest V2 uses the 6.10.4 extension.
msiexec /i BluePrism6.10.4_x64 ADDLOCAL=BluePrism,BPServer,ChromePlugin,EdgePlugin,FirefoxPlugin /qn
Manifest V3 (Blue Prism 6.10.5)
msiexec /i BluePrism6.10.5_x64 ADDLOCAL=BluePrism,BPServer,ChromePluginV3,EdgePluginV3,FirefoxPlugin /qn
Manifest V3 (Blue Prism 6.10.6)
msiexec /i BluePrism6.10.6_x64 ADDLOCAL=BluePrism,BPServer,ChromePluginV3,EdgePluginV3 /qn
The BluePrism and BPServer components must both be specified to install or upgrade Blue Prism when using the ADDLOCAL parameters. They cannot be used in isolation.
Enable the Edge extension
When installation is complete, open Edge and type edge://extensions in the address bar. Enable the extension using the slider.
Install the Edge browser extension from the web store
The Blue Prism Edge browser extension can be installed via the Microsoft Edge add-ons store using the following URL:
| Blue Prism version | Compatible browser extension version |
|---|---|
|
6.10.6 |
Manifest V3 only: |
| 6.10.5 |
Manifest V3: https://microsoftedge.microsoft.com/addons/detail/blue-prism-6105-browser/bcbgfmbngklahikmeloakcpkaakelojd Manifest V2: https://microsoftedge.microsoft.com/addons/detail/blue-prism-6104-browser/dafncfjkbbhdcbdnaingpgiglcbpggeh |
| 6.10.4 | |
| 6.10.3 | |
| 6.10.2 | |
| 6.10.1 | |
| 6.10 |
https://microsoftedge.microsoft.com/addons/detail/hekghghgjpohegdkkakdkgpcgelmemkk |
To install the browser extension for Edge:
- Open Microsoft Edge.
- Paste the URL for the required version into the address bar of the browser.
-
Click Get and confirm the installation when prompted.
A notification displays when installation is complete and the Blue Prism extension icon is added to the browser toolbar.
Install the Edge browser extension using an offline package
If the browser extension has already been installed, updated extensions that are made available after a Blue Prism release are automatically updated when the browser is loaded if there is an active internet connection. For devices that are not connected to the internet, the Blue Prism Edge extension can be installed offline using an independent package. The extension will need to be installed separately for each user on each device that needs to use the extension.
To install the browser extension for Edge:
-
Download the required extension package from the web store, see URLs for applicable Blue Prism version above.
-
Create a ZIP file of the downloaded extension.
Extensions are stored in the folder C:\Users\'Username'\Appdata\Local\'extension-path', for example for Blue Prism 6.10.0: C:\Users\'Username'\Appdata\Local\Microsoft\Edge\User Data\Default\Extensions\hekghghgjpohegdkkakdkgpcgelmemkk
Select all files in the 6.10.0.0_0 folder and add them to a ZIP file.
-
Open Edge.
Click the menu (...) icon and select Extensions.
edge://extensions displays with the existing extensions. - Switch the page into Developer mode using the slider.
- In Windows Explorer, navigate to the extension ZIP file then drag and drop it into the Edge Developer page.
The extension installs and displays on the page. - Switch the page back into standard mode using the Developer mode slider.
If you have installed Blue Prism using the installer, you will see a Blue Prism extension on this page.
Ensure you turn off Developer mode after installing the extension. Leaving your browser in Developer mode can be a security risk.
Edge browser extension registry key
The following registry keys are applied when installing the browser extension with the Blue Prism installer to instruct the browser to add the Blue Prism extension.
For situations where the browser extension is to be installed independently or, where the registry value applied by the installer is prevented from persisting, such as if network restrictions override them, the setting can be applied using an alternative deployment method, such as Group Policy or Local Security Policy.
|
Registry Key |
32-bit Windows: HKEY_LOCAL_MACHINE\Software\Microsoft\Edge\Extensions 64-bit Windows: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\Edge\Extensions |
|
Name |
1 |
|
Type |
REG_SZ |
|
Data |
6.10.6 Manifest V3 only gknhmclkgjeielofkejdlnbmnfdogdeh 6.10.5 Manifest V3 bcbgfmbngklahikmeloakcpkaakelojd 6.10.5 Manifest V2 dafncfjkbbhdcbdnaingpgiglcbpggeh 6.10.4 dafncfjkbbhdcbdnaingpgiglcbpggeh 6.10.3 iopomglpadeamepdjjnhcmacjhhpbcda 6.10.2 mpdplhcjcmelfpjnbhipheipoekblggm 6.10.1 gdapppmgmiaanopfdghgjbkafmiaidlb 6.10.0 hekghghgjpohegdkkakdkgpcgelmemkk |
Remove the Edge browser extension
Remove using browser options
Select Remove from Microsoft Edge from the extension options.
Remove using the Blue Prism installer
Run the Blue Prism installer and on the Advanced Install page, select Change features and deselect the Edge extension.
Up to Blue Prism 6.10.4
|
Blue Prism 6.10.5
|
Blue Prism 6.10.6 onwards
|
The registry key is deleted and the extension is removed. Alternatively, delete the registry key manually using a registry editor.
Remove using Local Security Policy or Group Policy
To uninstall the Blue Prism Edge extension, remove the value from the specified registry key or delete the entire key if none of the associated settings are required.
