Example: Fault in an Outbound Message [AX 2012]

Updated: January 10, 2012

Applies To: Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

When the Application Integration Framework (AIF) receives and processes an inbound message, it generates an outbound message in response. If any error has occurred in processing the message, the service can generate information about the error to include in the response. This topic describes the <Fault> tag that occurs in outbound messages that report an error in the corresponding inbound message.

The following XML code example shows a <Body> tag section that contains a <Fault> tag. The <Text> tag contains the textual information that you can use to diagnose the problem.

<Body>
 <MessageParts xmlns = "http://schemas.microsoft.com/
    dynamics/2008/01/documents/Message">
  <Fault xmlns = "http://schemas.microsoft.com/dynamics/
     2008/01/documents/Fault">
   <Code>RequestFailed</Code>
   <Reason>
    <Text xml:lang = "EN-US"
       >Request Failed. See the Exception Log for details.</Text>
   </Reason>
  </Fault>
 </MessageParts>
</Body>

The <Text> tag in the previous example instructed the user to view the Exceptions log. The log can be viewed in the Exceptions form. Click System administration > Periodic > Services and Application Integration Framework > Exceptions. In the Exceptions form, you can view information about the module and subsystem where the error occurred, and a description of the error. You can also view information about when the error was logged, the user who is associated with the error, and the form or business logic where the error occurred.

You can include the information in the exception log in the response on an inbound port by setting Include exceptions in fault in the Troubleshooting area on the Inbound ports form. Click System administration > Setup > Services and Application Integration Framework > Inbound ports. For more information, see Configure troubleshooting options for integration ports.

The <Fault> tag section is validated against the Fault XSD. You can retrieve XSDs for common schemas from your Microsoft Dynamics AX installation. The path of the directory resembles the following:

\Program files\Microsoft Dynamics AX\60\Server\<MicrosoftDynamicsAX installation ID>\bin\Application\Share\Include

Community Additions

ADD
Show: