URL Definition Resource root path

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