Copyright © 2010 Open Geospatial Consortium
19 7.6.3 Standard presentation parameters
7.6.3.1 Parameter Semantics
Standard presentation parameters see Figure 4 are used to control how query results are presented in a response document. These parameters may appear in the GetPropertyValue see Clause 10, GetFeature
see Clause 11 and GetFeatureWithLock see Clause 13 operations.
StandardPresentationParameters + resultType : ResultType = results
+ outputFormat : CharacterString = applicationgml+xml; version=3.2 + count [0..1] : Integer
+ startIndex : Integer = 0 ResultType
+ results + hits
Enumeration
Figure 4 — StandardPresentationParameters 7.6.3.2
XML encoding
The following fragment defines the XML encoding to the standard presentation parameters:
xsd:attributeGroup name=StandardPresentationParameters xsd:attribute name=startIndex
type=xsd:nonNegativeInteger default=0 xsd:attribute name=count
type=xsd:nonNegativeInteger xsd:attribute name=resultType
type=wfs:ResultTypeType default=results xsd:attribute name=outputFormat
type=xsd:string default=applicationgml+xml; version=3.2 xsd:attributeGroup
xsd:simpleType name=ResultTypeType xsd:restriction base=xsd:string
xsd:enumeration value=results xsd:enumeration value=hits
xsd:restriction xsd:simpleType
7.6.3.3 KVP encoding
Table 5 defines the KVP encoding of the standard presentation parameters.
20
Copyright © 2010 Open Geospatial Consortium
Table 5 — KVP-encoding of standard presentation parameters
URLComponent Operation OMa
Default Description
STARTINDEX GetPropertyValue, GetFeature,
GetFeatureWithLock O 1
See 7.6.3.4.
COUNT GetPropertyValue, GetFeature,
GetFeatureWithLock O 1
See 7.6.3.5.
OUTPUTFORMAT DescribeFeatureType, GetPropertyValue,
GetFeature, GetFeatureWithLock
O applicationgml+xml; version=3.2
See 7.6.3.7.
RESULTTYPE GetPropertyValue, GetFeature,
GetFeatureWithLock O results
See 7.6.3.6.
a O = Optional, M = Mandatory
7.6.3.4 startIndex parameter
For XML-encoded requests this parameter shall be encoded using an attribute named startIndex see 7.6.3.2. For KVP-encoded requests this parameter shall be encoded using the STARTINDEX keyword see 7.6.3.3.
The optional startIndex parameter indicates the index within the result set from which the server shall begin presenting results in the response document.
7.6.3.5 count parameter
For XML-encoded requests this parameter shall be encoded using an attribute named count see 7.6.3.2. For KVP-encoded requests this parameter shall be encoded using the COUNT keyword see 7.6.3.3.
The optional count parameter limits the number of explicitly requested values i.e. features or property values that are presented in a response document.
Only values of the types explicitly requested as the value of the typeNames parameter see 7.9.2.4.1 shall be counted in the tally. Nested values contained within the explicitly requested value types shall not be counted.
EXAMPLE The tally of features in the following XML fragment is 4. The embedded reference to the feature with
gml:id=2 and the feature with gml:id=5, which is that value abc:Prop4, are not included in the tally.
?xml version=1.0? wfs:FeatureCollection
timeStamp=2010-08-01T22:47:02 numberMatched=4 numberReturned=4
xmlns:myns=http:www.someserver.commyns xmlns:wfs=http:www.opengis.netwfs2.0
xmlns:gml=http:www.opengis.netgml3.2 xmlns:xlink=http:www.w3.org1999xlink
xmlns:xsi=http:www.w3.org2001XMLSchema-instance xsi:schemaLocation=http:www.someserver.commyns .myns.xsd
http:www.opengis.netwfs2.0 http:schemas.opengis.netwfs2.0.0wfs.xsd
http:www.opengis.netgml3.2 http:schemas.opengis.netgml3.2.1gml.xsd
wfs:member myns:Feature gml:id=1
... myns:Feature
wfs:member
Kategori