Blue Prism 7.0.1: November 2021

Database

444

The release requires the Blue Prism database to be this version. This is the first Blue Prism release to use this database version.

Login Agent

7.0.1

The version of Login Agent that is provided with this release of Blue Prism has the same functionality as the version provided with Blue Prism 6.7.

Browser extensions (Chrome, Firefox, and Edge)

7.0.1

See the browser extensions section for the latest versions of each browser that has been verified with this release.

For the latest compatibility information, see the browser compatibility matrix in the Blue Prism online help.

If a previous version of the Edge browser extension has already been manually installed from the Chrome store, this should be manually removed and the new version installed from the Edge store, see the upgrade notices for more details.

Data Gateways engine

1.3

The Data Gateways engine version 1.3 must be installed to use Data Gateways with Blue Prism 7.0.

Download the installer from the Blue Prism Portal via Product > Blue Prism Enterprise > Extras.

Blue Prism API

7.0.1

This release requires the Blue Prism API to be this version to enable the full functionality of the Control Room plugin in Blue Prism Hub 4.5. If you are using the Blue Prism API independently of the Control Room plugin, you can continue to use previous versions of the API, but won't be able to take advantage of the new features and capabilities in this new version.

See Blue Prism API for details of additions and improvements to the API reference and functionality.

Authentication Server

4.5

This  release is compatible with this version of Authentication Server. Authentication Server must be installed as part of the Blue Prism Hub installation (version 4.3 or later) if using the Blue Prism API and/or browser-based Control Room with version 7.0 and later.

See Authentication Server for details on enhancements to the Authentication Server functionality.

Control Room plugin (Blue Prism Hub)

4.5

The Blue Prism API available with this release is compatible with this version of the Control Room plugin.

See the Hub release notes for details of enhancements and fixes to the web-based Control Room.

Known issues

A list of any prominent issues with this release is maintained in the knowledge base – click here for more information.

Important notices

Please review the upgrade notices for more details and before upgrading to this release.

Secure development policy

As part of our secure development policy, Blue Prism products are evaluated against the following security standards:

  • OWASP Top 10 –The security vulnerabilities that pose the most risk to applications development. Further information

  • SANS CWE Top 25 – The most common software security vulnerabilities found throughout the software development industry. Further information

  • Federal Information Processing Standard (FIPS) Publication 140-2 – U.S. government standard that defines minimum security requirements for cryptographic modules in information technology products.

  • Payment Card Industry Data Security Standard (PCI DSS).

  • Health Insurance Portability and Accountability Act (HIPAA).

  • Federal Information Security Management Act (FISMA).

A compliance highlight summary report is available upon request via Product Support.

Blue Prism core components

The following enhancements, fixes, and minor improvements have been added to the Blue Prism core functionality in version 7.0.1:

Enhancements

Description of change

Reference

The following performance improvements to spying execution times have been made to the Java automation functionality in Application Modeller:

  • The time taken to navigate trees in complex applications with a large number of nodes has been significantly reduced.
  • The mechanism used to match Java element types (recognize a specific sequence of characters, tokens, and data) during Java automation has been improved when using Match Index as one of the matching attributes, making the match process much faster.

These enhancements are also included in Blue Prism 6.10.3.

BP-6162 (BP-5518)

BP-6163 (BP-5097)

Fixes and minor improvements

Description of change

Reference

The additional Tesseract third-party prerequisite libraries are now included in the Blue Prism installer. These are required for Optical Character Recognition (OCR) in processes where the Read Text with OCR option is selected for a Region element in a Read action. Previously, in deployments using Blue Prism 6.5 or later, processes using OCR failed and a Tesseract system error displayed, informing the user that the program could not start due to missing DLLs.

BP-5125 (BP-4531)

The setting to run a schedule on the first or last day of the week (by selecting the First or Last option from the On the …working day in calendar drop-down for schedules set to be run weekly) is now correctly saved to the database.

BP-5124 (BP-4708)

Schedules can now be stopped successfully using the Stop option from the schedule's shortcut menu irrespective of the time zone set for the schedule. Previously, this only worked reliably in environments where the user's operating system on which the interactive client was running was configured to use the UTC time zone.

BP-5126 (BP-4806)

An issue has been fixed where schedules with the Use time zone option enabled were marked with an asterisk– indicating that there are unsaved changes on those schedules – even though no changes had been made to the schedules. Users are no longer prompted to discard the incorrectly detected changes to be able to navigate to a different tab.

BP-5151 (BP-4817)

Users are now notified of schedule instances that are skipped if the application server automatically adjusts for daylight savings. Previously, instances scheduled to run during the last hour of the application server’s daylight savings period were suppressed without notifying the users.

BP-6463 (BP-3347)

When Work Queue data is exported as a report, the time displayed in the Queue Management user interface and the exported Work Queue report is now aligned. Previously, the time displayed in the report reflected daylight saving adjustments.

BP-6383 (BP-5576)

On the Queues screen in Control Room, the Last Updated field now accurately reflects the date and time the work queue item was last updated. This fixes an issue introduced in Blue Prism 6.7, where this field was incorrectly populated with the date the queue item was created. In Blue Prism 7.0, the correct value was saved to the database, but the field on the screen was incorrectly left blank.

BP-5506 (BP-4733)

To reduce unnecessary memory usage while running automations, once received from the application server, runtime resources now store a single instance of the compressed process and object XML. Previously, such XML files were stored uncompressed and any previously retrieved versions since the last restart were retained, which caused runtime resources to run out of memory when running large, complex processes.

This is also included in Blue Prism 6.10.3.

BP-6171 (BP-4420)

To enhance performance, the handling of environment variables has been improved so that only a single shared copy of the data is held in memory on a runtime resource per session. Previously, each sub-process or object within a process retrieved and stored its own copy of the environment variables from the database. This fix also prevents unnecessary repeat queries for environment variables in the database each time a process is executed or an object is called from within a process.

Additionally, the error message that displays when data items reference a deleted environment variable in Studio has been improved to make it more informative to users.

This is also included in Blue Prism 6.10.3.

BP-6169 (BP-4501)

BP-6170 (BP-5291)

BP-5596

 

 

When clicking between input parameters in a stage in Studio by clicking the parameter name in the Store In fields, all null or empty text fields are now ignored, therefore preserving the original description. Previously, some descriptions were removed when clicking between input parameters.

BP-6380 (BP-5777)

Previously, session logs were not displayed for users who were not assigned the System Admin role when accessing a SQL database using a schema that was not using the default dbo schema pattern. For example, customschema.IntIdTableType was used instead of dbo.IntIdTableType. This has now been fixed by updating the database query to not take into account the default dbo schema pattern so session logs are now accessible regardless of the schema pattern used.

BP-6379 (BP-5936)

When starting a runtime resource via the /invisible command line parameter, right-clicking the runtime resource icon in the system tray on the taskbar and then clicking Exit now closes the window. Previously, multiple clicks were required to close the window.

BP-6378 (BP-5779)

An issue has been fixed for Web APIs that use the OAuth 2.0 (Client Credentials) authentication type, where the client id and client secret were not URL encoded before being sent as part of the access token request. Previously, this issue prevented an access token from being issued from the OAuth 2.0 Authentication Server.

The fix maintains backwards compatibility for any customers that had performed a workaround where they had encoded the client id and client secret themselves before storing them as credentials.

BP-6258 (BP-6155)

Business objects exposed as web services can now be authenticated via the username in common name format. Previously, the username had to be in UPN (User Principal Name) format.

BP-6118 (BP-5203)

An issue has been fixed where user roles were incorrectly deleted when the dialog containing the warning message about deleting user roles on the User Roles screen was closed, instead of only when accepted by clicking Yes in the dialog.

BP-6116 (BP-5983)

Debugging an object that reads from, or writes to an empty collection no longer incorrectly returns validation errors. Previously, running such objects in Process Studio or Object Studio incorrectly resulted in validation errors.

BP-5507 (BP-1440)

To minimize unnecessary logging on users' systems and thus improve performance, the default NLog logging severity has been reduced for several browser automation and Citrix-related functions The previous logging levels of the updated logs can still be viewed by changing the logging level or adding new NLog rules in the Automate.nlog.config file. For more details, see Troubleshooting - Logging.

Additionally, the NLog logging level severity has been reduced for various log points in ASCR when using the WCF channel. For more details, see ASCR logging.

BP-6553

BP-5441 (BP-4960)

The Show filter which determines the number of session logs displayed in Control Room now displays as expected. This was incorrectly not displayed in version 7.0.

BP-6692

Browser extensions

Browser extensions allow Blue Prism to interact with web pages and applications presented in a browser, so that business processes that include such applications and web pages can easily be modeled.

Browser extension versions

The table below shows when each Blue Prism extension, compatible with this release was introduced and the browser version against which they were evaluated. See browser extension release notes for details of key capabilities and the browser compatibility matrix for the latest browser versions evaluated.

Browser Blue Prism extension versions Date available

Chrome

7.0.1

25 November 2021

Edge Chromium

7.0.1

25 November 2021

Firefox

7.0.1

25 November 2021

The browser extension versions above were evaluated against the latest browser version available when preparing the extension for release.

Browser extension release notes

Browser extension 7.0.1

Description of change Reference

When attempting to attach to a previously launched browser by using a window title, capitalization is now ignored. Previously, the Attach action failed when the window title did not exactly match the value specified, for example ‘google’ instead of ‘Google’.

BP- 5127 (BP-4773)

The Edge browser extension is now fully installed if selected on the Advanced install screen during Blue Prism installation. Previously, it was necessary to enable the extension separately in the Edge browser once the Blue Prism installation had completed.

This is also included in Blue Prism 6.10.3.

BP-6135 (BP-5493)

Previously, when attempting to launch a browser immediately after closing it, either in Studio or when running an automation, a browser extension appeared unavailable. This was due to the browser being closed not exiting correctly. This has been resolved by automatically checking if all browser instances have closed every 200 milliseconds for up to 2 minutes when terminating the browser. If the browser does not successfully close, an error message warns the user to ensure all browsers with the Blue Prism browser extension installed are closed before continuing. This message has been previously incorrectly translated in Chinese and has now been fixed.

This is also included in Blue Prism 6.10.3.

Additionally, a mechanism has been added to allow a short pause between a Terminate action and a Launch action, which allows the browser to remove any spawned processes before attempting to launch. The pause has been set to 1000 milliseconds by default and can be configured in the Automate.config file:

<add key="BrowserAutomation.BrowserTerminationMinimumPauseBeforeLaunch" value ="1000"/>

This behavior applies only when the browser is closed via a Terminate action, and not via any other mechanisms, such as PowerShell scripts.

BP-6136 (BP-4912)

BP-6456 (BP-6376)

BP-6610

BP-6865 (LOC-622)

A fix has been applied to ensure that, when entering data into web components in a Chrome, Edge, or Firefox browser, the necessary underlying input event is triggered and the native value setters are used to ensure the event works as expected. The behavior in the application should now be the same both when the web component is worked by a digital worker or by a human using a keyboard and mouse, even in situations where the developers of the web components have programmatically overridden the event.

This is also included in Blue Prism 6.10.3.

BP-6137 (BP-310)

When using Application Modeller to attach to web pages in a Chrome, Edge, or Firefox browser, users no longer need to manually append a wildcard to window titles of target pages taken from a collection. This functionality is now consistent with the window title parameter in stage properties where the wildcard is automatically inferred.

This is also included in Blue Prism 6.10.3.

BP-6138 (BP-5575)

Closures of browser sessions launched from multiple instances of Blue Prism are now correctly detected by the Blue Prism instance which launched the browser session. Previously, when one of browser sessions was closed, the Detach button for that session remained enabled in Application Modeller even after if it was clicked by a user, and the closure of that session was only detected once all browser sessions were closed.

This is also included in Blue Prism 6.10.3.

BP-6770 (BP-6053)

When automating web pages in an Edge browser, if an element did not exist, an error message incorrectly indicated that more than one matching web element was found. The error occurred in the Application Modeller when using the XPath and CSS Selector web attributes which returned at least one empty element. The correct error message now displays.

BP-6382 (BP-5733)

Previously, when automating a web page in an Edge browser, if the Verify action in a Navigate stage had the Highlight parameter set to True, the highlighting box would not disappear from the web page after running the automation. This has now been fixed.

BP-6377 (BP-5787)

An issue has been fixed where, when attempting to launch or attach to a Chrome, Firefox, or Edge browser instance which was previously launched externally and not via Blue Prism, the externally launched browser session of the same type was not reliably detected.

BP-6772

An intermittent issue has been fixed where, when launching or attaching to a Chrome, Firefox, or Edge browser and using a tracking ID to restrict spying to a specific browser instance immediately after, the spying via tracking ID may fail due to a race condition.

BP-6778

Additional components

With Version 7 we have introduced some optional components that provide the base for extending Blue Prism.

Blue Prism API

The Blue Prism API provides a common interface for components such as Blue Prism Hub to connect with the Blue Prism database. It also provides a series of predefined capabilities that can be used by external solutions to programmatically interact with Blue Prism via a RESTful API

The following enhancements, minor improvements and/or fixes have been made to the Blue Prism API for this release. The API reference, installation guide, license agreement, and the Blue Prism API user permissions for the Control Room plugin can be found here.

Endpoint

Description of change

Reference

/schedules/logs

/schedules/{scheduleId}/logs

A permission check has been added to these endpoints so users with restricted schedule permissions can no longer access the Schedule Activity logs in the browser-based Control Room.

BP-5942

/workqueues

/workqueues/{workQueueId}

/workqueues/items/{workQueueItemId}

/workqueues/{workQueueId}/items

A permission check has been added to these endpoints to grant read-only access to work queues and work queue items in the browser-based Control Room for users who do not have edit permission for work queues and work queue items in the Blue Prism interactive client.

BP-5591

BP-6322

BP-6646

/schedules

  • /schedules/tasks/{taskId}/sessions
  • /schedules/{scheduleId}/tasks
  • A permission check has been added to these endpoints to restrict access to Schedules and Tasks in the browser-based Control Room.

    BP-6255

    /schedules/{scheduleId}/sessions

  • /schedules/{scheduleId}
  • A permission check has been added to these endpoints to restrict access to schedule records in the browser-based Control Room.

    BP-6319

    /sessions/{sessionId}/logs

    The System Manager permission Audit - Business Object Logs has been removed from this endpoint.

    BP-6348

    /sessions

    /sessions/{sessionId}

    /sessions/{sessionId}/logs

    /sessions/{sessionId}/logs/{logId}/parameters

    The System Manager permission View Resource Details has been removed from these endpoints.

    BP-6323

    BP-6671

    /schedules/{scheduleId}

    A Create Schedule permission check has been added for this endpoint when unretiring schedules via the API. Previously, the check was only performed for the Retire Schedule and Edit Schedule permissions.

    BP-6689

    /sessions/{sessionId}/logs/parameters

    An Audit - Process Logs permission check has been added for this endpoint to restrict access to session log parameters.

    BP-6357

    N/A

    An issue has been fixed where role permissions assigned via the Blue Prism API were not updated after restarting the API service.

    BP-6465 (BP-5589)

    Authentication Server

    Authentication Server provides centralized, common authentication for users across three key components of the Blue Prism platform: Blue Prism Enterprise, the Blue Prism API, and Blue Prism Hub. The following enhancements, minor improvements and/or fixes have been made to the Authentication Server configuration in the Blue Prism interactive client.

    Description of change

    Reference

    A message now displays on the Server configuration screen when establishing a connection to the RabbitMQ message bus is taking longer than expected and is being attempted again. This is also recorded in the server logs.

    BP-6164 (BP-4402)

    An issue has been fixed where changes to the broker password in the Authentication Server Integration tab on the Server Configuration Details screen would persist even after the user had clicked Cancel to discard the changes.

    BP-6123 (BP-4670)

    An error no longer occurs when attempting to configure process alerts for Authentication Server users via the shortcut menu on the Security - Users screen in the Blue Prism interactive client.

    BP-6122 (BP-4673)

    When a Blue Prism user is mapped to the Authentication Server database, basic Hub permissions are now granted to the user so they have access to the Dashboard and Profile settings pages when they log into Hub for the first time.

    BP-6120 (BP-4810)

    Blue Prism native user accounts that have been mapped to Authentication Server accounts via the mapping tool are now set to never expire in the Blue Prism database, because these accounts and their expiry dates are now managed in Authentication Server.

    BP-6127 (BP-3517)

    When the Blue Prism Server service is started, if the broker settings have been configured, it attempts to connect to the RabbitMQ Message Broker server. The connection configuration has been updated so that if the Blue Prism Server service stops or is terminated, the connection to RabbitMQ is closed. Previously the connection remained active, which meant user synchronization may unexpectedly continue.

    BP-6117 (BP-5639)

    When the Blue Prism Server service is started, it attempts to connect to the RabbitMQ Message Broker server. It will continue to try to establish the connection for 24 hours; after which the attempts will timeout so it will be necessary to restart the Blue Prism Server in order for it to retry to establish the connection. Previously, if a connection to RabbitMQ is not successful, a connection would continue to be attempted for up to 24 hours even if the Blue Prism Server service was stopped before a connection had been achieved.

    BP-6119 (BP-4977)

    Credentials used for the RabbitMQ Message Broker when installing Hub can now contain restricted special characters, such as URL encoded characters.

    BP-6124 (BP-4577)

    The validity period of authorization codes and access tokens in the Automate client in Authentication Server has been correctly set to 5 and 15 seconds respectively to ensure tokens are not active longer than they are required.

    BP-6229 (BP-6056)