Integration Platform Technologies: Siebel Enterprise Application Integration > Web Services > About SOAP Fault Schema Support >

Handling SOAP Faults in Siebel Business Applications, Version 8.1 and Higher

In version 8.1 and higher, the fault schemas described in the WSDL are accepted and modeled as integration objects. This is similar to how other input and output messages are modeled as strings (simple type) or integration objects (complex type). These named faults are available as output parameters.

Having named faults available as output parameters is useful in SOA environments. For example, Business Process Execution Language (BPEL) can only send named faults.

Handling SOAP Messages

SOAP messages are handled as follows:

1. An end user calls a proxy business service, for example, by clicking a button.
2. The proxy business service reads the input parameters and invokes the external Web service.
3. The proxy business service reads the SOAP response and checks for a SOAP Fault element.
4. If no SOAP fault is found, then the message is handled as normal.
5. If a SOAP fault is found, then the proxy business service tries to match the fault with a SOAP fault integration object.
   1. If a match is found, then Siebel converts the fault into a fault integration object instance and sets it in the output parameter.
   2. Whether or not a match is found, Siebel puts the fault into the XML Hierarchy (for backward compatibility).

Handling WSDL Imports

The handling of SOAP faults while importing WSDL files into Siebel Business Applications is as follows:

1. A developer uses the WSDL Import Wizard in Siebel Tools to import a WSDL document for creating proxy business services.
2. If the operation has a named fault that is not defined in the WSDL, then it is put into the XML Hierarchy.
3. If the operation has a named fault defined in the WSDL:
   1. If the Process Fault Schema check box is not selected, the named fault is ignored.
   2. If the Process Fault Schema check box is selected and an existing fault integration object is specified, then that fault integration object is added as an output parameter.
   3. If the Process Fault Schema check box is selected and an existing fault integration object is not specified, then a new fault integration object is added as an output parameter. The integration object name is prepended with Fault_.

For information on using the WSDL Import Wizard, see Creating an Outbound Web Service Based on a WSDL File.