The Fault Mediator (also called the Makefault Mediator) transforms the current message into a fault message, but does NOT send it. The Send Mediator needs to be invoked to send a fault message created this way. The fault message's To
header is set to the Fault-To
of the original message if such a header exists in the original message. If a version
attribute is specified, the created fault message will be created as a selected SOAP 1.1, SOAP 1.2 or POX fault.
...
Table of Contents | ||||
---|---|---|---|---|
|
...
...
|
...
Syntax
Code Block | ||||
---|---|---|---|---|
| ||||
<makefault [version="soap11|soap12|pox"]>
<code (value="literal" | expression="xpath")/>
<reason (value="literal" | expression="xpath")>
<node>?
<role>?
<detail>?
</makefault>
|
...
- Fault Code
- versionMismatch - SOAP version mismatch error.
- mustUnderstand - SOAP error regarding "must understand" error.
- Client - Client side error.
- Server - Server side error.
- Value/Expression
Fault String- The detailed fault string of the fault code. It can be given either as a string value or an expression.
Info title Tip You can click on this link to add namespaces if you are providing an expression. You will be provided another panel named "Namespace Editor," where you can provide any number of namespace prefixes and URL that you have used in the XPath expression.
- Fault Actor
- Detail - Some information about the fault can be added to this field.
...
- Code
- versionMismatch - SOAP version mismatch error.
- mustUnderstand - SOAP error regarding "must understand" error.
- dataEncodingUnknown - SOAP encoding error.
- Sender - Sender-side error.
- Receiver - Receiver-side error.
- Value/Expression
Reason- Reason describing the fault code.
Info title Tip You can click on the "Namespaces" link to add namespaces if you are providing an expression. You will be provided another panel named "Namespace Editor," where you can provide any number of namespace prefixes and URL that you have used in the XPath expression.
- Role - SOAP 1.2 role names.
- Node - SOAP 1.2 node name.
- Detail - Some information about the fault can be added to the field.
Info | ||
---|---|---|
| ||
You can configure the Mediator using XML. Click on "switch to source view" in the "Mediator" window. |
...
Example
Code Block | ||||
---|---|---|---|---|
| ||||
<makefault xmlns="http://ws.apache.org/ns/synapse" version="soap11">
<code xmlns:soap11Env="http://schemas.xmlsoap.org/soap/envelope/" value="soap11Env:VersionMismatch" />
<reason value="test message " />
<role></role>
</makefault>
|
Excerpt | ||
---|---|---|
| ||
Description of the Fault Mediator in WSO2 ESB. |