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. |