Exception reporting

Feedback

In the event that a web feature service encounters an error while processing a request or receives an unrecognized request, it shall generate an XML document indicating that an error has occurred.

OGC-exception.xsd is as follows:

<?xml version="1.0" encoding="UTF-8"?> - <schema xml:lang="en" version="1.1.0 2011-02-07" elementFormDefault="qualified" xmlns="http://www.w3.org/2001/XMLSchema" xmlns:ows="http://www.opengis.net/ows/1.1" targetNamespace="http://www.opengis.net/ows/1.1"> - <annotation> <appinfo>owsExceptionReport.xsd</appinfo> <documentation>This XML Schema Document encodes the Exception Report response to all OWS operations. OWS is an OGC Standard. Copyright (c) 2006,2010 Open Geospatial Consortium. To obtain additional rights of use, visit http://www.opengeospatial.org/legal/ . </documentation> </annotation>  <include schemaLocation="owsAll.xsd" /> <import schemaLocation="http://www.w3.org/2001/xml.xsd" namespace="http://www.w3.org/XML/1998/namespace" />  - <element name="ExceptionReport"> - <annotation> <documentation>Report message returned to the client that requested any OWS operation when the server detects an error while processing that operation request. </documentation> </annotation> - <complexType> - <sequence> - <element maxOccurs="unbounded" ref="ows:Exception"> - <annotation> <documentation>Unordered list of one or more Exception elements that each describes an error. These Exception elements shall be interpreted by clients as being independent of one another (not hierarchical). </documentation> </annotation> </element> </sequence> - <attribute name="version" use="required"> - <annotation> <documentation>Specification version for OWS operation. The string value shall contain one x.y.z "version" value (e.g., "2.1.3"). A version number shall contain three non-negative integers separated by decimal points, in the form "x.y.z". The integers y and z shall not exceed 99. Each version shall be for the Implementation Specification (document) and the associated XML Schemas to which requested operations will conform. An Implementation Specification version normally specifies XML Schemas against which an XML encoded operation response must conform and should be validated. See Version negotiation subclause for more information. </documentation> </annotation> - <simpleType> - <restriction base="string"> <pattern value="\d+\.\d?\d\.\d?\d" /> </restriction> </simpleType> </attribute> - <attribute ref="xml:lang" use="optional"> - <annotation> <documentation>Identifier of the language used by all included exception text values. These language identifiers shall be as specified in IETF RFC 4646. When this attribute is omitted, the language used is not identified. </documentation> </annotation> </attribute> </complexType> </element>  <element name="Exception" type="ows:ExceptionType" />  - <complexType name="ExceptionType"> - <annotation> <documentation>An Exception element describes one detected error that a server chooses to convey to the client. </documentation> </annotation> - <sequence> - <element name="ExceptionText" maxOccurs="unbounded" type="string" minOccurs="0"> - <annotation> <documentation>Ordered sequence of text strings that describe this specific exception or error. The contents of these strings are left open to definition by each server implementation. A server is strongly encouraged to include at least one ExceptionText value, to provide more information about the detected error than provided by the exceptionCode. When included, multiple ExceptionText values shal l provide hierarchical information about one detected error, with the most significant information listed first. </documentation> </annotation> </element> </sequence> - <attribute name="exceptionCode" use="required" type="string"> - <annotation> <documentation>A code representing the type of this exception, which shall be selected from a set of exceptionCode values specified for the specific service operation and server. </documentation> </annotation> </attribute> - <attribute name="locator" use="optional" type="string"> - <annotation> <documentation>When included, this locator shall indicate to the client where an exception was encountered in servicing the client's operation request. This locator should be included whenever meaningful information can be provided by the server. The contents of this locator will depend on the specific exceptionCode and OWS service, and shall be specified in the OWS Implementation Specification. </documentation> </annotation> </attribute> </complexType> </schema>

A <ServiceExceptionReport> element can contain one or more WFS processing exceptions. The mandatory version attribute is used to indicate the version of the service exception report schema. For this version of the specification, this value is fixed at 2.0.0.

Individual exception messages are contained within the <ServiceException> element. The optional code attribute may be used to associate an exception code with the accompanying message. The optional locator attribute may be used to indicate where an exception was encountered in the request that generated the error.

The following is an example of an exception report. This exception indicates that the VERSION parameter is set to 200, but not 2.0.0.

<ows:ExceptionReport xmlns:wfs="http://www.opengis.net/wfs/2.0"

xmlns:ows="http://www.opengis.net/ows/1.1" xmlns:xlink="http://www.w3.org/1999/xlink"

xmlns:fes="http://www.opengis.net/fes/2.0" xmlns:gml="http://www.opengis.net/gml/3.2"

version="2.0.0">

<ows:Exception exceptionCode="VersionNegotiationFailed"

locator="">

<ows:ExceptionText>No service at version 200</ows:ExceptionText>

</ows:Exception>

</ows:ExceptionReport>