Response Exceptions ListStoredQueries operation .1 Request Semantics

Copyright © 2010 Open Geospatial Consortium 85 14.4 DescribeStoredQueries operations

14.4.1 Request Semantics

The DescribeStoredQueries operation see Figure 25 provides detailed metadata about each stored query expression that a server offers. Desc ribeStoreQueries + storedQueryId [0..] : URI BaseRequest + service : CharacterString = WFS {frozen} + version : CharacterString = 2.0.0 {frozen} + handle [0..1] : Charact erSt ring Figure 25 — DescribeStoredQueries request 14.4.2 XML encoding The following XML Schema fragments defines the XML-encoding for the DescribeStoredQueries operation: xsd:element name=DescribeStoredQueries type=wfs:DescribeStoredQueriesType xsd:complexType name=DescribeStoredQueriesType xsd:complexContent xsd:extension base=wfs:BaseRequestType xsd:sequence xsd:element name=StoredQueryId type=xsd:anyURI minOccurs=0 maxOccurs=unbounded xsd:sequence xsd:extension xsd:complexContent xsd:complexType The wfs:DescribeStoredQueries element contains zero or more wfs:StoredQueryId elements that enumerate the identifiers of the stored queries to describe. If no wfs:StoredQueryId elements are specified then all stored queries offered by a server shall be described.

14.4.3 KVP encoding

Table 21 defines the KVP-encoding for the DescribeStoredQueries operation. 86 Copyright © 2010 Open Geospatial Consortium Table 21 — Keywords for DescribeStoredQueries KVP-encoding URL Component OMa Description Common Keywords REQUEST=DescribeStoredQueries See Table 7 Only keywords for all operations or the DescribeStoredQueries operation. STOREDQUERY_ID O A comma-separated list of stored query identifiers to describe. If the keyword is not specified then all stored queries offered by a server shall be described. A O = Optional, M = Mandatory 14.4.4 Response 14.4.4.1 Response semantics Figure 26 describes the response to a DescribeStoredQueries operation. DescribeS toredQueriesResponse + query [0. .] : StoredQueryDesc ription ParameterExpression + name : LocalName + type : ScopedName + title [0..] : LocalisedCharacterString + abstract [0..] : LocalisedCharacterString + metadata [0..] : Any StoredQueryDescription + title [0..] : LocalisedCharacterString + abstract [0..] : LocalisedCharacterString + metadata [0. .] : Any + id : URI + parameter [ 0..] : ParameterExpression + queryExpressionText [ 0..] : QueryExpressionText QueryE xpressionText + any [0..] : Any + ret urnFeatureTypes [1..] : ScopedName + language : URI + isPrivate : Boolean = false Figure 26 — DescribeStoredQueriesResponse 14.4.4.2 XML encoding The following XML Schema fragment defines the response to a DescribeStoredQueries operation: xsd:element name=DescribeStoredQueriesResponse type=wfs:DescribeStoredQueriesResponseType xsd:complexType name=DescribeStoredQueriesResponseType xsd:sequence xsd:element name=StoredQueryDescription type=wfs:StoredQueryDescriptionType minOccurs=0 maxOccurs=unbounded xsd:sequence xsd:complexType The response contains one or more wfs:StoredQueryDescription elements each describing a stored query. See 14.2 for a description of the wfs:StoredQueryDescriptionType type.