16.2.3 GetStatus request XML encoding
All SPS servers shall implement HTTP POST transfer of the GetStatus operation, using XML encoding only. The following schema fragment specifies the contents and structure
of a GetStatus operation encoded in XML.
See annex B. Example:
?xml version=1.0 encoding=UTF-8? GetStatus
xmlns =
http:www.opengis.netsps service
= SPS
version =
1.0.0 taskID
433 taskID
GetStatus
16.3 GetStatus operation response
16.3.1 Normal response parameters
The normal response to a valid GetStatus operation shall be a GetStatusRequestResponse. More precisely, a response from the GetStatus operation shall include the parts listed in
Table 18 and shown in the following figures. This table also specifies the UML model data type plus the multiplicity and use of each listed part.
«Elem ent»
GetStatusRequestResponse
«Elem ent»
estimatedToC
«Enum eration»
status
0..1 + «Elem ent» tas kID: token
+ «Elem ent» des cription: StringOrRefType [0..1] + «Enum eration» s tatus : String
+ «Elem ent» gm l:Tim eIns tant: gm l:Tim eIns tantType + «enum » in operation: String
+ «enum » unknown: String + «enum » finis hed: String
+ «enum » not yet s tarted: String + «enum » cancelled: String
+ «enum » delayed: String
Figure 37: GetStatusRequestResponse parameters in UML notation
Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved.
77
Figure 38: GSRR parameters in XMLSpy notation
78
Copyright © 2007 Open Geospatial Consortium, Inc. All Rights Reserved.
Table 18 — Parts of GetStatus operation response
Name Definition
Data type and values Multiplicity and use
taskID Identifier for the requested
task Token one
mandatory status
Defines the current status of this task
String, enumerates: “unknown”,
“in operation”, “finished”,
“not yet started”, “cancelled”,
“delayed” one mandatory
description Optional further information
about the task String
one optional Note: jf the SPS operator
cancelled or delayed the task, then the
gml:description should be considered as a
mandatory element explaining why the task
was cancelled or delayed. If the task was
delayd by the operator, then the
sps:estimatedToC element should, if
possible, indicate when the task is supposed to
be finished despite the delay.
estimatedToC Defines the estimated Time of
Completion of this task gml:TimeInstant one
optional
a
16.3.2 Normal response XML encoding
The following schema fragment specifies the contents and structure of a GetStatus operation response, always encoded in XML.
See annex B.
16.3.3 GetStatus response example