Application Services Interface Reference > Application Services Interfaces (ASIs) > ASIs and Web Services >

Handling Errors for ASIs

The SOAP fault message returns any errors for inbound and outbound ASIs.

Errors for Inbound ASIs

The SOAP fault block returns any inbound error messages, as defined by the SOAP 1.1 specification. The faultcode contains either a Client or Server value, and the faultstring contains a description of the error. The error message <siebel:errormsg> details the problems with the request. The information in the SOAP fault block can be extracted and displayed to the user.

The following XML shows an example of a fault message.

<?xml version="1.0" encoding="UTF-8" ?>
<?Siebel-Property-Set EscapeNames="false"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

<SOAP-ENV:Body>

   <SOAP-ENV:Fault xmlns:siebelf="http://www.siebel.com/ws/fault">

      <faultcode>Client</faultcode>

      <faultstring>
        Supplied input is not well formed or does not contain the
        expected data.
      </faultstring>

   <detail>
      <siebelf:errorstack>
        <siebelf:error>
        <siebelf:errorsymbol />

        <siebelf:errormsg>Supplied input is not well formed
              or does not contain the expected data.
        </siebelf:errormsg>

        </siebelf:error>

        <siebelf:error>
        <siebelf:errorsymbol>
              IDS_XMLCNV_ERR_EMPTYMSG
        </siebelf:errorsymbol>

        <siebelf:errormsg>XML Hierarchy Converter error - empty
           input message, expecting an XML document in <Value> of
           input arguments
        </siebelf:errormsg>

        </siebelf:error>

      </siebelf:errorstack>
   </detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Errors for Outbound ASIs

If an error occurs during an outbound ASI that has been exposed as a Web Service, the business service raises the error and returns the SOAP fault message as the output method argument, soap:fault, for the application to process. The error is represented as an XML hierarchy property set.

These outbound ASIs can potentially time out. You can specify the time out interval as a siebel:timeout argument. If a time-out interval is not specified, the transport's default time-out applies. An IDS_EAI_ERR_TIMEOUT error occurs, and not a soap:fault.