"soap:fault" - Binding for SOAP Fault Details

WSDL Tutorials - Herong's Tutorial Examples

∟WSDL 1.1 Binding Extension for SOAP 1.1

∟"soap:fault" - Binding for SOAP Fault Details

This section describes 'soap:fault', a SOAP extension element that specifies how the SOAP Fault Details should be constructed in a SOAP response message. 'literal' means no encoding.

"soap:fault" is a SOAP extension element used as a sub element of the "wsdl:operation" element inside the "wsdl:binding" element. "soap:fault" is used to provide information on how the content of the SOAP Fault Details element is constructed. The syntax of "soap:fault" looks like this:

<wsdl:definitions ...>
  <wsdl:binding ...>
    <wsdl:operation ...>
      <wsdl:fault>
        <soap:fault name="nmtoken" use="literal|encoded"
          encodingStyle="uri-list" namespace="uri"/>
      </wsdl:fault>
    </wsdl:operation>
  </wsdl:binding>
</wsdl:definitions>

Notes on the "soap:fault" element:

name="nmtoken" - Specifying the fault message to be bound by referring a fault message defined in the operation in the port type. There should be only 1 message part for a fault message.
use="literal|encoded" - Indicates whether the message part should be used as is (literal) or encoded. This is a required attribute. If use="literal", the message part is referring to concrete a schema definition and no encoding is needed. If use="encoded", the message part is referring to abstract a schema definition and concrete message can be produced by applying the specified encoding style.
encodingStyle="uri-list" - Indicates encoding style(s) to be used in case of use="encoded".
namespace="uri" - Indicates the namespace to be used in case of use="encoded".