Implementation requirements GetCapabilities request KVP encoding

Language plus “” return default languageee section 1.2.6 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.

1.1.1 Implementation requirements

The “Multiplicity and use” column in Table 2 specifies the optionality of each listed parameter in the GetCapabilities operation request. Table 2 specifies the implementation of those parameters by OWS clients and servers. Table 2 — 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 Vers ions 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 Sequ ence Zero or one optional a Accept For mats Zero or one optional a AcceptLl an guage 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.

1.1.2 GetCapabilities request KVP encoding

The KVP encoding of the GetCapabilities operation request shall be as shown in Table 3, with example values appropriate for WCS 1.0.0. Table 3 — GetCapabilities operation request URL parameters Name and example a Optionality and use Definition and format service=WCS Mandatory Service type identifier text 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 Comma-separated 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 Comma-separated prioritized sequence of zero or more response formats desired by client, with preferred formats listed first AcceptLl anguage=en- CA,fr-CA Optional When omitted or not supported by server, return human readable text in thea default language of the server ’s choice Comma-separated 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 1.2.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. 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=GetCapabilitiesACCEPTVERSIONS=1.0.0,0.8.3SECTIO NS=ContentsUPDATESEQUENCE=XYZ123 ACCEPTFORMATS=textxml Accept L anguageANGUAGE =en-CA,fr-CA This example includes all six possible parameters, but only the “service” and “request” parameters are required.

1.1.3 GetCapabilities request XML encoding