Copyright © 2010 Open Geospatial Consortium
27
8 GetCapabilities operation mandatory
8.1 Introduction
Like most OGC services, TJS includes a mandatory GetCapabilities operation. This operation allows clients to retrieve service metadata. The response to a GetCapabilities
request shall be an XML document containing service metadata, including specific information about the operations supported by a particular server. This clause specifies
the XML document that a TJS server shall return to describe its capabilities.
8.2 GetCapabilities operation request
The GetCapabilities operation request shall be as specified in Subclauses 7.2 and 7.3 of [OGC 06-121r3]. The value of the “service” parameter shall be “TJS”. The allowed set of
service metadata or Capabilities XML document section names and meanings shall be as specified in Tables 3 and 7 of [OGC 06-121r3], with the additions listed in Table 34
below.
Table 34 — Additional Section name values and meanings
Section name Meaning
Languages Return Languages section in service metadata document
WSDL Return WSDL section in service metadata document
The “Multiplicity and use” column in Table 1 of [OGC 06-121r3] specifies the optionality of each listed parameter in the GetCapabilities operation request. Table 35
specifies the implementation of those parameters by TJS clients and servers.
28
Copyright © 2010 Open Geospatial Consortium
Table 35 —GetCapabilities operation request URL parameters
Names Definition
Data type and values Multiplicity and use
service Service type identifier
Character String type, not empty Value is “TJS”
One mandatory request
Operation name Character String type, not empty
Value is “GetCapabilities” One mandatory
Accept Versions
Prioritized sequence of one or more
specification versions accepted by client,
with preferred versions listed first
Character String type, not empty Value is “1.0”
a
Zero or one optional
When included, return the latest
supported matching version
When omitted, return latest supported
version language
Language identifier for human readable text
Character String type, not empty Value is a two or five character
IETF RFC 4646 language identifier
Zero or one optional
For use see section 7.6
a The identification of versions in the GetCapabilities request takes the abbreviated two-part form “X.Y” instead of the three-part form “X.Y.Z” defined in [OGC 06-121r3]. As such it will not validate correctly using the
XML schemas originally defined by OWS Common 1.1, so an adjusted schema document is included in the zip files bundled with this document.
NOTE 1 The parameters shaded in gray above are largely copied from Table 3 in Subclause 7.3 of this document.
All TJS servers shall implement HTTP GET transfer of the GetCapabilities operation request, using KVP encoding. Servers may also implement HTTP POST transfer of the
GetCapabilities operation request, using XML encoding only.
EXAMPLE 1 To request a TJS capabilities document, a client could issue the
following KVP encoded GetCapabilities operation request with minimum contents: http:foo.barfooservice=TJSrequest=GetCapabilities
8.3 GetCapabilities operation response
