Adapter for SAP 10.1 | webMethods Adapter for SAP Documentation | webMethods Adapter for SAP Installation and User’s Guide Documentation | Using BizTalk Envelopes with Adapter for SAP | Error Handling | Representation of Communication and Processing Errors
 
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>