OGC 07-045
sensitive manner. Table 26 summarizes the CSWT ISO operations and their encoding methods that are
applied in this profile. The mandatory method bindings and data encodings are printed in bold.
Table 26 - Operation request encoding
CSWT ISO Operation Request encoding
GetCapabilities XMLPOST+SOAP and
KVP GET XML POST+SOAP and KVP GET
DescribeRecord
XML POST+SOAP and KVPGET GetDomain
XML POST+SOAP and KVPGET GetRecords
XML POST+SOAP and KVPGET GetRecordById
XML POST+SOAP and KVPPOST Harvest
XML POST+SOAP Transaction
8.2 Interface specifications
This chapter describes syntax and semantics restrictions and variations of the interface operations in comparison to those of the imported CSW 2.0.2 HTTP protocol binding
22
. It gives formal, language-independent interface specifications W3C WSDL that admit
multiple programming language bindings and shows error conditions that can occur.
8.2.1 OGC_Service Interface
8.2.1.1 GetCapabilities Operation
The GetCapabilities operation allows clients to retrieve service metadata from a server. The GetCapabilities operation request is defined in Subclause 7.2 of the OGC Web
Services Common Specification 1.0 [OGC 05-008C1]. The column ISO Metadata Profile in table 26 shows syntax andor semantics restrictions or variations of some
parameters in comparison to those of the base specification. Note that all parameter names in the KVP-encoded request must be treated in a case insensitive manner, and the
query component of the Request-URI in the GET request must be appropriately escaped.
22
Further details can be found in the OGC Catalog Services Specification [OGC 07-006].and the OGC Web Services Common Specification [OGC 05-008]
Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved. 61
OGC 07-045
The response to a GetCapabilities request should be an XML document containing service metadata about the server [OGC 05-008C1, and OGC 07-006]. See also section
7.5 for the content of the response document.
Table 27 – Some Parameters in GetCapabilities operation request Definition
Data type and value Multiplicity
and use
ISO Metadata Profile
Name
SERVICE Service type
identifier Character String
type, not empty Value is OWS type
abbreviation e.g., “CSW”,
“WFS” One
mandatory “CSW”
REQUEST Operation name
Character String type, not empty
Value is operation name
e.g., “GetCapabilities”
GetCapabilities GetCapabilities
The value of the service parameter must be “CSW”. The request response sequence of a handshake between a CSW AP ISO client and a CSW server and a following operation
call getRecords is as follows see also figure 9: the client first asks the CSW server for the capabilities with service = CSW. In the capabilities document the serviceType
must be set to CSW”. If the ‘operations constraint” ‘IsoProfiles’ see 7.5 is included in the Capabilities document the CSW server is identified as an ISO profile server.
In the following operation call e.g. a getRecords calls the service attribute must also be set to CSW”. The AP ISO server can now be queried in the AP ISO mode, which
includes the usage of the specific ISO typeNames, queryables and outputSchemas. If the server could only be identified as an OGC Core server it can be queried only in the Core
mode which includes the usage only of the Core typeName, queryables and outputSchema.
62 Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved.
OGC 07-045
Figure 10: Schematic profile dependant getRecords call profile determined by handshake
The sections parameter may be used to request a subset of the complete capabilities document; the value is a comma-separated list of section names. Valid set of section
names recognized by this profile are listed in
Table 28
. If this parameter is absent, the complete description must be returned; unrecognized section names are ignored.
Table 28 – Permissible section names
Section name Content
ServiceIdentification General information about the service type,
version, etc..
Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved. 63
OGC 07-045
ServiceProvider Information about the organization providing
the service. OperationsMetadata
Summarizes the operational characteristics of the service.
Filter_Capabilities Describes supported OGC filter operators
The WSDL portType component of the OGC_Service interface is shown in Listing 1; this is a fragment of the complete WSDL 2.0 definition for the CSW Catalogue capability
class Annex C.
Listing 1 - OGC_Service: WSDL interface definition
wsdl:portType name=csw wsdl:operation
name=csw.getCapabilities wsdl:input
message=csw-req:GetCapabilitiesRequest wsdl:output
message=csw-resp:GetCapabilitiesResponse wsdl:fault
name=ServiceExceptionReport message=csw-
resp:ServiceExceptionReport wsdl:operation
8.2.2 CSW Discovery Interface