Skip to content

Version: v241115.1 Release Date: 15th November, 2024

Summary

This release includes two new record types - BRN and BRD.

Changelog

Code tags

Upgrade steps from previous version (version v241107.1)

Please update, copied from previous notes

The following are deployment steps that are required to upgrade the solution from the previous version. These steps must be followed. Do not complete any manual steps until any outstanding manual steps from previous version(s) have been executed

Manual pre-deployment steps

none

Deployment steps

  1. Deploy Release-22 for Deploy Config Tables release pipeline in Azure DevOps to the target environment.
  2. Deploy Release-10 for Deploy Server release pipeline in Azure DevOps to the target environment.
  3. Deploy Release-11 for Deploy Client release pipeline in Azure DevOps to the target environment.

Manual post-deployment steps

Importing Terms to the SharePoint Term Store

Prerequisites

- ABC Site collection Administrator account

- Ensure PowerShell 7.2 or later is installed

- PnP PowerShell 1.10.2 or later is installed

- App registration for PnP PowerShell https://pnp.github.io/powershell/articles/registerapplication.html

Command to run

To import terms, use the following PowerShell command:

```

Connect-PnPOnline -Url "[ABC Site url]" -ApplicationId "[PnP Appliction ID]" -Interactive

Invoke-PnPSiteTemplate -Path "[path to Terms.xml]"

```

  • Go to Document Templates library in SharePoint
  • Associate templates to the right Record Types based on the file: DocTemplates.csv
  • Create missing templates or copy from another environment

Content types creation

  1. Start SharePoint content type creation: Make GET request to "https://[ABC Backend base url]/api/StartSharePointContentTypesUpdating?key=[key from app settings]" endpoint of API app. You will need to include Authorization header. Example:

bash curl 'https://afa-dev-r1-abc-01.azurewebsites.net/api/StartSharePointContentTypesUpdating?key=SharePointContentTypesUpdatingKey' \ -H 'accept: */*' \ -H 'authorization: Bearer [berear token value]'

  1. To extract authorization header value from ABC app, open ABC application in browser and log into the application using ABC Admin account
  2. Open DevTools in browser (F12 button)
  3. Open 'Network' tab in DevTools, set '/api/' value in 'Filter' input
  4. Refresh the home page (F5 hotkey)
  5. In the list of requests, select any with 'fetch' value in 'type' column
  6. In 'Request Headers' section, find 'Authorization' header and copy it's value prefix
  7. Use this value for 'authorization' header in GET request to the endpoint.
  8. Wait for 20 minutes for the content types to be created.
  9. Check Log field in the RecordFields table for any errors. If there are any errors, please resolve them before proceeding. After resolving the errors, re-run the above API call.
  10. Check SharePoint content types and fields if they have been created successfully.

Change AADGroupName in the RoleAssignments table

  • Go to Azure portal
  • Open environment resource group, find Storage account, open Storage Browser - Tables
  • Open 'Role Assignments' table
  • Sort based on the AADGroupNames column
  • In all rows where you see "AZ-AUTO-DEV-ABC-Users" replace it with related environment group.

Rollback steps to previous version

  1. Run Deploy Config Tables release pipeline for the previous version in Azure DevOps.
  2. Run Deploy Server release pipeline for the previous version in Azure DevOps.
  3. Run Deploy Client release pipeline for the previous version in Azure DevOps.

Known Issues / Adjustments to be made

ID Title Assigned To State Area Path Tags Comments
53849 Change step names and descriptions Jeremy Stokes Active VIC DoE - ABC Correspondence 6
53700 Update field names and screen tips in Steps 1-2 Ivan Shaveko New VIC DoE - ABC Correspondence 1