An Invoke outbound Web service node supports only one fault
message, which by default is the WS_SOAPFAULT_AREA fault
message.
The default fault message
When you import
an outbound Web service definition, and an operations file and a message
file are generated (see Importing an outbound Web service definition),
the importer by default creates in the new operations file a reference
to the fault message WS_SOAPFAULT_AREA.
The
layout for this fault message is defined in the file IBMWS.sfmxsd,
which appears in the
Select a Message window
of the mapping editor. The
Select a Message window
is opened when you select the
Add Message Mapping Input entry
or the
Add Message Mapping Output entry from
the contextual menu of the mapping editor. To see this message in
the
Select a Message window:
- In the left pane of the Select a Message window,
expand the IBMWS entry.
- Select the IBMWS.sfmxsd entry. The WS_SOAPFAULT_AREA entry appears
in the central pane.
- Select the WS_SOAPFAULT_AREA entry. The layout is displayed in
the right pane.
The following table describes the fields in this fault
message:
| Field name: |
Description of the field: |
| WS_SOAPFAULT_CODE |
The SOAP fault code. |
| WS_SOAPFAULT_SUBCODE |
The SOAP fault subcode:- In SOAP 1.2 this field contains a subcode value.
- In SOAP 1.1 this field is set to spaces.
|
| WS_SOAPFAULT_NODE |
The URI of the SOAP node that generated the
fault. |
| WS_SOAPFAULT_REASON |
The human-readable reason string. |
| WS_SOAPFAULT_DETAIL |
The human-readable detail information. |
Typically, in the mapping editor, you would
connect the
additional output terminal for the fault
message of an Invoke outbound Web service node as an input to
one of the following:
- To a Switch node, so that you can make a decision based on the
data contained in the WS_SOAPFAULT_AREA message; or
- To an Invoke node of some type, to handle the occurrence of a
fault; or
- To a Throw node or a Reply node, to end the flow.
Only one fault message
For an invocation of an outbound Web service, the service flow
project tools allow a maximum of only one fault message . (By default
this fault message is the WS_SOAPFAULT_AREA fault message, which is
described in the preceding section of this topic).
Therefore:
All other types of invokes support multiple fault messages -- see Invoke nodes in the flow editor.