DescribeDatasets normal response parameters DescribeDatasets normal response XML encoding DescribeDatasets exceptions

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