Install Sana Add-on in AX Environment

 NOTE

Before importing the 'Sana' model make sure that you are using the latest version of Microsoft Dynamics AX 2012.

• If you are using Microsoft Dynamics AX 2012 Feature Pack, the Cumulative Update 7 should be installed.
• If you are using Microsoft Dynamics AX 2012 R2, the Cumulative Update 9 should be installed.
• If you are using Microsoft Dynamics AX 2012 R3, the Cumulative Update 13 should be installed.

If earlier version of the cumulative update is installed on your AX environment, it is still possible to import the Sana model, but all system objects in the Sana Commerce project should be reviewed by the AX system administrator using the standard Comparison tool of Microsoft Dynamics AX. Comparison should be performed between the latest system layer and 'isv' layer. Only changes with the Sana Commerce comments or elements with the 'SC_' prefix, like on the screenshot below, should be present, any other changes should be removed.

If for some reasons you are not able to install the latest Cumulative Update we can also deliver AX utility of the latest Microsoft Dynamics AX version on demand that can be used to install the 'Sana' model on your environment.

 NOTE

If the installation fails because of a conflict, we recommend that you rerun the command, and use the /conflict:push option to push the element that has the conflict to the related update layer. You can then resolve the conflict. For more information, see 'How to: Resolve Conflicts After Importing a Model' in the Microsoft TechNet Library.

 NOTE

Pay attention to the display language of Microsoft Dynamics AX. By default the 'Sana' model is installed with the label file only for the English (United States) language of Microsoft Dynamics AX with the language culture name 'en-us'. For all other available languages in AX, Microsoft Dynamics AX creates the empty label files.

Thus, if your Microsoft Dynamics AX uses some other display language or the English language but not with 'en-us' language culture name, for instance 'en-gb' for United Kingdom then you should export the label file for the English language from the Sana project, rename it using the necessary language culture name and import it back. To do this:

Step 1: In Microsoft Dynamics AX open the Sana project and locate the label files:

Label Files

Step 2: Right-click on the label file with the 'en_us' language culture name and select 'Export to Label file'. The label file will be saved with the 'AxSCLen-us.ald' name.
Step 3: In the label file name change the language culture name to the one that is used as a display language of your Microsoft Dynamics AX client.
For example, if during the installation of Microsoft Dynamics AX you have selected the Dutch display language, the label file should be renamed to 'AxSCLnl.ald'.
Step 4: Right-click on 'Label_Files' of the Sana project and select 'Create from File'. Select the renamed label file and click 'Open' to import the label file with an appropriate language culture name.

 NOTE

If you use Microsoft Dynamics AX 2012 Help Server, you can extend your AX help with the Sana Commerce solution user documentation. In the Sana Commerce release package > AX > [AX version] there is the Sana Commerce help MSI file which can be used to install the Sana Commerce help that is integrated with the Microsoft Dynamics AX 2012 Help system.