Introduction KVP encoding GetDomain operation

10.6.6 Examples

KVP encoded example http:www.someserver.comcswcsw.cgi?request=DescribeRecordversion=2.0 .2outputFormat=applicationxmlschemaLanguage=XMLSCHEMAtypeName=csw:Re cordnamespace=xmlnscsw=http:www.opengis.orgcatcsw XML encoded example ?xml version=1.0 encoding=ISO-8859-1? DescribeRecord service = CSW version = 2.0.2 outputFormat = applicationxml schemaLanguage = http:www.w3.org2001XMLSchema xmlns = http:www.opengis.netcatcsw2.0.2 xmlns:csw = http:www.opengis.netcatcsw2.0.2 xmlns:xsi = http:www.w3.org2001XMLSchema-instance xsi:schemaLocation = http:www.opengis.netcatcsw2.0.2 ......csw2.0.2CSW-discovery.xsd TypeName csw:Record TypeName DescribeRecord

10.7 GetDomain operation

10.7.1 Introduction

The optional GetDomain operation is used to obtain runtime information about the range of values of a metadata record element or request parameter. The runtime range of values for a property or request parameter is typically much smaller than the value space for that property or parameter based on its static type definition. For example, a property or request parameter defined as a 16bit positive integer in a database may have a value space of 65535 distinct integers but the actual number of distinct values existing in the database may be much smaller. This type of runtime information about the range of values of a property or request parameter is useful for generating user interfaces with meaningful pick lists or for generating query predicates that have a higher chance of actually identifying a result set. It should be noted that the GetDomain operation is a “best-effort” operation. That is to say that a catalogue tries to generate useful information about the specified request parameter or property if it can. It is entirely possible that a catalogue may not be able to determine anything about the values of a property or request parameter beyond the basic type; in this case only a type reference or a type description will be returned.

10.7.2 KVP encoding

Table 64 specifies the keyword-value pair encoding for the GetDomain operation request. 138 Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved. NOTE To reduce the need for readers to refer to other parts of this document, the first three parameters listed below are copied from Table 57 in Subclause 10.3.5 of this document. Table 63 — KVP encoding for GetDomain operation request Keyword b Data type and value Optionality and use Parameter in general model REQUEST Character String Fixed value of GetDomain, case insensitive One Mandatory a none service Character String Fixed values of “CSW” One Mandatory serviceId version Character String Fixed value of 2.0.2 One Mandatory none ParameterName List of Character String, comma separated Unordered list of names of requested parameters, of the form OperationName.ParameterName Zero or one Conditional Include when PropertyName not included parameterName PropertyName List of Character String, comma separated Unordered list of names of requested properties, from the information model that the catalogue is using Zero or one Conditional Include when ParameterName not included parameterName a The REQUEST parameter contains the same information as the name of the GetDomain element in XML encoding.