Skip to content

Brief Connect v2.5.7 Release Notes

Release date - 1 June, 2026

Package version: 2.5.7-rc.2

This patch release includes migration engine updates and hot-fixes with a primary focus on Azure DocumentDB migration performance and migration reliability.

Changes and improvements

Azure DocumentDB migration performance improvements

Migration performance has been improved for environments using Azure DocumentDB as the primary operational database.

  • Migration paging and batching behaviour is improved for large-table migrations to increase throughput.
  • SQL replica batch insert behaviour is improved as part of migration performance tuning.

Bug fixes

  • Fixed an issue where the Open Records dashboard could not show records accessible through Entra ID group permissions.

  • Fixed an issue where Managed Metadata column refiners would display as JSON strings incorrectly

Upgrade instructions (from v2.5.6)

The following instructions apply to environments already running Brief Connect v2.5.6.

Note

If you are upgrading from a version earlier than v2.5.6, contact the Brief Connect team for release-specific pre-deployment steps.

Manual pre-deployment steps

Review release pipeline variables

Apply any pipeline variable changes before creating the release. Azure DevOps snapshots variable values at release creation time.

  1. Go to Azure DevOps and open your Brief Connect project.
  2. In the left navigation, go to Pipelines -> Library -> Variable groups.
  3. Review variables for the target environments and update values where required.
  4. Save changes.

Create a new release

  1. In Azure DevOps, go to Pipelines -> Releases.
  2. Open the Deploy Brief Connect Application release pipeline.
  3. If there is no release for 2.5.7-rc.2, click Create Release.
  4. Set the Package Version variable to 2.5.7-rc.2.
  5. Add a description (optional).
  6. Click Create.

Pipeline deployment steps

  1. Deploy release v2.5.7-rc.2 (n) (where (n) is the latest release number) from the Deploy Brief Connect Application release pipeline to the target environment.

Manual post-deployment steps

N/A

Smoke tests

Follow the baseline test guide after deployment: Basic testing of Brief Connect

Release-specific tests for v2.5.7

  1. Run a representative migration in an environment using Azure DocumentDB.
  2. Confirm migration duration is improved compared with your previous baseline.
  3. Confirm migrated records and documents are complete and accessible.
  4. Confirm Dashboard filters don't return JSON as possible refiner items for Managed Metadata columns
  5. Confirm Dashboard filters aren't duplicated
  6. Confirm that users who only inherit access to a record via group/AAD assignment can view that record on the Open Records Dashboard tab