Integration Server 10.3 | Web Services Developer’s Guide | Working with Web Services | About SOAP Fault Processing | Modifying a Returned SOAP Fault
 
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.