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