How to Install Docentric AX Framework via Model

The goal of this tutorial is to guide you through the installation of Docentric AX Framework via model.

Current version of Docentric AX Framework supports AX 2012 R2 and R3 versions.

Docentric AX Framework consists mainly of completely new AX artifacts that are AX version independent, i.e. work for both AX 2012 R2 and R3 versions. These artifacts are included in the DocentricAX model bound to the ISV, VAR or CUS layer.

However some of the built-in artifacts are modified and included in Docentric AX Framework as well, in order to enable enhancement of SSRS reports and Document Template Libraries. Since they differ from version to version, they have to be AX version specific. To mitigate possible merging and conflict resolving of the modified built-in artifacts from Docentric AX Framework, they are delivered in the form of a project (Docentric_ChangedArtifacts) for the particular AX version. We are going to import this project via XPO file.

Before you install Docentric AX Framework, back up the databases of your system.

Please follow the step-by-step instructions below:

1. Import the DocentricAX model in the ISV, VAR or CUS layer from the downloaded package. The model is located here: “\DocentricAX\DocentricAX_NewArtifacts_AX2012_R2_R3_Models\DocentricAX_<layer>.axmodel”.

Command in MS Dynamics AX 2012 Management Shell for importing the model:

The DocentricAX model contains all the new custom artifacts that Docentric AX Framework consists of, and they get imported by importing the model.

2. AOS restart.

3. Open AX client. The following message will appear: “The model store has been modified. Select the appropriate action:”. Select the Skip option.

4. Import the Docentric_ChangedArtifacts project from the SharedProject_Docentric_ChangedArtifacts_AX2012_Rx_CUx.xpo file from the downloaded package. See how >>

All the built-in AX artifacts that were modified in order to integrate Docentric AX Framework successfully are imported this way.

5. Locate and open the Docentric (shared) project. Compile it. Errors might appear.

6. AOS restart.

7. Open AX client and compile the Docentric (shared) project again. No errors should appear.

8. Synchronize tables.
Open the Docentric_NewArtifacts (shared) project. Synchronize all tables from this project.
Open the Docentric_ChangedArtifacts (shared) project. Synchronize all tables (there are two tables) from the project.

9. Check labels.
Labels are being automatically imported as a part of the model. Still, if you are using a different language than EN-US, e.g. NL (the Dutch language), you will have to rename the label file (AxDOCen-us.ald) from the downloaded package to AxDOCnl.ald and import it afterwards. This way the language of your enviroment will be simulated, and you can translate the labels later. Labels which are not translated to your language (e.g. Dutch) will appear in the English language. Instructions on how to do it you can find here.

Importing the Docentric labels for the specific AX client language has to be done because of diagnostic messages from Docentric AX Framework. Otherwise all messages from the code will appear as empty strings; they will not even be shown in the alternate help language, as it is the case with labels on forms.

10. Full compile.
Otherwise Print management reports will not work.
You can use AxBuild.exe for Parallel Compile on AOS to speed up the process.

11. Full CIL.

12. AOS restart.

See also

How to Install Docentric AX Framework via XPO files >>
How to Install Docentric AX Template Designer >>
Docentric AX Framework Setup >>
Download Examples >>