How to Install Docentric AX via Models
A preferred way to install Docentric AX reporting solution in a D365FO development environment is by importing Docentric AX model files. This deployment strategy doesn’t only gives you access to the product’s X++ source code but more importantly, a clean way of creating a single Deployment Package containing all packages and models that need to be deployed to a staging or production environment of your client. In other words, Docentric AX models and all other developed and customized models are merged into a single Deployment Package.
In order to install Docentric AX solution on a D365FO system you need to obtain two model files:
- Docentric AX model file (e.g. Docentric AX.axmodel)
- Docentric AX Extension model file (e.g. Docentric AX Extension.axmodel)
Note that these two models contain complete Docentric AX solution and there are no external dependencies or services to configure or install. After Docentric AX model files have been properly applied on a D365FO system, Docentric AX solution becomes fully functional.
Installing Docentric AX
Follow the steps below to complete the installation.
1. Import the two model files using the »ModelUtil.exe« tool.
This tool is located in the Packages Bin folder (typically, C:\Packages\Bin or C:\AosService\PackagesLocalDirectory\Bin). Run Command Prompt as Administrator and navigate to the Bin directory of your Packages folder. Execute the command for importing the two Docentric AX models:
ModelUtil.exe -import -metadatastorepath=[path of the metadata store where model should be imported]
-file=[full path of the file to import]
ModelUtil.exe -import -metadatastorepath="C:\AOSService\PackagesLocalDirectory" -file="C:\Temp\DocentricAX\Docentric AX.axmodel"
ModelUtil.exe -import -metadatastorepath="C:\AOSService\PackagesLocalDirectory" -file="C:\Temp\DocentricAX\Docentric AX Extension.axmodel"
2. Build the imported models.
In Visual Studio select the »Dynamics 365 -> Build Models…« menu. In the Model Build dialog select the newly imported Docentric AX and Docentric AX Extension model packages and press the Build button.
3. Synchronize the database.
In Visual Studio click the »Dynamics 365 -> Synchronize Database…« menu item and press the Synchronize button in the shown dialog.
Docentric AX is now installed and fully functional. Note that you still need to apply a license in order to unlock the product, unless you are using Docentric AX Free Edition.