GetOptions request parameters GetOptions request XML encoding

Ordering Services for Earth Observation Products Interface Standard OGC 06-141r6 130 Copyright © 2012 Open Geospatial Consortium

9.3 GetOptions operation request

The type of GetOptions is OrderOptionsRequestType. The following figure provides a graphical representation of this type. Figure 9-1 - GetOptions element diagram.

9.3.1 GetOptions request parameters

A request to perform GetOptions operation shall include the data structure specified in the previous figure and the following table. Names Definition Data type and values Multiplicity and use Product Ordering Subscriptio n service Service type identifier Type: non-empty string Allowed values: OS One mandatory X X version Specification version for operation Type: non-empty string. Format: x.y.z One mandatory X X timeStamp It is the time when the request has been issued. Type: xs:DateTime One optional X X Ordering Services for Earth Observation Products Interface Standard OGC 06-141r6 131 Copyright © 2012 Open Geospatial Consortium Names Definition Data type and values Multiplicity and use Product Ordering Subscriptio n collectionId It is the identifier of the dataset collection to get ordering options. It is referenced as parentIdentifier in the [OR3]. This field is alternative to ‘identifier’ and ‘taskingRequestId’ Type Value: non empty string max 255 chars Syntax: it shall be a valid URN compliant with OGC 06-131, which report the definition of the parentIdentifier, that is equivalent to the collectionId in this specification. One mandatory choice Identifier for the collection storing the EO product to order. Identifier for the subscription. identifier Product identifier element. This element is alternative to the other ones. GetOptions returns the order options corresponding to all the identified products. If GetOptions is called without specifying the identifier but the options depend always on it, the operation returns SOAP Fault. Type Value: string Permitted Values: Not empty string One or more mandatory choice X taskingRequest This field is alternative to collectionId and identifier. This field has to be used in case of future product orders issued via both Ordering ICD and Programming ICD [OR9] [OR10]. Type: TaskingRequestIdType see Table 7-24 One mandatory choice X Table 9-2 - GetOptions element description.

9.3.2 GetOptions request XML encoding

A XML schema fragment for this operation encoded in XML: xs:schema xmlns=http:www.opengis.netoseo1.0 xmlns:xs=http:www.w3.org2001XMLSchema xmlns:ows=http:www.opengis.netows2.0 xmlns:gml=http:www.opengis.netgml3.2 xmlns:swe=http:www.opengis.netswe2.0 xmlns:sps=http:www.opengis.netsps2.0 targetNamespace=http:www.opengis.netoseo1.0 elementFormDefault=qualified attributeFormDefault=unqualified xs:import namespace=http:www.opengis.netswe2.0 schemaLocation=..swesweCommon0.0.0swe.xsd Ordering Services for Earth Observation Products Interface Standard OGC 06-141r6 132 Copyright © 2012 Open Geospatial Consortium xs:import namespace=http:www.opengis.netows2.0 schemaLocation=..ows1.0.0owsGetCapabilities.xsd xs:import namespace=http:www.opengis.netsps2.0 schemaLocation=Order_spsCommon.xsd xs:import namespace=http:www.opengis.netgml3.2 schemaLocation=..gml3.2.1basegml.xsd xs:import namespace=http:www.opengis.netows2.0 schemaLocation=..ows2.0owsExceptionReport.xsd … xs:element name=GetOptions type=OrderOptionsRequestType … xs:complexType name=OrderOptionsRequestType xs:complexContent xs:extension base=OrderRequestBaseType xs:sequence xs:element name=timeStamp type=xs:dateTime minOccurs=0 xs:choice xs:element ref=collectionId xs:element ref=identifier maxOccurs=unbounded xs:element ref=taskingRequestId xs:choice xs:sequence xs:extension xs:complexContent xs:complexType schema

9.3.3 GetOptions request example