How to Commit Changes to TFS/DevOps After Upgrading Docentric AX Models

Azure DevOps is a new name for TFS Online. In this manual we use the term TFS.
If you are UPGRADING the Docentric AX models, please first read the manual How to Upgrade Docentric AX Models.
If you are INSTALLING the Docentric AX models on a clean environment, please see the manual How to Install Docentric AX via Models.

Upgrade installation: Commit changes to TFS

After you replace (upgrade) the Docentric AX models with scripts or manually, the model folders and descriptor files will be automatically updated. New files will be added and old ones removed, except Docentric DLL files in the bin folder of the DocentricAX package, where the old files remain.

When you check-in the upgraded version to TFS, there should be exactly the same files in repository as if you would install and check-in the new version on a clean environment. TFS does not automatically detect and include all upgrade changes for check-in. It requires some manual steps that can be error prone.

If you would like to check-in all the changes of the upgraded Docentric AX models, make sure that all these changes are listed in Team Explorer\Included Changes, before checking-in them to TFS. Updates are included automatically, while deleted files have to be manually promoted from Team Explorer\Excluded Changes > Detected. New files have to be added manually as well (Add Items to Folder). Obsolete Docentric DLLs in DocentricAX\bin folder have to be manually deleted.

Therefore, we recommend taking the following more reliable UPGRADE PROCEDURE.

  1. Stop IIS (or IIS Express) and the Batch service.
  2. Delete all Docentric AX models (i.e. packages) from TFS and CHECK-IN THE CHANGES.

     

    DO NOT delete DocentricAXSSRSReplicas if you customized them, neither any other customization of Docentric AX models you might have.
  3. Delete the Docentric AX package folders from the disk, since these might not be deleted, even if they were deleted on TFS:
    • AOSService\PackagesLocalDirectory\DocentricAX
    • AOSService\PackagesLocalDirectory\DocentricAXExtension
    • AOSService\PackagesLocalDirectory\DocentricAXEmails
    • AOSService\PackagesLocalDirectory\DocentricAXLicensePlateLabels
    • AOSService\PackagesLocalDirectory\DocentricAXSSRSReplicasDO NOT delete if you have customized the replicas directly in this model!
    • AOSService\PackagesLocalDirectory\DocentricAXCBDReplicasDO NOT delete if you have customized the replicas directly in this model!
    DO NOT compile or synchronize the database at this point.
  4. Since we deleted the Docentric AX models, you can manually import the latest version of the models by using ModelUtil.exe (modelutil -import) as it goes for the clean installation.
    Alternatively, you can use the scripts from the downloaded ZIP packagesDocentricAXInstallCoreModels.cmd and DocentricAXInstallSSRSReplicasModel.cmd to import/replace the models.
  5. Add the regular artifacts from Docentric AX models to TFS the same way as a clean installation. Make sure that the correct DLLs from the DocentricAX\bin folder are added to TFS.

         

  6. Check-in the changes and verify on the TFS (Azure DevOps) portal that you really have the right code in place in the repository.

  7. Build the Docentric AX models.
  8. Synchronize the database.
    Alternatively, you can use DocentricAXBuildAndSyncTool.cmd, one of the scripts from the downloaded ZIP packages, to build the models and synchronize the database.
  9. Start IIS (or IIS Express) and the Batch service.
It is of key importance that you DO NOT synchronize the database before the new models are installed and built, and that application is stopped during the upgrade procedure (IIS and the Batch service). Violation of this rule might result in loss of your data!
After completing the above upgrade procedure, to learn more on which Docentric DLL(s) should be versioned in TFS and why, please refer to this how-to manual chapter: After building Docentric AX models >>

See also

How to Add Docentric AX Models to TFS/Azure DevOps >>
How to Upgrade Docentric AX Models >>

IN THIS ARTICLE