Introduction SOAP 1.1 Fault Binding

Copyright © 2011 Open Geospatial Consortium. 89 19 SOAP binding

19.1 Introduction

This section defines the realization of functionality defined in this standard for a service using SOAP. This standard does not prescribe usage of either SOAP 1.1 or SOAP 1.2. It also does not prescribe WSDL 1.1 or WSDL 2.0. This standard does not define any specific policy statements to be included in a WSDL document or in service requests and responses for defining specific established, available or desired behavior. If the need for such policies arises in the future, necessary policy statements can be included in the standard or in extensions of it.

19.2 Exceptions

19.2.1 Introduction

The operations defined in this standard use exception codes defined by OWS Common [OGC 06-121r3] chapter 8. The encoding of those exceptions follows the definitions given in the following paragraphs. The encoding of a SOAP 1.1 fault is slightly different compared to a SOAP 1.2 fault. Each of the exceptions recognized by this standard see section 19.2.4 is therefore defined by specifying values for the following abstract fault properties which are mapped to the properties of SOAP 1.11.2 faults see sections 19.2.2 and 19.2.3: • [Code] The fault code of type QName • [Subcode] The fault subcode. • [Reason] Human readable text explaining the exception. It is recommended to use this text but service implementations may use other text e.g. in other languages • [Details] The detail elements to be added to the SOAP fault. NOTE Sub subcodes which can be defined in SOAP 1.2 faults are not relevant for the exceptions defined in this standard.

19.2.2 SOAP 1.1 Fault Binding

The SOAP 1.1 fault is slightly less expressive than the SOAP 1.2 fault. It maps only [Code] together with [Reason] and [Details]. 90 Copyright © 2011 Open Geospatial Consortium. Requirement http:www.opengis.netspecSWES2.0reqSOAPFaultFaultBinding1.1 REQ 71. The abstract fault properties as defined in section 19.2.1 bind to a SOAP 1.1 fault as follows: • The value of the [Code] property is bound as the value of the SOAP faults soap11:Faultfaultcode 1 element. • The value of the [Reason] property is bound as the value of the SOAP faults soap11:Faultfaultstring element 2 . • The value of the [Details] property is bound as child elements of the SOAP faults soap11:Faultdetail element information item. 1 Note that the elementFormDefault in the SOAP 1.1 schema is not set to qualified and therefore the faultcode child element of a soap11:Fault element is unqualified – also see WS-I Basic Profile 1.1 section 3.3.3 2 The faultstring in a SOAP 1.1 fault does not provide the functionality to define the language of the contained textual description. Copyright © 2011 Open Geospatial Consortium. 91

19.2.3 SOAP 1.2 Fault Binding