NAMESPACE parameter requestId parameter resultType parameter

xsd:complexType xsd:simpleType name=ElementSetType id=ElementSetType xsd:restriction base=xsd:string xsd:enumeration value=brief xsd:enumeration value=summary xsd:enumeration value=full xsd:restriction xsd:simpleType

10.8.4 Parameter descriptions

10.8.4.1 NAMESPACE parameter

The NAMESPACE parameter is included in the KVP encoding to allow clients to bind any namespace prefixes that might be used for qualified names specified in other parameters. For example, the typeName parameter may include qualified names of the form namespace prefix:name. The value of the NAMESPACE parameter is a comma separated list of character strings of the form xmlns[prefix=]namespace url. Not including the name namespace prefix binds the specified URL to the default namespace. As in XML, only one default namespace may be bound. This parameter is not required for the XML encoding since XML includes a mechanism for binding namespace prefixes.

10.8.4.2 requestId parameter

The requestId parameter may be included to uniquely identify this request message. If the client specifies a requestId in its request, the server shall use it in its responses. If the client does not specify a requestId but includes a ResponseHandler in its request and if the service supports asynchronous processing, the server shall generate a requestId and put it in the acknowledgement message and in the response. If the client specifies neither a requestId nor a ResponseHandler in its request, the server shall not put a requestId in its response. Whether generated by the client or by the server, the requestId specified shall include a UUID Universal Unique Identifier, generated using the mechanism described in the X.667 specification. The ResponseHandler should use requestId as part of it value.

10.8.4.3 resultType parameter

The resultType parameter may have the value “hits”, “results”, or “validate”; the value determines whether the catalogue service returns just a summary of the result set, includes one or more records from the result set, or validates the request message and processes it asynchronously. If the resultType parameter is set to “hits”, the catalogue service shall return a GetRecordsResponse element containing an empty SearchResults element that Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved. 147 indicates the estimated size of the result set. Optional attributes may or may not be set accordingly. If the resultType parameter is set to “results”, the catalogue service shall include any matching records within the SearchResults element, up to the maximum number of records specified in the request. If the resultType parameter is set to “validate”, the catalogue service shall validate the request and return an Acknowledgement message if validation succeeds. An ows:ExceptionReport element, as described in Subclause 10.3.7, is returned if validation fails. If the catalogue supports asynchronous query processing, the acknowledgment response shall include a RequestId element that may be subsequently used to retrieve the result set when processing is complete.

10.8.4.4 outputFormat parameter