Release Notes 8.4

This release has an initial version number of 8.4.11.

If an existing version of Precision Bridge is installed, this version will be installed alongside it.

Users upgrading to 8.4 from versions earlier than 8.0 will need to request a new licence from Precision Bridge.

Listed below are the enhancements included in this release:

List of Enhancements

Support for Deletion of target records based on a query on a source table

Applies to ServiceNow->Database migrations only

This enhancement extends the ability to identify records deleted on the source from the audit delete records generated upon deletion. It is now possible to query any source table to obtain the set of target records that should be deleted. This means that records can be deleted that have been:

• Deleted (query the audit deletions table)
• Archived (query the relevant archive table)
• Closed/made inactive (query the source table)

See this article for more information:

Configuring Target Deletions

2. Support for Attachment Migration into Jira issues or Confluence Articles

This extends support for specific source platforms to allow migration of attachments from any source platform into Jira, JSM or Confluence.

See the current Attachment Support Matrix here:

Attachment Migration Support Matrix

3. Support for Retrieval of embedded images from Salesforce Knowledge Articles

Support for attachment retrieval from Salesforce has been extended to look in mapped html fields for embedded images. If found, these will be added to the target record as an attachment. See the article on Attachment Migration from Salesforce here:

Migrating Attachments from a Salesforce / Remedyforce Instance

4. Support for Replacement of Image tags and link updates when migrating Knowledge from Salesforce to Confluence

Following migration of Salesforce articles into Confluence, including any embedded images (which will be migrated as attachments to the Confluence article) the html in the article body will need to be updated.

The new assignment function JIRA_REPLACE_SF_IMG_TAG can be used to update the html field to repoint image tags to the migrated image attachments in Confluence. This ensures that the images can be correctly viewed inline with the articles. See the article on this function here: Function JIRA_REPLACE_SF_IMG_TAG

5. Improved Migration of Attachments into ServiceNow

The process to migrate attachments into ServiceNow has been improved to:

• Improve overall performance when migrating attachments into ServiceNow. The insert of attachments is now multi-threaded, so multiple connections can be used concurrently. The number of connections that can be used concurrently is configured using the 'Submit Threads' performance tuning option. See this article for more information Performance Tuning in Precision Bridge

• Prevent 'Silent' failures when attachments are inserted. Previously, the actual insert of the attachment was asynchronous, so if ServiceNow rejected the attachment precision Bridge would not report this failure. This is no longer the case, if ServiceNow rejects an attachment (usually due to content or content type restrictions configured in ServiceNow) this failure is reported back in Precision Bridge.

6. Improved handling of Timeouts when retrieving records

If Precision Bridge received an error that is recognised as a Timeout when retrieving data from the source platform, it will reduce the number of records requested before re-trying. This means that timeout errors during retrieval can be overcome dynamically, preventing the execution from terminating early.

New or Updated Templates

The following additional templates were added in this release:

Salesforce->Jira	Cases	Template to migrate Salesforce Cases into JSM Incidents. This includes comments and attachments together with tasks related to the case. Note that there is a manual final step required to import the generated JSON file into Jira in order to set the correct status and created/updated on/by information on the migrated issue.
Salesforce->Jira	Knowledge articles	This template can be used to knowledge articles together with related comments into a Confluence space. There are 2 projects, one to migrate the articles, comments and images (which will be created as attachments) and a second project to update the article body to repoint the image references to the migrated attachments.

Notice of Support Termination

With the release of Precision Bridge 8.4, support was withdrawn for Precision Bridge 7.2 and below. Customers still using these versions are advised to upgrade to a later release as soon as possible.

Currently, supported versions of Precision Bridge are: 8.4, 8.3, 8.2, 8.1, 8.0, 7.4 and 7.3.

Support is planned to be withdrawn from versions 7.4 and 7.3 in December 2025.

Advice To Users Upgrading from Precision Bridge 7.0 or earlier

The Use Server ID's Key Mapping option was removed from Precision Bridge 7.1. If this Key mapping option has been used in a project built with Precision Bridge 7.0 (or earlier), the Key Mapping option will default to 'No Key Mappings' when opened in Precision Bridge 7.1 or later.

Note that none of the Precision Bridge Templates used this option in earlier or current versions of Precision Bridge. If you have projects that use this option, be sure to select an alternative key mapping option to use (such as by selecting Key Field Mappings) before executing the project with Precision Bridge 8.4. Failure to do this may result in duplicate records being created if the project is run a second time to update existing records.

Other than the above, projects built using Precision Bridge 7.0 and above will still work with Precision Bridge 8.4 with no changes required.