Modifying a Returned SOAP Fault

If a provider or consumer web service results in a fault, you can modify values in the fault, if needed. For example, you might want to alter the fault code if your error handling requires a specific code.

To update a SOAP fault, use the pub.soap.handler:updateFaultBlock service. For more information about this service, see the webMethods Integration Server Built-In Services Reference. You can invoke the updateFaultBlock service from a response handler or fault handler service for a web service provider. Use the service to customize one or more of the following SOAP fault fields:

Fault field you can customize	Notes
fault code and subcodes	For a SOAP 1.1 fault, if you specify subcode values, the service ignores them because subcodes are only applicable for a SOAP 1.2 fault.
fault reasons	For a SOAP 1.1 fault, if you specify more than one reason, the service only uses the first reason. Multiple reasons are supported for SOAP 1.2 faults.
fault node	For a SOAP 1.1 fault, if you specify a value for node, the service ignores it because the fault node is only applicable for a SOAP 1.2 fault.
fault role	The fault role is supported for both SOAP 1.1 and SOAP 1.2 faults.