Install Guide - AX

Install Guide

Applicable to Dynamics AX

To enable the handheld clients to be able to access the Tasklet Factory WMS SOAP based service that is hosted inside Microsoft Dynamics 365 For Finance and Operations, it is necessary to grant the client access to this service. The following describes how to configure this access in Microsoft Azure Portal.

Prerequisites

Dynamics AX 2012 installation, having access to the Microsoft Dynamics AX Management shell (PowerShell).

Application Integration Framework (AIF) is installed using IIS.
See https://technet.microsoft.com/da-dk/library/gg731848.aspx

Hint: When installing the IIS Role – install “IIS Management Scripts and Tools” (found under “Web Server(IIS)/Management Tools”). The tools are used by the AIF installation to configure the Web server.

Install AX Model Process

AX Models are imported using the Microsoft Dynamics AX Management Shell. This is a PowerShell with AX related commands available.
Ideally, the PowerShell is started on the AOS that hosts the environment you want to install in. This is typically the DEV environment.

Important: If multiple environments are hosted on the same server, you must make sure that you target the environment you expect.

The top level steps in the process are:

1. Copy the signed AX model file
   Copy the signed AX model file containing the "TF Mobile" model to the server where the installation is performed. The model file is supplied by Tasklet Factory.
   
   
2. Stop the AOS(s)
   It is a best practice to stop the AOS(s) before importing the model.
   Use the "Online Users" screen in AX to determine if you are alone on the server.
   
   

3. Install the AX Model
   Start the AX Management Shell and run the command to import the model: 
   
   

   Install-AXModel -File "<path to the AX model>" -Conflict Push -Config "<path to the AXC file pointing to the correct environment>"

   
   This will import the model in the VAR layer and push any conflicts into a new model in the VAP (the patch layer for VAR)
   It is expected that the menu will conflict.
   
   
   
   

4. Restart the AOS(s)

Correction for Dynamics AX2012R3 CU8 or Newer

A method in AX must be changed if you are running CU8 or newer.

Class: InventTransWMS_Register
Method: getDateInvent(…)

If the method signature looks like [ public static TransDate getDateInvent(Common _record) ]
It must be changed to [ public static client server TransDate getDateInvent(Common _record) ]

Recompile AX Application

Do a full recompilation + CIL compilation + DB synchronization

Since AX2012R2 CU7 it has been possible to recompile the AX application in multiple threads. This will reduce the compile time from hours to minutes.

The expected multi threaded compile time is about 10-15 minutes. See http://msdn.microsoft.com/en-us/library/dn528954.aspx for details.

The CIL compilation still needs to be performed from the AX client.
The DB synchronization is also performed from the AX client.

Setting up Dynamics AX

This section describes the tasks that are performed once per AX installation.

Add Mobile WMS Menu

Start Dynamics AX, open the development environment. In the AOT, open the “Menus” node.

Find the “Main menu”.

Drag the menu “Mob” into the “Main menu”.

Save the changes.

Deploy Service Group

Unfold the “Service Groups” node.

Find the “MobService”, right-click and choose “Deploy Service group”.

This will do two things.

1. Create a “Service operation” called “MobDocumentService.submit”.
2. Create an “Inbound port” called “MobDocumentService”.
   This port cannot be used, because it has a wrong adapter type.
   So it must be replaced.

Solving Installation Problems

These problems are commonly seen.