Operation Response - UpdateResponse

120 Copyright © 2011 Open Geospatial Consortium Table 59 — Property in the UpdateResponse data type Name Definition Data type and values Multiplicity and use targetTask Pointer to the scheduled task to update. Task id , see clause 7.3.1.6 value shall be a pointer to a task that is scheduled by the service One mandatory id Note: the primary use of this property is to provide a pointeridentifier – see OGC 09-001 clause 16.3.1 for further details. An UpdateResponse contains a StatusReport see clause 7.3.1.5 to indicate the result of the requested operation. As an Update request is a tasking request, the final result of that request might not be directly available and would then be pending. Requirement http:www.opengis.netspecSPS2.0reqUpdateResponsestatusReportUsage REQ 98. The properties of a StatusReport for the possible transitions of an Update tasking request shall be used as defined in Table 60. All transitions starting from the Pending state are not applicable for reporting in the response, as the response provides only information about the first state transition, i.e. from initial to accepted, pending, or rejected. Clients retrieve further state transitions via notifications or GetStatus operation calls. Copyright © 2011 Open Geospatial Consortium 121 Table 60 – StatusReport usage for different state transitions of an Update request property namecardinali ty Update Request State Transitions From Æ To Initial Æ Pending Initial Æ Accepted Initial Æ Rejected Pending Æ Accepted Pending Æ Rejected Pending Æ Rejected request expired task1 new identifier provided by service identifier previously provided by service estimatedToC0 ..1 NA event code0..1 NA TaskingRequestE xpired percentComplet ion0..1 NA procedure1 identifier of procedure that belongs to task for which Update request was made requestStatus code1 Pending Accepted Rejected Accepted Rejected Rejected statusMessage 0.. service may provide additional information to client in human readable form taskingParamet ers0..1 NA taskStatus code0..1 NA updateTime1 point in time when transition was made alternative0.. may be provided by service StatusReport encoded as ReservationRep ort NA Applicable in Update Response yes yes yes no no no NA = not applicable 122 Copyright © 2011 Open Geospatial Consortium

7.3.12.5 Exceptions

Requirement http:www.opengis.netspecSPS2.0reqUpdateResponseexceptions REQ 99. When an SPS server encounters an error while performing a Update operation, it shall return an exception message as specified in clause 7.2.

7.3.12.6 Examples

Clause 9.6 provides example XML instances for the Update operation request and response.

7.3.13 Cancel Operation

7.3.13.1 Introduction

The Cancel operation allows SPS clients to cancel a scheduled task see clause 6.3.6. The service may reject the cancellation. The response should indicate why the cancellation did not succeed. If the cancellation was rejected, the task remains in its current state.

7.3.13.2 Data Types

The conceptual model of the Cancel operation is shown in the following UML diagram. Co Figure 31 — Data types of the Cancel operation The details of the operation request and response are explained in the following subclauses.

7.3.13.3 Operation Request - Cancel

Sending an instance of the Cancel data type to the service performs an SPS Cancel operation request. The Cancel data type is derived from the SWES ExtensibleRequest data type specified in clause 9 of [OGC 09-001] and therefore inherits all the properties contained in that data type. Cancel does not restrict the content model of ExtensibleRequest. pyright © 2011 Open Geospatial Consortium 123