Service Assist 2022.1: July 2022

Blue Prism |
6.8 |
This release of Service Assist is only compatible with this version of Blue Prism. |
TrustPortal |
2.1 |
This release of Service Assist is only compatible with this version of TrustPortal. |
Known issues
A list of any prominent issues with this release is maintained in the Blue Prism knowledge base – click here for more information.
Important notices
- A valid Service Assist license file is required to activate the software. This will be provided by Blue Prism prior to installation based on purchase of licenses.
- Internet Explorer 11 is no longer supported in this version of Service Assist.
For more details, see Upgrade notices.
Blue Prism release notes
The release notes for the compatible Blue Prism versions are available here. Select the help system for the required Blue Prism version and then select the Release notes tile.
TrustPortal release notes
Feature summary
This release has focused on the following areas:
- Enhanced flexibility to improve the user journey by displaying multiple forms in one overall page, which reduces advisors' time and increases their productivity.
-
Ability to enhance and adapt to the user journey across IVR, advisor chat, chatbot, voice recognition, and web self-service.
-
Simplified handover from digital workers to human advisors (for example, chatbot passing conversation tasks to advisors with full context and pre-fetch of information and tools to help.
-
Enhanced, resilient inter-process communication (IPC) queuing allowing multiple technologies to seamlessly integrate.
-
Enhanced embedding of all Service Assist capabilities in other systems (for example, CRM, ERP), with improved theming and bi-directional data exchange.
-
The TrustPortal User Management (TPUM) module is now part of the main product allowing administrators to associate virtual roles with tiles, forms, pages, and menu items, and then assign the roles directly to users.
-
Pre-built examples to significantly speed up the delivery of sophisticated customer-advisor scenarios.
Enhancements and fixes

Description of change |
---|
The TrustPortal services installation is now done via a YAML configuration file. For more information and assistance with the Service Assist installation, contact your Blue Prism account manager. |

Description of change |
---|
The following improvements have been made to the themes and application configuration:
|
A new Tags tab allows administrators to define tags for tiles, actions, and queue items that start a dynamic process. Multiple tags can be associated with an object. The main use for tags in this release is enhanced queue management, specifically for inter-process communication (IPC) queues. For example, an IPC queue item can be created with multiple tags and these tags can be used to search for queue items. For more details, see Tags. |
A new Access Tokens tab allows administrators to define the settings for DirectURLs such as, type, theme, URL, and expiration. For more details, see Direct URL. |
A new Queues tab allows administrators to define the queue settings before adding queue items. The queue settings now have to be defined before a queue can have items sent to it or pulled from it. Queues can still be dynamically created via the Create Queue Payload and Send Queue actions in the Queues VBO. Additionally, a queue is automatically created if a queue item is created and the associated queue doesn't already exist. In all the methods, the queue has a name defined, and a Maximum Attempts setting which defaults to 1 if not defined. This is the number of times a queue item is re-queued for processing after it is selected for processing but fails to complete. After the maximum number of attempts set has been reached without the queue item being successfully completed then the status of the queue item is set to 'exception' via the Queue Items VBO. Queue items can now be better monitored via the Queue Items screen in the admin user interface. They can be filtered by status, type, and tag. For more details, see Queues. |
A new Virtual Roles tab allows administrators to associate virtual roles to tiles, forms, pages, and menu items, and then assign the roles directly to users. Additionally, a new Bulk Upload tab allows administrators to add, edit, or remove users and roles to/from the application in bulk via a CSV template. For more details, see User roles. |
A new Sessions tab under the Agents tab makes it easier to associate digital workers to the TrustPortal agent to which they are connected. |
A new Sessions tab under the Users tab allows administrators to view users' login status. |
To reduce the size of the installer, documentation is no longer included in the Resources > Documentation section of the admin interface. |

Description of change |
---|
Pages
|
Forms
|
Fields
|
Field sets
|
Buttons
|
Tiles
|
Menu items
|
Actions
|
Tables
|
Queues
|
Files
|

Description of change |
---|
The following improvements have been made to the user management functionality:
|

The structure of the Service Assist VBOs in Object Studio has been updated to make the use of the VBOs more consistent across the application. The JSON input parameter has been updated to Form Fields JSON in all VBOs. This is to differentiate between JSON used to describe fields in a form from JSON used to describe other functionality, such as drop-downs. For details on all VBOs used in Service Assist, see VBOs overview.
VBO |
Description of change |
---|---|
Pages |
A new Pages VBO allows users to create pages (TpPage) via the Create Page Payload and Send Page actions, and by setting the parameters Row Height, Gutter Width and Maximum Width of a column in pixels. A page is defined as a collection that is sent to the Pages VBO. The collection defines:
|
Form Controls |
The following changes have been made to the Form Controls VBO:
|
Files |
To show a file as an attachment, the file first must be created using the Create File Payload and Send File actions. This will return the resulting file ID that can be used with the Attachment action of the Form Controls VBO. |
Access Tokens |
Two new actions, Create Access Token Payload and Send Access Token, have been added to the Access Tokens VBO used for creating Direct URLs. Users can define attributes such as the ID of the object the DirectURL is pointing to, how many days the DirectURL should be valid for, the theme used to display the DirectURL and other parameters defining how to submit a queue item so the page or form is dynamically created and displayed. |
Forms –Actions Forms – Action Details |
The action Create Action Payload, has been added to the Actions VBO, and the action Create Action Details Payload has been added to the Action Details VBO. |
Queue Items |
The following updates have been made to the Queue Items VBO:
|
Utility – TrustPortal – Environment |
This new VBO can be used to retrieve lists of objects' metadata from the TrustPortal database by using the Get Schema Objects by Conditions action. |

Description of change |
---|
The following new features are available with Direct URL functionality:
|
All Direct URL forms, pages, or tiles must be created using the [email protected] user (id 4). Any previously created Direct URL access tokens using different users (for example, application_user) must be recreated to work as expected. The config.json file must be updated as shown below, and the dockers must be restarted once this has been done: Copy
|
Administrators can define the settings for Direct URLs such as, type, theme, URL, expiration, via a new Access Tokens tab in the admin user interface. Any access tokens created incorrectly via the VBO (using the incorrect user) will be set as 'revoked' in the admin user interface. See Access tokens for more details. |

Description of change |
---|
The TrustPortal Agent Registration utility has been removed due its limited functionality and increased size of the software download. TrustPortal Agent(s) must be registered using the TrustPortalAgent.exe setup --registerAgent –u <TP URL> -t <token> command. |
Entering http://<tp agent url>:31999/status in a browser now displays detailed information about the TrustPortal environment to which the TrustPortal Agent is connected. |
The TrustPortal Agent log files now display messages down to millisecond precision. |

Description of change |
---|
Significant improvements have been made to the queue item maintenance by using an enhanced jobs setting in the API config.json file, which enables more granular cleanup of redundant queue items, or re-queuing of unprocessed queue items. |
The TrustPortal API server now provides the ability to rotate logs by using the logs settings in the config.json file. For more details, see https://www.npmjs.com/package/winston-daily-rotate-file |
The TrustPortal API config.json now handles now displays more meaningful error messages to the users when invalid parameters are entered. |
The only area in which TrustPortal still supports direct API access (not through VBOs) is in the creation of queue items. For example, to send work items from digital channels such as ICR or chatbots. |
Timeout error messages no longer display when a user clicks an unresponsive button, and a spinning wheel now displays indefinitely until:
|