37
Copyright © 2014 Open Geospatial Consortium
7.2 Capabilities resource Capabilities resource contains metadata about the RESET server’s capabilities, e.g.
identifier, description, restrictions, supported operations, contents, etc.
These capabilities are based on the SPS Capabilities structure, which is itself based on the OWS Capabilities structure, applying the HTTP profile. This profile describes URIs to access
with given HTTP methods to a RESTful web service.
Therefore, it contains links to all the other resources accessible on the server, by describing the URLs that provide access to these resources.
7.2.1 URL
Table 7-1 Capabilities URL
URL Definition
CapabilitiesResourceURL ResetRootPath
ServiceIdentification CapabilitiesResourceURLidentification
ServiceProvider CapabilitiesResourceURLprovider
OperationsMetadata CapabilitiesResourceURLoperations
Notifications CapabilitiesResourceURLnotifications
Contents CapabilitiesResourceURLcontents
38
Copyright © 2014 Open Geospatial Consortium
7.2.2 Definition
The capabilities document is described in the SPS Specification [NR21]. Therefore, the only part described here will be the OperationMetadata, which will create the URIs to access the
other resources.
This structure used is the following:
ows:OperationsMetadata xmlns:ows=http:www.opengis.netows1.1 ows:Operation
ows:DCP ows:HTTP
ows:Get xmlns:xlin=http:www.w3.org1999xlink
xlin:href=
ResetRootPathprocedures{procedure}tasking
ows:Constraint name=procedure ows:AllowedValues
ows:ValueOPTows:Value ows:AllowedValues
ows:AllowedValues ows:ValueSARows:Value
ows:AllowedValues ows:Constraint
ows:Get ows:HTTP
ows:DCP ows:Operation
ows:OperationsMetadata
Figure 7-1 Operation Metadata example
In this example, the operation described is the tasking request description DescribeTasking operation. The URI to task is the one described in the “href” parameter of the Get element,
which is the HTTP method to be used. Within the href parameter, the words between brackets, e.g. {procedure}, are parameters to be filled in when submitting a request. For
example, from this description, the URI to be constructed would be:
ResetRootPathprocedures
OPT
tasking
Figure 7-2 Operation URL example
39
Copyright © 2014 Open Geospatial Consortium
However the OWS specification did not foresee the use of the PUT and DELETE HTTP methods. Neither did it provide a way to add these to the OperationsMetadata structure
without redefining the whole structure. Therefore the OperationsMetadata structure was replaced in the ROSEO specification [NR24]by the following:
ns:resourceURL resource=feasibility methods=POST URL=http:127.0.0.1:8080DreamServicesdreammmfasgmes-mmfas
reset1.0.0feasibility ns:resourceURL resource=feasibility methods=GET
URL=http:127.0.0.1:8080DreamServicesdreammmfasgmes-mmfas reset1.0.0feasibility{taskID}
ns:resourceURL resource=feasibility methods=GET URL=http:127.0.0.1:8080DreamServicesdreammmfasgmes-mmfas
reset1.0.0feasibility{taskID}segments
40
Copyright © 2014 Open Geospatial Consortium
7.2.3 HTTP methods