Copyright © 2010 Open Geospatial Consortium, Inc.
51 g May change the name of the ResourceID parameter
h May restrict the multiplicity of the ResourceID andor OutputFormat parameters i May restrict or expand the required and allowed types of operation request encoding
j May specify additional exception codes
9.3.2 Operation request
9.3.2.1 GetResourceByID request parameters
A request to perform the GetResourceByID operation shall include the parameters described in Figure 10 and specified in Table 30.
GetResourceByID + resourceID [1..] : URI
+ outputFormat [0..1] : CharacterString RequestBase {Abstract}
+ service : CharacterString + request : CharacterString
+ version : CharacterString
from OWS Get Capabi lites
Figure 10 — GetResourceByID request UML class diagram
52
Copyright © 2010 Open Geospatial Consortium, Inc. NOTE
The first three parameters listed below with grey background are largely copied from Table 29 in Subclause 9.2.1. The ResourceID parameter is adapted from the Identifier parameter in Table 35 in
Subclause 10.6.1. The OutputFormat parameter is largely copied from Table 35.
Table 30 — Parameters in GetResourceByID operation request
Names Definition
Data type and value Multiplicity and use
service service
Service type identifier Character String type, not empty
Value is OWS type abbreviation, for example ―WPS‖
One mandatory
request request
Operation name Character String type, not empty
Value is operation name, for example ―GetResourceByID‖
One mandatory
version version
Specification version for operation
Character String type, not empty Value is specified by each Profile
and Schemas version One mandatory
resourceID ResourceID
Unambiguous identifier of desired resource
a
URI Values defined in service
metadata Capabilities or in other metadata known to client
One or more mandatory One for each resource
requested
b
output Format
Output Format
Reference to format in which operation
output data should be encoded
Character String type, not empty Values are specified in service
metadata Capabilities Zero or one optional
Include when are multiple alternatives and default
format not desired
a If there are multiple versions of the same basic resource, each version shall have a different ResourceID. The
version may be identified within that ResourceID, but this version shall be opaque to OWS servers. b
A specific OWS may allow a ResourceID value of ―AllResources‖ to specify that all resources shall be returned, but only if this operation may return resources from only one category. However, allowing this
―AllResources‖ value is discouraged, since returning all resources could require a server to return a huge response when there are a large number of resources. If allowed, this ―AllResources‖ value shall be case sensitive, and may
be rejected when a server chooses not to return all of many resources in one operation response. If rejected, the service shall return an OptionNotSupported exception.
Whenever practical, a specific OWS that uses this GetResourceByID operation should limit the allowed output formats to XML encoded data. When that is done, the Output
Format parameter included above shall be omitted or prohibited.
9.3.2.2 ResourceID values