Install the Blue Prism components

Downloading and installing any of the SS&C | Blue Prism® Enterprise components, including by silent installation via command line, means that you accept the End User License Terms.

Blue Prism installer

A Service Assist installation requires the following Blue Prism components:

  • A Blue Prism application server for scheduling and managing digital workers.

  • At least one digital worker to poll the TrustPortal agent and execute the requested tasks.

For instructions on how to install Blue Prism, please see the installation guide for the Blue Prism version you require in the Blue Prism online help.

TrustPortal-specific Blue Prism release

A TrustPortal-specific Blue Prism release file is available for download from the Admin > Resources > Installers area of the TrustPortal web browser interface once TrustPortal has been installed and you have access to the web admin user interface. Importing this release makes the following business objects available:

  • Interactive Forms – Allows users to develop dynamic and static content within Service Assist.
  • StringRelay – A test for the Blue Prism processes to ensure the strings passed into the processes are the same strings being passed out.
  • TrustPortalEvents – The exposed business object that the TrustPortal agent connects to in order to add work requests into Blue Prism queues.

The release file also includes some example processes.

To import the release file into Blue Prism:

  1. Log into your Blue Prism application using a Blue Prism server connection.
  2. In the File tab, click Import and select Release/Skill.
  3. Browse to the downloaded release file and complete the import wizard.

    Once imported, all business objects display in a TrustPortal folder.

Blue Prism Visual Business Objects (VBOs)

The following Blue Prism VBOs should be available within the TrustPortal-specific Blue Prism release. These can also be imported from the Blue Prism install location C:\Program Files\Blue Prism Limited\Blue Prism Automate\VBO:

  • Utility – Collection Manipulation

  • Utility – HTTP

  • Utility – JSON

Environment variables

Environment variables in Blue Prism are used to store any process or application information required to work the business process that may be subject to change either between environments (development/test/production) or over time. These can be set in the Blue Prism interactive client under Settings > Processes – Environment Variables.

The following environment variables are automatically configured for the Service Assist installation when importing the TrustPortal-specific Blue Prism release file:

  • Robot ID – The internal user account used by the TrustPortal Agent for interim communication with the TrustPortal API. It should not normally be changed, and no data is stored in this user account.
  • Robot Key – The password for the Robot ID account, and would not normally be changed unless under the direction of TrustPortal support.
  • TrustPortal Agent URL – The TrustPortal Agent URL that digital workers will use to poll/push updates from/to TrustPortal. The format is http://<url>:31999/trustportal, where <url> is a DNS address for the TrustPortal agent that is hosted on another device/server, or localhost if the TrustPortal agent is installed locally. One TrustPortal agent can typically support between 50 and 100 digital workers. If multiple TrustPortal agents are needed for resilience or scaling beyond 100 digital workers, then a load balancer is required, however this is outside of the scope of this installation guide and would involve assistance from TrustPortal professional services.
  • Use Agent Polling – Determines whether the TrustPortal Agent automatically polls for work from the TrustPortal API and pushes work to a digital worker via a web service call. This approach has been deprecated, and this variable kept purely for legacy reasons, hence this value should always be set to False.

    A screenshot of a cell phone

Description automatically generated