...
| Code Block |
|---|
|
<makefault [version="soap11|soap12|pox"]>
<code (value="literal" | expression="xpath")/>
<reason (value="literal" | expression="xpath")>
<node>?
<role>?
<detail>?
</makefault>
|
...
UI Configuration
Choose one of the following versions for the Fault Mediator:
Click on the relevant tab to view the required UI configuration pending on whether you want to create the fault message as a SOAP 1.1
...
fault, SOAP 1.2
...
fault or a plain-old XML (POX) fault.
...
...
 Image Added
The parameters available to configure the Fault mediator to create a SOAP 1.1 |
|
...
Image Removed
For this version, the following options are available:
...
- versionMismatch - SOAP version mismatch error.
- mustUnderstand - SOAP error regarding "must understand" error.
- Client - Client side error.
- Server - Server side error.
...
fault are as follows. | Parameter Name | Description |
|---|
| Fault Code | This parameter is used to select the fault code for which the fault string should be defined. Possible values are as follows. - versionMismatch: Select this to specify the fault string for a SOAP version mismatch.
- mustUnderstand: Select this to specify the fault string for the
mustUnderstand error in SOAP. - Client: Select this to specify the fault string for client side errors.
- Server: Select this to specify the fault string for server side errors.
| | Fault String | The detailed fault string of the fault code. |
|
|
...
The following options are available. - value: If this option is selected, the fault string is specified as a string value
|
|
|
...
- .
- expression: If this option is selected, the fault string is specified as an expression.
|
|
|
...
NameSpaces to add namespaces if you are providing an expression. |
|
|
|
...
Then the Namespace Editor panel would appear where you can provide any number of namespace prefixes and |
|
|
|
...
URLs used in the XPath expression. |
| | Fault Actor | |
|
|
...
| Detail | This parameter is used to enter a custom description of the error. |
|
|
...
 Image Added
The parameters available to configure the Fault mediator to create a SOAP 1.2 |
|
...
Image Removed
For this version, the following options are available:
...
fault are as follows. | Parameter Name | Description |
|---|
| Code | This parameter is used to select the fault code for which the reason should be defined. Possible values are as follows. - versionMismatch: Select this to specify the reason for a SOAP version mismatch.
- mustUnderstand: Select this to specify the reason for the
mustUnderstand error in SOAP. - dataEncodingUnknown: Select this to specify the reason for a SOAP encoding error.
- Sender
|
|
|
...
- : Select this ti specify the reason for a sender-side error.
- Receiver
|
|
|
...
Reason- Reason describing the fault code.
...
- : Select this to specify the reason for a receiver-side error.
|
|
|
...
| Reason | This parameter is used to specify the reason for the error code selected in the Code parameter. The following options are available.- value: If this option is selected, the reason is specified as a string value.
- expression: If this option is selected, the reason is specified as an expression.
| Info |
|---|
| You can click NameSpaces to add namespaces if you are providing an expression. |
|
|
|
...
Then the Namespace Editor panel would appear where you can provide any number of namespace prefixes and |
|
|
|
...
URLs used in the XPath expression. |
| | Role |
|
|
...
...
...
...
...
Image Removed
...
| Detail | This parameter is used to enter a custom description of the error. |
|
|
...
Image Added The parameters available to configure the Fault mediator to create a plain-old XML (POX) fault are as follows. | Parameter Name | Description |
|---|
| Reason | This parameter is used to enter a custom fault message. The following options are available |
|
|
...
. - value: If this option is selected, the fault message is specified as a string value
|
|
|
...
- .
- expression: If this option is selected, the fault message is specified as an expression.
|
|
|
...
NameSpaces to add namespaces if you are providing an expression. |
|
|
|
...
Then the Namespace Editor panel would appear where you can provide any number of namespace prefixes and |
|
|
|
...
| Info |
|---|
You can configure the Mediator using XML. Click on "switch to source view" in the "Mediator" window.  Image Removed
|
...
URLs used in the XPath expression. |
|
|
|
...
| Detail | This parameter is used to enter details for the fault message. The following options are available. - value: If this option is selected, the detail is specified as a string value.
- expression: If this option is selected, the detail is specified as an expression.
| Info |
|---|
| You can click NameSpaces to add namespaces if you are providing an expression. Then the Namespace Editor panel would appear where you can provide any number of namespace prefixes and URLs used in the XPath expression. |
|
|
|
| Info |
|---|
|
You can configure the mediator using XML. Click switch to source view in the Mediator window. Image Added |
...
Examples
In the following example, the test message string value is given as the reason for the SOAP error versionMismatch.
| 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>
|
Samples
See also Sample 5: Creating SOAP Fault Messages and Changing the Direction of a Message.
...