Representation of Communication and Processing Errors
Errors which are caused inside Adapter for SAP or by the technical layers in the SAP system are represented by a uniform XML fault-descriptor element. This fault element has been defined following the design principles used for SOAP and SAP XRFC error handling.
This fault element is transferred in the body of a BizTalk XML envelope and introduced by the fault-XML element (which is defined in the namespace urn:sapcom: document:sap:business by applying a specific prefix).
This fault element has the following sub-elements:
XML Element | Description |
<faultcode> | A number specifying the class of error. Compatible with the Microsoft SOAP XML framework specification. Adapter for SAP always sets this value to 401 to indicate an application-specific error. |
<faultstring> | Internal Adapter for SAP code for this exception. |
<detail> | Details of the specified sub-elements <name> and <message> |
<name> | Name of an exception to use with the SAP system as the ABAP exception identifier. |
<message> | Error message with the specified sub-element <text>. (Optional; this is not always fully specified). |
<text> | The text of the error message. |
An example of an exception document:
<?xml version="1.0" encoding="iso-8859-1"?>
<biztalk_1 xmlns="urn:biztalk-org:biztalk:biztalk_1">
<header>
<delivery>
<message>
<messageID>0A125F1315B39EDB00000013</messageID>
<sent>2000-06-19T18:59:02</sent>
</message>
<to>
<address>urn:sap-com:logical-system:SAPCLNT001</address>
</to>
<from>
<address>urn:sap-com:logical-system:SAPADA0001</address>
</from>
</delivery>
</header>
<body>
<sap:Fault xmlns:sap="urn:sap-com:document:sap:business"
xmlns="">
<faultcode>401</faultcode>
<faultstring>
com.wm.adapter.sap.error.SAPBasicException
</faultstring>
<detail>
<name>SBC_EXCEPTION</name>
<message>
<text>Business object named Bank2 does not exist in SAP
System U9C</text>
</message>
</detail>
</sap:Fault>
</body>
</biztalk_1>