54
Copyright © 2010 Open Geospatial Consortium, Inc. NOTE
A specific OWS specification is allowed to make server implementation of HTTP POST transfer of XML and KVP encoding of the GetResourceByID operation request optional, mandatory, or
prohibited. If optional, profiles of that specification are allowed to make HTTP POST transfer of the GetResourceByID operation request mandatory or prohibited.
9.3.3 Operation response
9.3.3.1 GetResourceByID normal response
The normal response to a GetResourceByID operation request shall be one or more resources. These resources should be encoded in GML 3 or other XML, but image and
other more-compact formats may be used. GML 3 should be used when applicable, including gml:Dictionary for encoding a list of gml:Definition objects. These resources
shall be encoded using parameters specified in Clause 10 of this document whenever applicable. The response may be a XML Schema. Specific OWS specifications shall
specify that servers may implement SOAP 1.2 transfer of GetResourceID operation responses, as specified in Subclause 11.8, using the same XML encoding.
9.3.3.2 Exceptions
When a server encounters an error while performing a GetResourceByID operation, it shall return an exception report message as specified in Subclause 7.4. The allowed
exception codes shall include those listed in Table 32. For each listed exceptionCode, the contents of the ―locator‖ parameter value shall be as specified in the right column of
Table 32.
NOTE All the exceptionCode values listed below are copied from Table 27 in Subclause 8.3.
Table 32 — GetResourceByID exception codes and meanings
exceptionCode value Meaning of code
―locator‖ value
OperationNotSupported Request is for an operation that is not supported
by this server Name of operation
not supported MissingParameterValue
Operation request does not include a parameter value, and this server did not declare a default
value for that parameter Name of missing
parameter InvalidParameterValue
Operation request contains an invalid parameter value
a
Name of parameter with invalid value
OptionNotSupported Request is for an option that is not supported by
this server Identifier of option
not supported NoApplicableCode
No other exceptionCode specified by this service and server applies to this exception
None, omit ―locator‖ parameter
a When an invalid parameter value is received, it seems desirable to place the invalid values in
ExceptionText strings associated with the InvalidParameterValue value.
For the GetResourceByID
operation, the ―OptionNotSupported‖ exceptionCode value shall be used when the clie
nt specifies a ResourceID value of ―AllResources‖ but there are more resources than this server chooses to return in one operation response. In this
case, the ―locator‖ value shall be ―AllResources‖.
Copyright © 2010 Open Geospatial Consortium, Inc.
55
9.3.4 Examples