XML encoding Response GetDomain operation

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. b Parameter keywords are case insensitive for KVP encoding. Parameters values are case sensitive..

10.7.3 XML encoding

The following XML-Schema fragment defines that XML encoding for the GetDomain operation request: xsd:element name=GetDomain type=csw:GetDomainType xsd:complexType name=GetDomainType xsd:complexContent xsd:extension base=csw:RequestBaseType xsd:sequence xsd:choice xsd:element name=PropertyName type=xsd:anyURI xsd:element name=ParameterName type=xsd:anyURI xsd:choice xsd:sequence xsd:extension xsd:complexContent xsd:complexType Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved. 139

10.7.4 Parameter descriptions

10.7.4.1 PropertyName parameter

The PropertyName parameter is used to specify the name of a property that is defined in the information model for which value domain information is desired. An example of a property name might be the name of one of the core queryable properties described in Subclause 6.3.2. The PropertyName value may be specified using an absolute or a relative URI; the precise syntax or permissible values are defined in an application profile.

10.7.4.2 ParameterName parameter

The ParameterName parameter is used to specify the name of an interface parameter for which value domain information is desired. Table 64 defines the list of interface parameters that may be interrogated using the GetDomain operation. Table 64 — Interface parameters that may be interrogated using GetDomain operation Parameter Name GetRecords.resultType GetRecords.outputFormat GetRecords.outputRecType GetRecords.typeName GerRecords.ElementSetName GetRecords.ElementName GetRecords.CONSTRAINTLANGUAGE GetRecordById.ElementSetName DescribeRecord.typeName DescribeRecord.schemaLanguage

10.7.5 Response

The following XML-Schema fragment defines the response to a GetDomain operation. xsd:element name=GetDomainResponse type=csw:GetDomainResponseType xsd:complexType name=GetDomainResponseType xsd:sequence xsd:element name=DomainValues type=csw:DomainValuesType maxOccurs=unbounded xsd:sequence xsd:complexType xsd:complexType name=DomainValuesType xsd:sequence xsd:choice xsd:element name=PropertyName type=xsd:QName 140 Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved. xsd:element name=ParameterName type=xsd:QName xsd:choice xsd:choice minOccurs=0 xsd:element name=ListOfValues type=csw:ListOfValuesType xsd:element name=ConceptualScheme type=csw:ConceptualSchemeType xsd:element name=RangeOfValues type=csw:RangeOfValuesType xsd:choice xsd:sequence xsd:attribute name=type type=xsd:QName use=required xsd:attribute name=uom type=xsd:anyURI use=optional xsd:complexType xsd:complexType name=ListOfValuesType xsd:sequence xsd:element name=Value type=xsd:anyType maxOccurs=unbounded xsd:sequence xsd:complexType xsd:complexType name=ConceptualSchemeType xsd:sequence xsd:element name=Name type=xsd:string xsd:element name=Document type=xsd:anyURI xsd:element name=Authority type=xsd:anyURI xsd:sequence xsd:complexType xsd:complexType name=RangeOfValuesType xsd:sequence xsd:element name=MinValue type=xsd:anyType xsd:element name=MaxValue type=xsd:anyType xsd:sequence xsd:complexType The response is composed of one or more DomainValues elements. The domain values may be a list of enumerated values i.e. ListOfValues, one or more ranges of values i.e. RangeOfValues, or a reference to some authoritative vocabulary i.e. ConceptualScheme . An example of an authoritative vocabulary might be a standard list of animal and plant species names. If the only child element of the DomainValue element is the PropertyName or ParameterName element, this shall be taken to mean that the catalogue was unable to determine anything about the specified property or parameter.

10.7.6 Examples