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