Troubleshoot problems operating the Application Integration Framework

Dynamics AX 4.0

This topic describes how to troubleshoot common issues with document exchange using the Application Integration Framework (AIF).

You may see the message "The requested operation cannot be performed because the required security key doesn’t exist" in the Web server event log. This occurs if the endpoint user does not have access to Business Connector.

When you configure an endpoint for inbound Web services, you must:

  1. Set up an Microsoft Dynamics AX user (or user group) as endpoint user or trusted intermediary for that endpoint.

  2. Give the user group access to the Business Connector.

Give the endpoint user access to Business connector

  1. Click >. > and select the user group for the endpoint, or the user group that contains the user for the endpoint.

  2. Click .

  3. On the tab, in the table under the field:

    1. Select

    2. Select

    3. Click .

For the Application Integration Framework (AIF) Web services to coexist with Windows SharePoint Services (WSS) and Enterprise Portal on the same computer, the virtual directory that AIF is using for Web services must be excluded from the SharePoint managed path.

To exclude the AIF virtual directory from the SharePoint managed path list:

  1. Launch the SharePoint Central Administration page (Start > All Programs > Administrative Tools > SharePoint Central Administration or, from the browser on a remote computer, type the URL for the pages on the administration port. For example: http://servername:port).

  2. Click Configure virtual server settings and click the name of the site you are managing.

  3. Under Virtual Server Management, click Define managed paths.

  4. Under Add a New Path, enter the AIF virtual directory path, and then select Excluded path, and click OK.

If you cannot see the ASP.NET tab when viewing Properties for the virtual root in the IIS Services Manager (see Configure IIS to work with Microsoft Dynamics AX Web services) or if you see a Page not found error after clicking Browse when validating Web services (see Create Web services for an action) you must re-register in IIS using the following steps:

  1. Click Start > Run.

  2. Type cmd.

  3. In the Command Prompt window, type:

  4. cd your-system-directory \Microsoft.NET\Framework\v2.0.50727 and press ENTER.

  5. Type aspnet_regiis.exe -u and press ENTER.

  6. Type aspnet_regiis.exe –i -enable and press ENTER.

  7. Type iisreset and press ENTER.

  8. Close the Command Prompt window.

  9. After uninstalling and reinstalling ASP.NET and resetting IIS, the ASP.NET tab is available, and you can select ASP version 2.0. This allows you to browse the Web services after you create them on the form. See Create Web services for an action.

  • If the error message "The transaction context is invalid" appears for an inbound message, check that the queue that receives the message is located on the same computer as the Application Object Server (AOS) running the AIF batch jobs. For more information on these batch jobs, see Start and stop the asynchronous Application Integration Framework (AIF) services.

  • If the error message "The specified format name does not support the requested operation. For example, a direct queue format name cannot be deleted" appears when a message is sent, check that the queue you are sending to is a public queue, and its address (on the form) is given in short name format (for example: computer-name\queue-name).

  • If it seems that outbound messages are sent (that is, they no longer appear in the list on the tab in the form, and no entries are created in the Exception Log for an error condition) but the messages are not received by the target queue, ensure that the target queue's access control list (ACL) is set properly: on the Security tab of the Properties window for the queue, Allow should be selected for Send Message, Get Permissions and Get Properties for the Anonymous Logon user. Also check that the target queue's Authenticated property is unchecked on the General tab in the Message Queuing folder (click Start > Settings > Control Panel > Administrative Tools > Computer Management).

  • For inbound messages, if there is a message in the Exception Log that says "The user is not authorized to perform this action", check the form (click > > > ) for any inbound messages in an Error state. If the field on the tab is blank, ensure that either the inbound queue's Authenticated property is checked or that all incoming messages are signed and authenticated.