Order Options OGC RESTful Encoding of Ordering Services Framework For Earth Observation Products

139 Copyright © 2014 Open Geospatial Consortium Requirement http:www.opengis.netspecROSEO1.0reqCoreCapabilitiesresourcecancel The ROSEO Server shall return a Capabilities document including: ฀ Either CapabilitiesContentsCancelCapabilitiessupported = true ฀ Or at least one element CapabilitiesContentsSupportedCollectionCancelCapabilitiessupported = true Requirement http:www.opengis.netspecROSEO1.0reqCoreCapabilitiesexception When a ROSEO Server encounters an error while returning a Capabilities resource, it shall return: ฀ HTTP Status Code: 4XX for errors on the client side; 5XX for errors on server side as specified in Table 7-9. ฀ HTTP Entity Body: an ows:ExceptionReport according to the clause 8 of [NR9].

8.2 Order Options

Requirements Class http:www.opengis.netspecROSEO1.0reqCore Target type ROSEO Server Dependency None Requirement http:www.opengis.netspecROSEO1.0reqCoreOrderOptions The OrderOptions resource of a ROSEO server shall be accessible from the following root path: http:hostname:portcontext pathROSEO1.0.0options via the HTTP GET method. 140 Copyright © 2014 Open Geospatial Consortium Requirement http:www.opengis.netspecROSEO1.0reqCoreOrderOptionsproduct_id The OrderOptions available for a specified EO Product shall be accessible to the following URLs: XML format: http:hostname:portcontext pathROSEO1.0.0options{eo:identifier}xml Open Search Description Document OSDD format: http:hostname:portcontext pathROSEO1.0.0options{eo:identifier}osdd via HTTP GET request. eo:identifier is the identifier of a EO Product as specified in OGC 13-026. eo refers to the following namespace: http:a9.com-opensearchextensionseo1.0 Requirement http:www.opengis.netspecROSEO1.0reqCoreOrderOptionscollection_id The OrderOptions available for a specified EO product Collection shall be accessible to the following URLs: XML format: http:hostname:portcontext pathROSEO1.0.0options{collection identifier}xml Open Search Description Document OSDD format: http:hostname:portcontext pathROSEO1.0.0options{collection identifier}osdd via HTTP GET request. Requirement http:www.opengis.netspecROSEO1.0reqCoreOrderOptionsformatxml OrderOptions resource in XML format shall consist of an XML instance document as validated by the entity OrderOptions in the roseo.xsd XML Schema. Requirement http:www.opengis.netspecROSEO1.0reqCoreOrderOptionsformatosdd OrderOptions resource in Open Search Description Document format shall consist of: ฀ a Open Search Description Document instance complying with: http:www.opensearch.orgSpecificationsOpenSearch1.1OpenSearc h_description_document ฀ including, as foreign markup, an OrderOptions element as validated by the entity OrderOptions in the roseo.xsd XML Schema 141 Copyright © 2014 Open Geospatial Consortium Requirement http:www.opengis.netspecROSEO1.0reqCoreOrderOptionsformatxmlprodu ct_id The OrderOptions corresponding to an EO Product shall: ฀ include at least one instance of OrderOptionsOrderOptionGroupidentifier. ฀ include OrderOptionsOrderOptionGrouporderType = PRODUCT_ORDER ฀ optionally include OrderOptionsOrderOptionGroupdownloadURL reporting a template URL for direct download of the product. Requirement http:www.opengis.netspecROSEO1.0reqCoreOrderOptionsformatxmlcollec tion_id The OrderOptions corresponding to a product collection shall: ฀ include OrderOptionsOrderOptionGrouporderType = PRODUCT_ORDER ฀ include OrderOptionsOrderOptionGroupdownloadURL reporting the URL for retrieving an OSDD for querying the specified product collection. Requirement http:www.opengis.netspecROSEO1.0reqCoreOrderOptionsformatxmloda OrderOptions resource shall include at least one instance of: OrderOptionsOrderOptionGroupproductDeliveryOptionsonlineDataAccesspr otocol Requirement http:www.opengis.netspecROSEO1.0reqCoreOrderOptionsformatosddUrl The OrderOptions resource in OSDD format shall include one Url element for each instance of OrderOptionsOrderOptionGroup. Requirement http:www.opengis.netspecROSEO1.0reqCoreOrderOptionsformatosddUrlt emplate The OrderOptions resource in OSDD format shall include Urltemplate attribute including as possible template parameters those specified at §7.3.2.3.3. Requirement http:www.opengis.netspecROSEO1.0reqCoreOrderOptionsformatosddUrlt emplatecollection_id OrderOptions by collection id in OSDD format shall include Urltemplate attribute allowing to issue an Open Search query on the specified collection. Requirement http:www.opengis.netspecROSEO1.0reqCoreOrderOptionsexception When a ROSEO Server encounters an error while returning an OrderOptions resource, it shall return: ฀ HTTP Status Code: 4XX for errors on the client side; 5XX for errors on server side as specified in Table 7-29. ฀ HTTP Entity Body: an ows:ExceptionReport according to the clause 8 of [NR9]. 142 Copyright © 2014 Open Geospatial Consortium

8.3 Order