Developer Workstation Installation

Step 1: Locate the AX web service application files, which can be found in the 'Services\AX' folder in the Sana Commerce installation package.

Step 2: Copy the contents of this folder to the new folder (e.g. 'AXService') at the IIS working directory (by default C:\inetpub).

Step 2: Open Internet Information Service (IIS) manager (Start -> Run -> inetmgr).

Step 3: Add new application pool. Select '.NET Framework v4.0.30319' from the dropdown and 'Classic' pipeline mode:

Adding New Application Pool

Step 4: In the application pool advanced settings set the value of the 'Enable 32-bit applications' to 'TRUE'.

Step 5: Add new application for AX web service. Select the newly created application pool and specify physical path to the folder where web service was copied:

Adding New Application for AX Web Service

Step 6: Modify the web service configuration file of AX ('web.config'). In the <appSettings> section specify the AX user credentials and AX object server:

• User name;
• User password;
• User domain;
• AX object server.

<appSettings>
    <add key="UserName" value="AXUSERNAME"/>
    <add key="Domain" value="DOMAIN"/>
    <add key="UserPassword" value="PASSWORD"/>
    <add key="objectServer" value="INSTANCENAME@SERVERNAME:PORT"/>
</appSettings>

More detailed information about the AX user read here. To identify object server open Microsoft Dynamics AX Configuration Utility with administrator rights. On the 'Connection' tab you can observe available AOS instances.

Step 7: In the web service configuration file ('web.config') locate the <assemblies> and <runtime> sections and uncomment those lines which relate to your AX version.

<binding name="AX" maxBufferPoolSize="924288" maxReceivedMessageSize="955360">
<readerQuotas maxStringContentLength="999999" maxArrayLength="999999" />

Make sure that for the 'maxStringContentLength' and 'maxArrayLength' properties the maximum values (999999) are set.

Step 9: In the <bindings> configuration section replace the line <binding name="AX_SSL"> by the following two lines:

<binding name="AX_SSL" maxBufferPoolSize="924288" maxReceivedMessageSize="955360">
<readerQuotas maxStringContentLength="999999" maxArrayLength="999999" />

Make sure that for the 'maxStringContentLength' and 'maxArrayLength' properties the maximum values (999999) are set.

Step 10: To test the newly created web service, select the created AX application in IIS and switch to the content view mode. Select the 'AXService.svc' file and click 'Browse'. Web service information page should be displayed in the default browser:

Web Service Testing

If the following error message occured: 'Could not find a base address that matches scheme https for the endpoint with binding WSHttpBinding. Registered base address schemes are [http].' SSL should be configured in IIS. If you do not use SSL for AX web service, the following code should be deleted from the web service configuration file of Microsoft Dynamics AX ('web.config'): <binding name="AX_SSL"> <security mode="TransportWithMessageCredential"> <transport clientCredentialType="Windows" proxyCredentialType="None" realm="" /> <message clientCredentialType="Windows" negotiateServiceCredential="true" algorithmSuite="Default" establishSecurityContext="true"/> </security> </binding>