DescribeResultAccess response parameters DescribeResultAccess operation response

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

15.4 DescribeResultAccess operation response

Figure 15-2 - DescribeResultAccessResponse diagram.

15.4.1 DescribeResultAccess response parameters

The following table presents all parameters within a DescribeResultAccess response. Names Definition Data type and values Multiplicity and use status Completion result of the operation: – success: operation successfully executed; – partial: some error occurred during the processing of the request which lead to an incomplete response. If a blocking error occurred the request will be aborted and it will be generated a SOAP-Fault. Type: String Permitted Values: success, partial One mandatory errorMessage Message to explain the reasons of the partial result. Type: Not empty string max 255 chars. One optional URLs Type: ItemURLType see Table 15-4 Zero or more optional Table 15-3 - DescribeResultAccessResponse description. Ordering Services for Earth Observation Products Interface Standard OGC 06-141r6 193 Copyright © 2012 Open Geospatial Consortium The following table presents the entity ItemURLType description used within DescribeResultAccess response. Names Definition Data type and values Multiplicity and use itemId Order item identifier specified in the Submit request. Type: non-empty string max 80 chars One mandatory productId Identifier of the product the URL is related to. Type: ProductIdType see Table 7-23 One optional itemAddress This is the address of a single “item” to be retrieved; according to the settings of “packaging” in Submit an “item” might be the whole result of the Submit operation or a subset. If “allReady” flag is set to true, this list will contain the URLs of all the items currently available: if there are still items being processed these will NOT be available. According to the settings of packaging flag in Submit this might yield a single item or a bunch of items packaging=None. If “nextReady” flag is set to true, this list will contain all the products available since last call or from the beginning of the processing if called for the first time. According to the settings of packaging flag in Submit, this might yield a single item or a bunch of items packaging=None. Type: OnLineAccessAddressType see Table 15-5 One mandatory expirationDate Date and time at which the URL will expire. Type: xs:dateTime One optional Table 15-4 - ItemURLType description. The following table presents the entity OnLineAccessAddressType description used within ItemURLType entity. OnLineAccessAddressType defines the full information for accessing an on-line ordered item. In particular it provides information about the ordered resource and also about the server that host it. Names Definition Data type and values Multiplicity and use Ordering Services for Earth Observation Products Interface Standard OGC 06-141r6 194 Copyright © 2012 Open Geospatial Consortium Names Definition Data type and values Multiplicity and use ServiceAddress This element provides full information about the server hosting the order item. This element is useful e.g. in case of items ordered through a WCS WMS etc. Type: ServiceAddress One optional type This field specifies the type of the service hosting the ordered item e.g.: WCS, WMS, etc. Type String One optional URL URL of the server hosting the ordered item. Type: anyURI One mandatory info_URL URL of a document providing metadata about the server. In case of OGC Web Services, it refers to the GetCapabilities operation HTTP GET, KVP binding. Type: anyURI One mandatory infoRequest In case the server information are returned via HTTP POST request, this element specifies the message to send e.g. in case the service supports GetCapabilities with SOAP binding, then the GetCapabilities XML message is specified in this tag Type: any One optional ResourceAddress This element provides full information for accessing directly the ordered item. Type:ResourceAddress One mandatory URL URL of the ordered item. Type: anyURI One mandatory serviceRequest In case the ordered item is accessible via HTTP POST protocol, this element specifies the message to send for getting the ordered item. Type: any One optional Table 15-5 - OnLineAccessAddressType description.

15.4.2 DescribeResultAccess response XML encoding