Getting Result Access Information for a Task

166 Copyright © 2011 Open Geospatial Consortium sps:DescribeResultAccessResponse sps:availability sps:available sps:DataAvailable sps:dataReference ows:ReferenceGroup ows:Identifierhttp:www.ogc.orgprocedurecamera1tasks6accessReferenceGroups1ow s:Identifier ows:ServiceReference xlink:href=http:www.ogc.orgSOS xlink:role=http:www.opengis.netspecSPS2.0referenceTypeFullServiceAccess ows:Identifierhttp:www.ogc.orgprocedurecamera1accessReferenceGroups1references 1ows:Identifier ows:Formatapplicationxmlows:Format ows:Metadata sps:SPSMetadata sps:dataAccessTypehttp:www.opengis.netsos2.0GetObservationsps:dataAccessType sps:SPSMetadata ows:Metadata ows:RequestMessage soap12:Envelope soap12:Body sos:GetObservation service=SOS version=2.0.0 sos:observedPropertyhttp:www.opengis.netdefpropertyTypex- radiancesos:observedProperty sos:procedurehttp:www.ogc.orgprocedurecamera1sos:procedure sos:temporalFilter fes:During fes:ValueReferencephenomenonTimefes:ValueReference gml:TimePeriod gml:id=gid01 gml:beginPosition2010-08- 20T12:37:00+02:00gml:beginPosition gml:endPosition2010-08- 20T14:30:00+02:00gml:endPosition gml:TimePeriod fes:During sos:temporalFilter sos:GetObservation soap12:Body soap12:Envelope ows:RequestMessage ows:ServiceReference ows:ReferenceGroup sps:dataReference sps:dataReference ows:ReferenceGroup ows:Identifierhttp:www.ogc.orgprocedurecamera1tasks6accessReferenceGroups2ow s:Identifier ows:Reference xlink:href=http:www.ogc.orgprocedurecamera1videostask_6.mj2 xlink:role=http:www.opengis.netspecSPS2.0referenceTypeResource ows:Identifierhttp:www.ogc.orgprocedurecamera1tasks6accessReferenceGroups2ref erences1ows:Identifier ows:Formatvideomj2ows:Format ows:Reference ows:ReferenceGroup sps:dataReference sps:DataAvailable sps:available sps:availability sps:DescribeResultAccessResponse soap12:Body soap12:Envelope Copyright © 2011 Open Geospatial Consortium 167 The example response shows that the client may need to modify the given request; for example credentials or WS-Addressing header-information may need to be added.

9.6.7 Service Exceptions

At some point in time after the required provision time for status information of a task tasking request a client might request status information for it via the GetStatus GetTask operation. If the service then already removed this information, it will return a StatusInformationExpired exception. Listing 42 – StatusInformationExpired exception example soap12:Envelope xmlns:soap12 = http:www.w3.org200305soap-envelope xmlns:sps = http:www.opengis.netsps2.0 xmlns:xsi = http:www.w3.org2001XMLSchema-instance xmlns:ows = http:www.opengis.netows1.1 soap12:Body soap12:Fault soap12:Code soap12:Value soap12:Receiver soap12:Value soap12:Subcode soap12:Value sps:StatusInformationExpired soap12:Value soap12:Subcode soap12:Code soap12:Reason soap12:Text xml:lang = en The status information for the requested task has already expired. soap12:Text soap12:Reason soap12:Detail ows:Exception exceptionCode = StatusInformationExpired ows:ExceptionText The service has removed all status information for the given task tasking request the required provision time has already passed. ows:ExceptionText ows:Exception soap12:Detail soap12:Fault soap12:Body soap12:Envelope In case that the client sent a request to the service that is not valid according to its XML Schema definition, the service returns an InvalidRequest exception. 168 Copyright © 2011 Open Geospatial Consortium Listing 43 - InvalidRequest exception example soap12:Envelope xmlns:soap12 = http:www.w3.org200305soap-envelope xmlns:sps = http:www.opengis.netsps2.0 xmlns:xsi = http:www.w3.org2001XMLSchema-instance xmlns:ows = http:www.opengis.netows1.1 xmlns:swes = http:www.opengis.netswes2.0 soap12:Body soap12:Fault soap12:Code soap12:Value soap12:Sender soap12:Value soap12:Subcode soap12:Value swes:InvalidRequest soap12:Value soap12:Subcode soap12:Code soap12:Reason soap12:Text xml:lang = en The request did not conform to its XML Schema definition. soap12:Text soap12:Reason soap12:Detail ows:Exception exceptionCode = InvalidRequest locator = element sps:extension is not expected after element sps:GetStatussps:task soap12:Detail soap12:Fault soap12:Body soap12:Envelope If the client sent a GetStatus request with a task identifier that is unknown to the service then the service returns an InvalidParameterValue exception like the following: Listing 44 - InvalidParameterValue exception example soap12:Envelope xmlns:soap12 = http:www.w3.org200305soap-envelope xmlns:sps = http:www.opengis.netsps2.0 xmlns:xsi = http:www.w3.org2001XMLSchema- instance xmlns:ows = http:www.opengis.netows1.1 soap12:Body soap12:Fault soap12:Code soap12:Value soap12:Sender soap12:Value soap12:Subcode soap12:Value ows:InvalidParameterValue soap12:Value soap12:Subcode soap12:Code soap12:Reason soap12:Text xml:lang = en The request contained an invalid parameter value. soap12:Text soap12:Reason soap12:Detail ows:Exception exceptionCode = InvalidParameterValue locator = task ows:ExceptionText The requested task tasking request is unknown to the service. ows:ExceptionText ows:Exception soap12:Detail soap12:Fault soap12:Body soap12:Envelope

9.6.8 Notifications

As the service realizes publish subscribe functionality, the client may subscribe for notifications published by the service. The following examples are about notifications published for the submitted task and an according subscription. 2010-08-20T11:12:05+02:00 - Right after it received the SubmitResponse telling him that the service accepted its tasking request, the client subscribes to notifications for the