GetCapabilities request parameters GetCapabilities request

7.2 GetCapabilities request

7.2.1 GetCapabilities request parameters

A request to perform the GetCapabilities operation shall use the data structure described in Figure 2 and specified in Table 3. Section + serviceIdentification + serviceProvider + operationsMetadata + contents + all CodeList GetCapabilities + service : CharacterString + request : CharacterString = GetCapabilities {frozen} + acceptVersions [0..1] : SequenceCharacterString + sections [0..1] : ListSection + acceptFormats [0..1] : SequenceCharacterString + updateSequence [0..1] : CharacterString Figure 2 — GetCapabilities operation request UML class diagram Copyright © 2006 Open Geospatial Consortium, Inc. All Rights Reserved. 13 Table 3 — Parameters in GetCapabilities operation request Names a Definition Data type and value Multiplicity and use service service Service type identifier Character String type, not empty Value is OWS type abbreviation e.g., “WMS”, “WFS” One mandatory request request Operation name Character String type, not empty Value is operation name e.g., “GetCapabilities” One mandatory accept ‌Versi ons Accept ‌Vers ions Prioritized sequence of one or more specification versions accepted by client, with preferred versions listed first Sequence of Character String type, each not empty Value is list of x.y.z “version” values Zero or one optional When omitted, return latest supported version see Subclause 7.3.2 sections Sections Unordered list of zero or more names of requested sections in complete service metadata document b Sequence of Character String type, each not empty Value is list of section names Allowed section names are specified by each Implementation Specification Zero or one optional When omitted or not supported by server, return complete service metadata document update ‌Sequ ence update ‌Sequ ence Service metadata document version, value is “increased” whenever any change is made in complete service metadata document Character String type, not empty Values are selected by each server, and are always opaque to clients Zero or one optional When omitted or not supported by server, return latest service metadata document accept ‌Form ats Accept ‌For mats Prioritized sequence of zero or more response formats desired by client, with preferred formats listed first Sequence of Character String type, each not empty Value is list of format identifiers Identifiers are MIME types of formats useful for service metadata documents Zero or one optional When omitted or not supported by server, return service metadata document using MIME type textxml a Although some values listed in the “Name” column appear to contain spaces, they shall not contain spaces. b The “Sections” parameter specifies which XML elements within a service metadata document shall be returned, within a usually abbreviated “Capabilities” element. The allowed section name values shall be specified by each Implementation Specification, as specified in Subclause 7.3.3. NOTE 1 The name capitalization rules used here are specified in Subclauses 5.5 and 11.6.2. NOTE 2 The data type of many parameters is specified as “Character String type, not empty”. In the XML Schemas specified herein, these parameters are encoded with the xsd:string type, which does NOT require that these strings not be empty.

7.2.2 Implementation requirements