BeyondERP.Newsletter
Menu

Job page · Organization administration

Migration cleanup

A page that deletes Electronic reporting format configurations whose templates can't be reached after an environment is moved, so they can be imported again.

Used by
Electronic reporting developer, Electronic reporting functional consultant
Business process
Administer system features
Menu item
ERMigrationCleanup
Main table
ERSolutionTable
Show what matters for
PAGE GUIDEWhat the page does and how to use it7 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA page that deletes Electronic reporting format configurations whose templates can't be reached after an environment is moved, so they can be imported again.
What you do hereUse this page to delete and then re-import ER format configurations whose templates point to storage the current environment can't reach.
ExampleFor example, after a production environment is copied to a new sandbox, ER formats that use templates fail, because the templates are still in the production storage.
Migration cleanup page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processAdminister system features
Menu pathOrganization administration › Periodic › Migration cleanup
Set up firstConfigurations Microsoft Learn
Related pagesBackup storage of ER templates feature Microsoft Learn
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

When to run it

When to run itAfter an environment move, for example production copied to a sandbox, when an ER format can't run or be deleted because its template is missing, and only after deleting it on the Configurations page failed.
How oftenOn demand, only after an environment migration.
What the output showsThe selected ER format configuration removed from the application database, ready to be imported again. A re-import that fails means the template file still exists in Blob storage.

Source: Microsoft Learn

Steps from Microsoft

  1. Go to Organization administration > Periodic > Migration cleanup.
  2. Select the ER format configuration that you can't run or delete because its template can't be reached.
  3. Select Delete and confirm. Only the database records are removed; the job doesn't look for the template file in Blob storage.
  4. Import the deleted ER format configuration into the current environment again.
  5. If the import fails, find the template file in Blob storage, delete it by hand, and import again.

Source: Microsoft Learn

Test checklist

  1. The ER format configuration is gone from the Configurations tree.
  2. The re-imported configuration runs and finds its template.

Source: Microsoft Learn

Solution architect

4Design impact

Can it be undoneNo: The configuration is deleted from the database; the only way back is to import it again. Microsoft prefers the Backup storage of ER templates feature to recover templates. Microsoft Learn
If you change it laterIf the template file still exists in storage, deleting the configuration here removes only the database records, and you can't re-import that configuration until the file is removed. Microsoft Learn
Technical architect

5Technical

Menu itemERMigrationCleanup Checked in Dynamics 365
FormERMigrationCleanup Checked in Dynamics 365
TableERSolutionTableShown as “Configurations” in Record infoChecked in Dynamics 365
Who can open itPrivilegesMaintain configurations ERMaintainSolutionsDutiesConfigure Electronic reporting configuration ERSolutionConfigure
2 security rolesElectronic reporting developer ERDeveloperElectronic reporting functional consultant ERFunctionalConsultant
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itElectronic reporting functional consultant ERFunctionalConsultantElectronic reporting developer ERDeveloperGive people one of these roles. On this system, 2 roles can open this page.Checked in Dynamics 365
Actions on the pageOptionsChecked in Dynamics 365
Developer

6Developer

Open it by URLhttps://<your-environment>/?mi=ERMigrationCleanup
Everyone

7Sources