Skip to content

Resolve record provisioning and migration health issues

Use this guide when Admin Health reports record provisioning, SharePoint library, record counter, or migration health issues after deployment or upgrade.

Check Admin Health

  1. Open the Brief Connect Admin Panel.
  2. Open Admin Health.
  3. Review each failed check.
  4. Record the check name, affected record type, affected record ID, and error message.

Resolve SharePoint provisioning issues

  1. Check whether the affected SharePoint document library exists.
  2. Confirm the library name matches the current record type library allocation model, such as TYPE-0001.
  3. Confirm the Brief Connect application identity has access to the SharePoint site and library.
  4. Use the SharePoint provisioning retry action in Admin Health if it is available.
  5. Re-run the health check.

Resolve record counter issues

  1. Open Admin Health and review record counter failures.
  2. Confirm the affected record type has a configured prefix.
  3. Confirm new record IDs follow the expected PREFIX-YYMM##### format.
  4. Escalate to the Brief Connect team if counters are missing, duplicated, or lower than existing record IDs.

Resolve SharePoint library health issues

  1. Review the affected record type and library in Admin Health.
  2. Confirm the library has not exceeded the supported record allocation for that library.
  3. Confirm new records are assigned to an available library for the record type.
  4. Escalate to the Brief Connect team if the library allocation is missing or incorrect.

Resolve migration health issues

  1. Confirm the target operational data store is MongoDB Atlas or Azure DocumentDB.
  2. Confirm legacy Azure Table Storage operational data, SharePoint Search-backed operational data, and old Cosmos DB paths are not configured for current operational data.
  3. Review migration logs in the deployment pipeline and application logs.
  4. Re-run the relevant migration or retry action only after the cause of the failure is understood.
  5. Re-run Admin Health after the migration completes.

When to escalate

Escalate to the Brief Connect team if:

  • A migration has partially completed.
  • Record counters do not align with existing record IDs.
  • A SharePoint library allocation is missing or points to the wrong library.
  • New records cannot be created after retrying provisioning.