Implementation requirements GetCapabilities request KVP encoding

Copyright © 2010 Open Geospatial Consortium, Inc. 15

7.2.2 Implementation requirements

The ―Multiplicity and use‖ column in Table 4 specifies the optionality of each listed parameter in the GetCapabilities operation request. Table 4 specifies the implementation of those parameters by OWS clients and servers. Table 4 — Implementation of parameters in GetCapabilities operation request Name Multiplicity Client implementation Server implementation service One mandatory Each parameter shall be implemented by all clients, using specified value Each parameter shall be implemented by all servers, checking that each parameter is received with specified value request One mandatory Accept Versions Zero or one optional Should be implemented by all software clients, using specified values Shall be implemented by all servers, checking if parameter is received with specified values Sections Zero or one optional a Each parameter may be implemented by each client If parameter not provided, shall expect default response If parameter provided, shall allow default or specified response Each parameter may be implemented by each server If parameter not implemented or not received, provide default response If parameter implemented and received, provide specified response update Sequence Zero or one optional a Accept Formats Zero or one optional a AcceptLan guages Zero or one optional Should be implemented by all clients Shall be implemented by servers offering multilingual capabilities a A specific OWS is allowed to make mandatory or prohibit server implementation of this parameter. If a specific OWS makes server implementation mandatory, then this parameter can also be made mandatory in the operation request, requiring client implementation of this parameter. Similarly, if a specific OWS prohibits server implementation of this parameter, then the parameter should also be prohibited in the operation request, prohibiting client implementation of this parameter.

7.2.3 GetCapabilities request KVP encoding

The KVP encoding of the GetCapabilities operation request shall be as shown in Table 5, with example values appropriate for WCS 1.0.0. 16 Copyright © 2010 Open Geospatial Consortium, Inc. Table 5 — GetCapabilities operation request URL parameters Name and example a Optionality and use Definition and format Service=WCS Mandatory Abbreviated service type identifier text b Request=GetCapabilities Mandatory Operation name text AcceptVersions=1.0.0,0.8.3 Optional When omitted, return latest supported version see Subclause 7.3.2 Prioritized sequence of one or more specification versions accepted by client, with preferred versions listed first Sections=Contents Optional When omitted or not supported by server, return complete service metadata document Comma-separated unordered list of zero or more names of sections of service metadata document to be returned in service metadata document UpdateSequence=XXX where XXX is character string previously provided by server Optional When omitted or not supported by server, return latest service metadata document version Service metadata document version, value is ―increased‖ whenever any change is made in complete service metadata document AcceptFormats= textxml Optional When omitted or not supported by server, return service metadata document using MIME type textxml Prioritized sequence of zero or more response formats desired by client, with preferred formats listed first AcceptLanguages=en- CA,fr-CA Optional When not supported by server, return human readable text in a language of the server’s choice List of languages desired by the client for all human readable text in the response, in order of preference. For every element, the first matching language available from the server shall be present in the response. See section 7.3.6 a All parameter names are listed here using mostly lower case letters. However, any parameter name capitalization shall be allowed in KVP encoding, see Subclause 11.5.2. b A specific OWS specification shall define the abbreviated service type identifier to be used by all implementing services. In a specific OWS Implementation Specification, this table shall be supported by specification of the section names allowed in the Sections parameter, with the meaning of each value for that specific OWS. These section names and meanings shall be based on Subclause 7.4.2. An example of a GetCapabilities request message encoded using KVP is: http:hostname:portpath?SERVICE=WCSREQUEST=GetCapabilitiesACCEPTVER SIONS=1.0.0 0.8.3SECTIONS=ContentsUPDATESEQUENCE=XYZ123 ACCEPTFORMATS=textxmlACCEPTLANGUAGES=en-CA fr-CA This example includes all six possible parameters, but only the ―SERVICE‖ and ―REQUEST‖ parameters are required. Copyright © 2010 Open Geospatial Consortium, Inc. 17

7.2.4 GetCapabilities request XML encoding