Manage document exchanges in AIF

  • Article
  • 2 minutes to read

After you set up data exchanges with external systems using Application Integration Framework (AIF), you will need to maintain this integration. Microsoft Dynamics AX provides the ability to manage your document exchanges throughout their life cycle and troubleshoot any issues with data transfer. Maintaining and managing document exchanges involves:

  • Monitoring traffic and viewing document history as documents pass through the framework.

  • Clearing and reviewing messages in the queues for adapter-based exchanges.

  • Viewing the exception logs when problems arise.

  • Editing and resubmitting messages that contain formatting errors.

  • Stopping and starting the batch services when necessary.

Document history

For both adapter-based and Web services-based exchanges, information about messages and document history is organized by action for each endpoint. You set the parameters for logging this information when you configure endpoint action policies.

You view the logged information on the Document history form by clicking Basic > Periodic > Application Integration Framework > Document history.

For more information, see View document history, Viewing the document log and "AIF Document history (form)" in the Application and Business Processes Help.

Queue manager

For adapter-based exchanges, you use the Microsoft Dynamics AX batch functionality to start and stop the operation of the four services that move messages in to and out of the document processing queues. After documents are exchanged, you can monitor the activity of documents in the queues in the Queue manager. You can also edit and resubmit documents that have errors with the Queue manager form.

To open the Queue manager, click Basic > Periodic > Application Integration Framework > Queue manager. For more information, see Edit and resubmit messages in the queues.

Exceptions

You can view information about AIF error messages when they occur by clicking Basic > Periodic > Application Integration Framework > Exceptions. The Exceptions form contains information about the module and subsystem where the error occurred, a description of the error, when the error was logged, the user associated with the error, and the form or business logic where the error occurred.

For more information, see Viewing the exceptions log.

Starting and stopping the batch services

For adapter-based exchanges, you use the Microsoft Dynamics AX batch functionality to start and stop the operation of the four AIF services: AIFOutboundProcessingService, AIFInboundProcessingService, GatewaySendService, and GatewayReceiveService. These services move messages in to and out of the document processing queues. You may need to start and stop these services to troubleshoot any issues or to change the batch job settings such as recurrence.

For more information, see Start and stop the asynchronous AIF services.