38
Copyright © 2010 Open Geospatial Consortium
10.2.3 DescribeDatasets request XML encoding
optional
Servers may also implement HTTP POST transfer of the DescribeDatasets operation request, using XML encoding only, in accordance with the
tjsDescribeDatasets_request.xsd XML schema.
10.3 DescribeDatasets operation response
10.3.1 DescribeDatasets normal response parameters
The normal response to a valid DescribeDatasets operation request shall be a DatasetDescriptions data structure, which contains descriptions of one or more data tables
for which data is available on this server. The structure of this response is shown in Table 46. Note that the Framework data structure portion of this response is similar to the
equivalent structure in the DescribeFrameworks response.
Table 46 — DescribeDatasets response data structure
Name Definition Data
type Multiplicity and
use
Dataset Descriptions
General description of all datasets available on this
server DatasetDescriptions data
structure, see Table 47 One mandatory
Table 47 — DescribeDatasets response: DatasetDescriptions data structure
Name Definition
Data type and values Multiplicity and
use
service Service type identifier
Character String type, not empty Value is “TJS”
One mandatory version
TJS standard and schema version
Character String type, not empty Value is “1.0”
One mandatory lang
Language of the human- readable text e.g. “en-
CA” Character String type, not empty
Value is an RFC 4646 language tag
One mandatory capabilities
GetCapabilities request URL for this service
implementation URL type
One mandatory Framework
Description of a spatial framework for which data
is available Partial data structure defined in
Table 6, excluding the FrameworkDatasetColumnset
and FrameworkDatasetRowset elements.
One or more mandatory
Note 1: The shaded elements in this table are identical to those in Table 43.
Copyright © 2010 Open Geospatial Consortium
39
10.3.2 DescribeDatasets normal response XML encoding
The DescribeDatsets operation response shall be encoded in XML in accordance with the tjsDescribeDatasets_response.xsd XML schema see Annex B.
10.3.3 DescribeDatasets exceptions
When a TJS server encounters an error while performing a DescribeDatsets operation, it shall return an exception report message as specified in Clause 8 of [OGC 06-121r3]. The
allowed standard exception codes shall include those listed in Table 20 of that document. For each listed exceptionCode, the contents of the “locator” parameter value shall be as
specified in the right column of Table 48.
Table 48 — Exception codes for DescribeDatasets operation
exceptionCode value Meaning of code
“locator” value
OperationNotSupported Request is for an operation that is not supported by this server
Name of operation not supported
MissingParameterValue Operation request does not include a parameter value, and this server did not declare a default
value for that parameter Name of missing
parameter InvalidParameterValue
Operation request contains an invalid parameter value
Name of parameter with invalid value
OptionNotSupported Request is for an option that is not supported
by this server Identifier of option
not supported
NoApplicableCode No other exceptionCode specified by this service
and server applies to this exception None, omit “locator”
parameter NOTE The values listed above are copied from Table 20 in Subclause 8.3 of [OGC 06-121r3].
11 DescribeData operation optional
11.1 Introduction