64 Copyright © 2012 Open Geospatial Consortium.
Table 38: Properties of InsertResult data type Name
Definition Data type and values
Multiplicity and use
template Pointer to the template defining the
structure and encoding of the results.
ResultTemplate
id
see Table 36 One mandatory
resultValues The results of observations which
shall be inserted. Any type
One mandatory id
NOTE
: the primary use of this property is to provide a pointeridentifier – see Annex
15
and OGC 09-001 clause 16.3.1 for further details on identifier handling.
11.1.2.2 Response
The SOS
InsertResultResponse
data type derives from the SWES
ExtensibleResponse
data type defined in OGC 09-001 and inherits its properties.
11.1.2.3 Exceptions
in the
InsertResult
request.
Requirement http:www.opengis.netspecSOS2.0reqresultInsertionir-response
Requirement 87 The SOS
InsertResultResponse
shall contain the properties inherited from SWES ExtensibleResponse. No other properties are defined by this standard for the
InsertResultResponse type. The return of an instance of the
InsertResultResponse
shall indicate a successful insertion of the result values.
Requirement http:www.opengis.netspecSOS2.0reqresultInsertionir-exception
Requirement 88 When an SOS server encounters an error while performing an InsertResult operation,
it shall return an exception message as specified in Clause 15 of [OGC 09-001] with applicable exception code as defined in Listing 7. The meaning of each exception code shall be as defined in
OGC 06-121r3 and OGC 09-001.
Copyright © 2012 Open Geospatial Consortium. 65
Listing 7: exception codes applicable to the InsertResult operation
OperationNotSupported
MissingParameterValue
InvalidParameterValue
OptionNotSupported
NoApplicableCode
InvalidRequest
RequestExtensionNotSupported
11.1.2.4 Examples
Example 22 An example of request and response of the XML implementation of the InsertResult operation
can be found here: http:schemas.opengis.netsos2.0examplesresultHandlingInsertResult1.xml
http:schemas.opengis.netsos2.0examplesresultHandlingInsertResult1_response.xml
11.2 Requirements Class: Result Retrieval
Requirement http:www.opengis.netspecSOS2.0reqresultInsertionir-exception-unknown-result-structure
Requirement 89 If the structure and encoding of the inserted results does not adhere to the
resultStructure
and
resultEncoding
defined for the
ResultTemplate
pointed to in the
InsertResult
request and inserted beforehand through an InsertResultTemplate call an exception shall be thrown with the exceptionCode “InvalidParameterValue” with locator value
“template”.
Requirements Class
http:www.opengis.netspecSOS2.0reqresultRetrieval Target Type
Web Service
Dependency http:www.opengis.netspecSOS2.0reqcore
Dependency http:www.opengis.netspecSOS2.0reqinsertionCap
Requirement http:www.opengis.netspecSOS2.0reqresultRetrievalgrt-request-structure
Requirement http:www.opengis.netspecSOS2.0reqresultRetrievalgrt-filter-context
Requirement http:www.opengis.netspecSOS2.0reqresultRetrievalgrt-response-structure
