Blue Prism - Browser Automation Agent for Manifest V3 Extensions

[Pages:30]Blue Prism

Browser Automation Agent for Manifest V3 Extensions

Document Revision: 2.0

Blue Prism | Browser Automation Agent for Manifest V3 Extensions Trademarks and Copyright

Trademarks and Copyright

The information contained in this document is the proprietary and confidential information of Blue Prism Limited and should not be disclosed to a third-party without the written consent of an authorized Blue Prism representative. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying without the written permission of Blue Prism Limited. ? Blue Prism Limited, 2001 ? 2023 ?Blue Prism is a registered trademark of Blue Prism Limited All trademarks are hereby acknowledged and are used to the benefit of their respective owners. Blue Prism is not responsible for the content of external websites referenced by this document. Blue Prism Limited, 2 Cinnamon Park, Crab Lane, Warrington, WA2 0XP, United Kingdom. Registered in England: Reg. No. 4260035. Tel: +44 370 879 3000. Web:

Commercial in Confidence

Page ii

Blue Prism | Browser Automation Agent for Manifest V3 Extensions Contents

Contents

TCroandtemntasrks and Copyright

iii

Installation

4

Prerequisites

4

Install the Browser Automation Agent using the installer

5

Advanced installation

7

Install the Browser Automation Agent from the command line

8

Install the web drivers

9

Launch a browser from Blue Prism

9

PEnrearbelqeuJiasvitaeSscript functionality

9

Uninstall the Browser Automation Agent

11

Blue Prism Browser Automation Agent 2.0: March 2023

12

About this release

12

Applying this patch release

12

Secure development policy

12

Enhancements and improvements

12

Browser extensions

14

Blue Prism Browser Automation Agent 1.0: September 2022

15

About this release

15

Applying this patch release

15

Upgrade notices

15

Known issues

15

Secure development policy

15

Enhancements

16

Browser extensions

16

Improvements in Blue Prism when using the Prism Browser Automation Agent

18

Blue Prism? Browser Automation Agent 2.0 Third-Party Licenses Third-party components

AMNScreyueLyeicslwotpsertogsnotetfoa.osimaCSu-goncjmco.esfRThtnFo.hueW Bfofrinmtgcer.tmeJlai.smbAdaoDisetnyr.gCinv.ocTeImranstpekislref.aErScxetesrvniscieosn.sUnsafe

Referenced licenses

19 19

1290

21

Blue Prism? Browser Automation Agent 1.0 Third-Party Licenses Third-party components

AMNScreyueLyeicslwotpsertogsnotetfoa.osimaCSu-goncjmco.esfRThtnFo.hueW Bfofrinmtgcer.tmeJlai.smbAdaoDisetnyr.gCinv.ocTeImranstpekislref.aErScxetesrvniscieosn.sUnsafe

Referenced licenses

25 25

256

27

Commercial in Confidence

Page iii

Blue Prism | Browser Automation Agent for Manifest V3 Extensions Installation

Installation

The Blue Prism Browser Automation Agent is a complementary application to Blue Prism Enterprise that is launched by a compatible Blue Prism Manifest V3 (MV3) browser extension. This application is provided as a separate installer that:

? Detects the installed version of Blue Prism. ? Removes selected Manifest V2 (MV2) extensions installed on the machine. ? Installs the appropriate MV3 browser extension.

The application provides the ability to insert and invoke JavaScript on web pages using a Chrome or Edge MV3 browser extension; and allows customers using previous versions of Blue Prism to deploy MV3 browser extensions without needing to upgrade their Blue Prism Enterprise installation. There is no additional license required to deploy the Browser Automation Agent.

The Blue Prism Browser Automation Agent is not valid for use with the Blue Prism Firefox browser extension as this uses MV2.

Prerequisites

? Before installing the Browser Automation Agent, you must install a compatible version of Blue Prism from 6.4.2 to 7.1.2.

If using BAA version 2.0, the Edge browser extension can only be installed for use with Blue Prism versions 6.8 and later using the installer. The Edge browser extension is not supported in Blue Prism versions earlier than 6.8.

If using BAA version 1.0, the Edge browser extension can only be installed for use with Blue Prism versions 6.9 and later using the installer. For Blue Prism versions 6.8.x, the Blue Prism Chrome extension must be installed manually from the Chrome web store to use with Chromium-based versions of Microsoft Edge. For more information, see Upgrade notices for Blue Prism version 6.8.

? Installing the Browser Automation Agent should remove your currently installed extensions if they were installed using the Blue Prism installer. If you downloaded the extensions from the web store or via sideloading, you must remove them manually prior to installation.

? The Insert and Invoke JavaScript functions require the appropriate version of the Chrome or Edge web driver to be installed on the machine on which Blue Prism is installed. For more information, see Install the web drivers on page 9.

? The Browser Automation Agent and associated MV3 browser extensions require version 104 or later of the Chrome and Edge browsers. For more information, see the browser extension compatibility.

Commercial in Confidence

Page 4 of 30

Blue Prism | Browser Automation Agent for Manifest V3 Extensions Installation

Install the Browser Automation Agent using the installer

You can either install the Browser Automation Agent with all associated MV3 browser extensions or with selected ones from the Advanced install screen.

Follow the steps below to install the Browser Automation Agent and all associated MV3 browser extensions:

1. Double-click the provided MSI and open the installation wizard. 2. Click Get started.

The License agreement screen displays.

3. Read the End User License Agreement and if you agree to the terms, select the check box and click Next.

The Install location screen displays.

Commercial in Confidence

Page 5 of 30

4. Click Install.

Blue Prism | Browser Automation Agent for Manifest V3 Extensions Installation

5. Click Yes on the User Account Control (UAC) prompt screen. The installation is complete and the Chrome and Edge browser extensions are installed by default.

The availability of the Edge browser extension is dependent upon the version of Blue Prism and the version of the Browser Automation Agent you are using:

? With BAA 2.0, the Edge browser extension can only be installed for Blue Prism 6.8 or later.

? With BAA 1.0, the Edge browser extension can only be installed for Blue Prism 6.9 or later.

For more information, see Prerequisites on page 4.

6. Click OK to close the installation wizard.

Commercial in Confidence

Page 6 of 30

Blue Prism | Browser Automation Agent for Manifest V3 Extensions Installation

Advanced installation

1. If you want to install only one of the browser extensions, on the Install location screen select the Advanced install option and click Next.

The Advanced install screen displays. 2. Clear the selection for the browser extension you do not want to install, and click Install.

The availability of the Edge browser extension is dependent upon the version of Blue Prism and the version of the Browser Automation Agent you are using:

? With BAA 2.0, the Edge browser extension can only be installed for Blue Prism 6.8 or later.

? With BAA 1.0, the Edge browser extension can only be installed for Blue Prism 6.9 or later.

For more information, see Prerequisites on page 4.

Commercial in Confidence

Page 7 of 30

Blue Prism | Browser Automation Agent for Manifest V3 Extensions Installation

3. Click Yes on the User Account Control (UAC) prompt screen. The installation is complete.

4. Click OK to close the installation wizard.

Install the Browser Automation Agent from the command line

The following command line options can be used to install the Browser Automation Agent and set the registry key for the Chrome and Edge Manifest V3 extensions. The example below assumes the MSI name to be BluePrism.BrowserAutomationAgent.

The availability of the Edge browser extension is dependent upon the version of Blue Prism and the version of the Browser Automation Agent you are using:

? With BAA 2.0, the Edge browser extension can only be installed for Blue Prism 6.8 or later. ? With BAA 1.0, the Edge browser extension can only be installed for Blue Prism 6.9 or later.

For more information, see Prerequisites on page 4.

Command

msiexec /i BluePrism.BrowserAutomationAgent_x64 /qn msiexec /i BluePrism.BrowserAutomationAgent_x86 /qn

msiexec /i BluePrism.BrowserAutomationAgent_x64 ADDLOCAL=BrowserAutomationAgent /qn msiexec /i BluePrism.BrowserAutomationAgent_x86 ADDLOCAL=BrowserAutomationAgent /qn

msiexec /i BluePrism.BrowserAutomationAgent_x64 ADDLOCAL=ChromePlugin /qn msiexec /i BluePrism.BrowserAutomationAgent_x86 ADDLOCAL=ChromePlugin /qn msiexec /i BluePrism.BrowserAutomationAgent_x64 ADDLOCAL=EdgePlugin /qn msiexec /i BluePrism.BrowserAutomationAgent_x86 ADDLOCAL=EdgePlugin /qn

Description

Installs the Browser Automation Agent and sets the MV3 extension registry key.

Installs the Browser Automation Agent without setting the MV3 extension registry key.

Adds the MV3 extension registry key to an existing installation of the Browser Automation Agent.

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 the Blue Prism Automation Agent, plus the Chrome and Edge extensions:

msiexec /i BluePrism.BrowserAutomationAgent_x64 ADDLOCAL=BrowserAutomationAgent,ChromePlugin,EdgePlugin /qn

Commercial in Confidence

Page 8 of 30

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download