OGC 06-156
Open Geospatial Consortium
OGC Doc 06-156
CR-Form-v3
CHANGE REQUEST
Catalog
CR ?
rev-
Current version: 2.0.1 For HELP on using this form, look at the pop-up text over the symbols.
Proposed change affects: AS Imp Spec X Best Practices Paper Other
Title: Catalog change request - Correct csw:RequestBaseType
Source: Arliss Whiteside
Work item code: Date: 2006-11-08
Category: F
Use one of the following categories:
F (Critical correction)
A (corresponds to a correction in an earlier release)
B (Addition of feature),
C (Functional modification of feature)
D (Editorial modification)
Reason for change: The current XML encoding of the csw:RequestBaseType is incorrect, allowing omission of the “service” and “version” attributes. This is not consistent with the text, KVP encoding, or OWS Common [OGC 05-008].
Summary of change: Correct the XML encoding of the csw:RequestBaseType to require inclusion of the “service” and “version” attributes, with “fixed” values instead of “default” values. Also correct the value of the “service” attribute in CSW-discovery.xsd from http://www.opengis.net/cat/csw to “CSW”, also for consistency with text, KVP encoding, and OWS Common [OGC 05-008].
Consequences if
not approved:
Minimum implementations of the CSW protocol binding using XML encoding will be incorrect and inconsistent, preventing interoperability.
Clauses affected: 10.3.6, CSW-discovery.xsd
Other specs Other core specifications
Affected: Abstract specifications
Recommendation Papers
Other comments:
OGC 06-156
Edit Subclause 10.3.6 as follows:
10.3.6 Common request parameters
All CSW operation requests except for GetCapabilities shall include the three parameters specified in Table 20 of [04-016r2]. Only one of these parameters is included in the general catalogue model, the others are specific to the HTTP protocol binding.
In KVP encoding, these common parameters in CSW operation requests are encoded as shown in Table 56. Note that the parameter names in all KVP encodings must be handled in a case insensitive manner.
Table 56 — KVP encoding of common operation request parameters
Keyword Datatype and value Optionality Parameter in general model
REQUEST Character String type
Value is operation name (e.g., “DescribeRecord”)
In XML encoding, all operation request elements, except for GetCapabilities, are extended from the following XML Schema fragment:
<xsd:complexType name="RequestBaseType" abstract="true">
<xsd:complexContent>
<xsd:extension base="ows:RequestBaseType">
<xsd:attribute name="service" type="xsd:string"
use="optionalrequired" defaultfixed="CSW"/>
<xsd:attribute name="version" type="xsd:string"
use="required" fixed="2.0.1"/>
</xsd:extension> </xsd:complexContent>
</xsd:complexType>
The “service” parameter is used to indicate that the request is a CSW request. This parameter must be specified for all CSW requests. The “version” parameter is used to indicate that the associated CSW request conforms to this specification. This is indicated by setting the value of the version parameter to 2.0.0. This XML Schema fragment does not include a “request” attribute, since the name of the operation requested is always the name of the XML element encoding the request.
Edit the definition of the RequestBaseType in the XML Schema
Document CSW-discovery.xsd as follows:
<xsd:complexType name="RequestBaseType" id="RequestBaseType" abstract="true">
<xsd:annotation>
OGC 06-156
<xsd:documentation>
Base type for all request messages except GetCapabilities. The attributes identify the relevant service type and version.
</xsd:documentation>
</xsd:annotation>
<xsd:attribute name="service" type="ows:ServiceType" use="optionalrequired"
defaultfixed="http://www.opengis.net/cat/cswCSW"/>
<xsd:attribute name="version" type="ows:VersionType"
use="optionalrequired"defaultfixed="2.0.1"/>
</xsd:complexType>