Software AG Products 10.7 | Integrating On-Premises and Cloud Applications | Service Development | Working with Web Services | About SOAP Fault Processing | The $fault Variable
 
The $fault Variable
Use the $fault variable to override values Integration Server generates for a fault. To do so, specify the fault detail in the $fault/detail variable. Then, to override the fault reasons, code, subcodes, node and/or role, provide the corresponding values.
The following shows the structure of the $fault variable.
Variable
Description
$fault
Document Fault information that overrides other fault information in the service pipeline, if any.
code
Document Optional. The fault code and possible subcodes. Integration Server uses values you specify to modify the fault code and subcodes it generates for the fault.
Note:
For a SOAP 1.1 fault, Integration Server ignores any values specified for subcodes.
namespaceName
String The namespace name for the SOAP fault code.
localName
String A code that identifies the fault.
subcodes
Document List Optional. Subcodes that provide further detail. Each Document in the subCodes Document List contains:
*namespaceName for the subcode
*localName that identifies the subcode
reasons
Document List Optional. Reasons for the SOAP fault. Integration Server uses values you specify to modify the reasons it generates for the fault.
Note:
For a SOAP 1.1 fault, if you specify more than one reason, Integration Server uses the first reason. Multiple reasons are supported for SOAP 1.2 faults.
@lang
String Language for the human readable description.
*body
String Text explaining the cause of the fault.
node
String Optional. The URI to the SOAP node where the fault occurred. Integration Server uses value you specify to modify the node it generates for the fault.
Note:
For a SOAP 1.1 fault, Integration Server ignores any values specified for node.
role
String Optional. The role in which the node was operating at the point the fault occurred. Integration Server uses value you specify to modify the role it generates for the fault.
detail
Document Fault information you want Integration Server to use. This overrides any top-level instance document that defines the fault detail.