OGC 06-131r6
Copyright © 2010 Open Geospatial Consortium, Inc.Copyright © 2010 O
characters e.g., general delimiters appearing in identifier values shall be suitably percent-encoded in the KVP representation. The value of an Id message parameter
item identifies a registry object either directly or by an external identifier that corresponds to a child rim:ExternalIdentifier element.
Figure 21: CSW-discovery.xsd 2.0.2 GetRecordById complex type
Table 18 — GetRecordById Operation Parameters
Parameter Data type and value
Optionality
Service Character String.
Fixed value of ‘CSW’ Mandatory
Version Character String.
Fixed value of ‘2.0.2’ Mandatory
OutputFormat CharacterString. The only supported value is ‘applicationxml’ default value
Optional
pen Geospatial Consortium, Inc. 71
Open Geospatial Consortium Inc. OGC 06-131r6
72 Co
Parameter Data type and value
Optionality
OutputSchema CodeList. One of ‘urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0’
default value or ‘http:www.opengis.netcatcsw2.0.2’. Optional
9.2.4.2 GetRecordById Response
If the request is processed successfully, the body of the response message shall include an XML document where the document element has the following infoset
properties:
• A [local name] of ‘GetRecordByIdResponse’, • A [namespace name] of ‘
http:www.opengis.netcatcsw2.0.2 ’
usually represented by the ‘csw’ prefix. The child elements shall be registry object representations i.e. rim:RegistryObject or
some valid substitution element corresponding to the requested identifier. If a match for an external identifier is found, the related registry object is included. If there are
no matching records, an empty response is returned.
The following XML-Schema fragments define the XML format response to a GetRecordById
operation:
Figure 22: CSW-discovery.xsd 2.0.2 GetRecordByIdResponse complex type
9.2.4.3 Examples
Annex E.3 contains GetRecordById request and response examples.
9.2.4.4 Exceptions
If the request is deemed invalid for any reason e.g. missing a required element, the service shall return an ows:ExceptionReport containing a service exception with the
code wrs:InvalidRequest.
pyright © 2010 Open Geospatial Consortium, Inc.
OGC 06-131r6
Copyright © 2010 Open Geospatial Consortium, Inc.Copyright © 2010 O
9.2.5 GetRepositoryItem Operation
The GetRepositoryItem operation is used to retrieve the repository item corresponding to some extrinsic object. In this context, this operation is used to retrieve the GML
document related to the EO Product. If available, the item is included in the body of the response. It shall be an instance of a MIME media type, as indicated by the value
of the Content-Type header field.
9.2.5.1 GetRepositoryItem Request
The request is bound only to the GET method. All reserved characters appearing in parameter values shall be suitably percent-encoded. The request parameters are listed
in the following table:
Table 19 — GetRepositoryItem Operation Parameters
Parameter Data type and value
Optionality
service Character String.
Fixed value of ‘CSW-ebRIM’ Mandatory
request Character String.
Fixed value of ‘GetRepositoryItem’ Mandatory
id CharacterString.
Absolute URI that specifies the identifier of the extrinsic object that describes the item.
Mandatory
9.2.5.2 GetRepositoryItem Response
If the request is processed successfully and a repository item is accessible, the body of the response message shall include the repository item with status code 200. The
Content-Type header shall correctly identify the media type of the enclosed resource. If an additional encoding has been applied to the resource—such as
compression using gzip—this shall be indicated by the Content-Encoding entity header.
In the context of EO Product Extension Package, a GetRepositoryItem request with an id matching a urn:ogc:def:objectType:OGC-CSW-ebRIM-EO::EOProduct
ExtrinsicObject shall return the EO GML attached to this object, if it is available.
9.2.5.3 Examples
Assuming that the catalog contains an EOProduct with id urn:x- dali:sat:Shift0:a21:43733800701100016312I:dn:4377990:4, an example request for
the GML file that represents this EO Product is:
pen Geospatial Consortium, Inc. 73