Troubleshooting

Check these issues when troubleshooting the Dynamics AX 2009 integration.

Document management directory does not exist

An error message that the Document management directory does not exist can appear in:

Three issues can cause this error message:

  • The directory does not exist in Dynamics AX. Make sure that the folder that is specified in the Archive directory setting exists.

Archive directory setting

  • AOS cannot access the directory. If the Archive directory is located on a different computer than the AOS service, you must share the folder and reference its shared path.

Archive directory setting

  • The integration user does not have access to the directory. Make sure that the user that performs the integration has read/write access to the folder that is specified in the Archive directory setting in Dynamics AX (Document management parameters dialog).

You can specify the integration user in two different places:

  • The ReadSoft Online configuration wizard.
Figure 1. In this example, you can see that ReadSoft Online is run using the Administrator user.
Online Connect configuration wizard

 

  • The ReadSoft Online Windows service.
Figure 2. In this example, you can see that the ReadSoft Online service is run using the Administrator user.
Online Connect Windows service

Multiple AOS instances on the same Dynamics AX server

To use the Dynamics AX 2009 integration with multiple AOS instances, follow this procedure.

  1. From the Start menu in Windows, run Microsoft Dynamics AX 2009 Configuration on the computer where IIS is installed for the Dynamics AX integration.

    Microsoft Dynamics AX 2009 Configuration

  2. Select Business Connector in the Configuration Target box.

    Configuration Target

  3. Make sure there is a configuration for the desired AOS instance.

    If the configuration is missing, click Manage > Create configuration.


    Create configuration

    After you set up the configuration, make sure that you select the configuration that you just created in the Configuration box.


    The Configuration box

  4. Open the web.config file that is located in the RsoIntegrationService folder that you use for IIS.

  5. The web.config file

    Tip You can also access the web.config file from within Dynamics AX by navigating to the Services, selecting the RsoIntegrationService and clicking Configure to open the web.config file.

  6. Find the BUSINESS_CONNECTOR_CONFIGURATION key, and change its value to the configuration you selected in step three.

    The BUSINESS_CONNECTOR_CONFIGURATION key

    Note When generating services from Dynamics AX (Basic > Setup > Application Integration Framework > Services) Dynamics AX overrides the web.config file, the BUSINESS_CONNECTOR_CONFIGURATION key can be reset by Dynamics AX. Therefore, it is important that you remember to reset the value after you generate the services.