DescribeFrameworks normal response parameters DescribeFrameworks normal response XML encoding DescribeFrameworks exceptions

Copyright © 2010 Open Geospatial Consortium 35

9.3 DescribeFrameworks operation response

9.3.1 DescribeFrameworks normal response parameters

The normal response to a valid DescribeFrameworks operation request shall be a FrameworkDescriptions data structure, which contains descriptions of one or more Frameworks for which data is available on this server. The structure of this response is shown in Table 42. Table 42 — DescribeFrameworks response data structure Name Definition Data type Multiplicity and use Framework Descriptions Full description of all spatial frameworks for which data is available FrameworkDescriptions data structure, see Table 43 One mandatory Table 43 — DescribeFrameworks response: FrameworkDescriptions data structure Name Definition Data type and values Multiplicity and use service Service type identifier Character String type, not empty One mandatory Value is “TJS” version TJS standard and schema version Character String type, not empty One mandatory Value is “1.0” lang RFC 4646 language tag of the human-readable text e.g. “en-CA” Character String type, not empty 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 FrameworkDataset element. One or more mandatory Note 1: The values for the shaded elements in this table are identical to those submitted as part of the DescribeFrameworks request and documented in Table 41.

9.3.2 DescribeFrameworks normal response XML encoding

The DescribeFrameworks operation response shall be encoded in XML in accordance with the tjsDescribeFrameworks_response.xsd XML schema see Annex B. A valid DescribeFrameworks operation response encoded in XML is shown in Annex C.

9.3.3 DescribeFrameworks exceptions

When a TJS server encounters an error while performing a DescribeFrameworks operation, it shall return an exception report message as specified in Clause 8 of [OGC 36 Copyright © 2010 Open Geospatial Consortium 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 44. Table 44 — Exception codes for DescribeFrameworks 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]. 10 DescribeDatasets operation optional

10.1 Introduction