9.4.2.4 GetResourceByID request XML encoding
A server that implements the GetResourceByID operation may implement HTTP POST transfer of the operation request, using XML andor KVP encoding. The contents and
structure of a GetResourceByID operation request encoded in XML shall be as specified in the attached owsGetResouceByID file.
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.4.3 Operation response
9.4.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.
9.4.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 29. For each listed exceptionCode, the contents of the “locator” parameter value shall be as specified in the right column of
Table 29.
NOTE All the exceptionCode values listed below are copied from Table 25 in Subclause 8.3.
Table 29 — 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.
Copyright © 2006 Open Geospatial Consortium, Inc. All Rights Reserved.
51
For the GetResourceByID operation, the “OptionNotSupported” exceptionCode value shall be used when the client 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”.
9.4.4 Examples 9.4.4.1 GetResourceByID