Skip to content

Version: v251212 (BC 2.3.6)

Summary

This release contains the following items:

ID Title
663576 (REQ-071) Due dates between stages in Activity log UI
664477 PPQ 'Updates' field - new configuration requirement
662877 (REQ-017) Anonymous field for Correspondence records
665757 Appointment configuration - LGIC
665755 Appointment configuration - MINAP
665754 Appointment configuration - CGAP
665753 Appointment configuration - GICAP
665752 Appointment configuration - CABAP
665751 Appointment configuration - REQAP
665705 Correspondence configuration - CMIN
665707 Correspondence configuration - CSEC
665708 Correspondence configuration - CORG

Package version: 2.3.6

Manual pre-deployment steps

Review/update release pipeline variables

It's important to apply any changes for all environments to pipeline variables before a release created, because every release creates a snapshot of pipeline variables on the moment of creation, and the only way to re-deploy the application with updated variables - creating a new release

  1. Go to Azure DevOps, open Brief Connect project
  2. In left panel navigation go to Pipelines - Library - Variable groups
  3. Review variables for all environments and update where required (outdated values, recent environment changes, requests from business, etc).
  4. Save the changes
Create new Brief Connect Application release (click to expand) 1. Go to Azure DevOps, open Brief Connect project, go to **Pipelines - Releases** page 1. Find **Deploy Brief Connect Application** release pipeline, click on it to open 1. Click on **Create Release** button on the right 1. Specify the **Package Version** variable with value from **Package version** section above. For example `2.3.1`. 1. Add a description (it's optional). 1. Click on **Create** button 1. Release with version `v[Package Version] (0)` will be created and will be available in the list of releases, after you refresh the page. ![image.png](/.attachments/new-application-release.png)

Pipeline deployment steps (in order)

  1. Deploy release Release 21 for Deploy BC - Office Resources release pipeline in Azure DevOps to the target environment.
  2. Deploy release v[Package Version] (n) (where (n) is latest number available, and Package version from the section above) for Deploy Brief Connect Application release pipeline in Azure DevOps to the target environment.

Manual post-deployment steps

Import config

Config file to import: DFFH Configuration v251211-config.zip

Role required: Brief Connect Administrator

If there is no configuration set, you have to set up Administrator user Id in the Environment variable AdminEntraId in the Azure Function App. The value should be the Object Id of the user in Entra ID (Azure AD).

  1. Log into the target Brief Connect environment as the Brief Connect Admin user and open the Admin Panel (https://[WEB_APP_URL]/#/adminPanel).
  2. Select Import from Zip and upload the new configuration ZIP file.
  3. The system will process the file and refresh the list of available configurations. Once it appears, select the newly imported configuration from the dropdown.
  4. Click Apply to apply the imported configuration.
  5. Wait for the confirmation message that the configuration has been successfully applied.
  6. Make sure the active configuration is selected in the dropdown.
  7. In the menu bar, click Update SharePoint Content Types.
  8. Tick Clean up unused fields from content type. It won't remove any data, only detach unused fields from Content Types, then click Confirm.
  9. Wait 20 minutes for the process to finish.
  10. Click Cleanup Unused Fields from SP Lists, then Confirm in the confirmation dialog. This process will cleanup unused fields from lists (fields provisioned with old configs and removed in later configs).
  11. Wait for 10 minutes for the process to complete.

Update Terms for record types in DEV/TEST

  1. Navigate to the Term Store management tool, replacing XXXX with 'NonProd' and 'Test' for DEV and TEST respectively: https://dhhsvicgovau.sharepoint.com/sites/BriefConnect-XXXX/_layouts/15/termstoremanager.aspx
  2. In the Site Collection drop down, find the 'Record Type' dropdown
  3. Delete the old entries for Briefing subtypes: Ministerial Briefing (BMIN) / Secretarial Briefing (BSEC) / Organisational Briefing (BORG)
  4. Delete the 'Request type Correspondence' term set

Clear the Server cache

Role required: Brief Connect Administrator

  1. Log into the target Brief Connect environment as Brief Connect Admin user. Open the Admin Panel (https://[WEB_APP_URL]/#/adminPanel)
  2. Open browsers Developer Tools, open Console tab and run the command window.clearCache() there. After successful execution, you should see Cache cleared. Server Result: true message in the console.

Smoke Tests

We recommend following our basic testing guide after this release: Basic testing of Brief Connect - Brief Connect Documentation

  • Confirm there is a new field 'Updates' that has been added to the PPQ record subtype
  • Confirm Due Dates are now visible between stages in the Activity Log UI
  • Confirm ability to create CORRESPONDENCE record types - CMIN / CSEC / CORG
  • Confirm ability to create APPOINTMENT record types - REQAP / CABAP / GICAP / CGAP / MINAP / LGIC
  • Confirm record initiation working for CORRESPONDENCE record types - CMIN / CSEC / CORG
  • Confirm record initiation working for APPOINTMENT record types - REQAP / CABAP / GICAP / CGAP / MINAP / LGIC

Rollback steps to previous version

Execute all deployment steps for the target release from related Release Notes.