Copyright © 2010 Open Geospatial Consortium
99
The wfs:TransactionSummary element contains a count of the number of features created i.e. wfs:totalInserted, modified i.e. wfs:totalUpdated, replaced i.e. wfs:totalReplaced or deleted i.e.
wfs:totalDeleted by the actions in a Transaction request.
If the transaction does not contain any Insert actions see 15.2.4, the wfs:totalInserted element shall be omitted.
If the transaction does not contain any Update actions see 15.2.5, the wfs:totalUpdated element shall be omitted.
If the transaction does not contain any Replace actions see 15.2.6, the wfs:totalReplaced element shall be omitted.
If the transaction does not contain any Delete actions see 15.2.7, the wfs:totalDeleted element shall be omitted.
Only features of the types listed in the web feature services capabilities document shall be counted when generating this summary.
15.3.4 InsertResults element
The following XML Schema fragment declares the wfs:ActionResultsType type, that is the type of the wfs:InsertResults, wfs:UpdateResults and wfs:ReplaceResults elements:
xsd:complexType name=ActionResultsType xsd:sequence
xsd:element name=Feature type=wfs:CreatedOrModifiedFeatureType
maxOccurs=unbounded xsd:sequence
xsd:complexType xsd:complexType name=CreatedOrModifiedFeatureType
xsd:sequence maxOccurs=unbounded xsd:element ref=fes:ResourceId
xsd:sequence xsd:attribute name=handle type=xsd:string
xsd:complexType
If a transaction request contains insert, update andor replace actions then the wfs:InsertResults, wfs:UpdateResults andor wfs:ReplaceResults elements shall be specified in the transaction response.
The wfs:InsertResults element contains one or more wfs:Feature elements that indicate the feature identifiers of newly created feature instances. One wfs:Feature element shall be reported for each newly created feature
instance.
In addition, the wfs:Feature elements shall be presented in the order in which the insert actions were encountered in the wfs:Transaction element.
Additionally, wfs:Feature elements may be correlated to insert actions using the handle attribute. If a value was specified for the handle attribute on an wfs:Insert element that created a feature, that same handle value
may be specified as the value of the handle attribute on the wfs:Feature element to indicate which insert action generated which feature instance.
15.3.5 UpdateResults element
If a transaction request contains update actions and the server supports versioning, then the wfs:UpdateResults element shall be specified in the transaction response to report which features have been
changes and what their new identifiers are.
The wfs:UpdateResults element contains one or more wfs:Feature elements that indicate the new feature identifiers of the updated feature instances. One wfs:Feature element shall be reported for each updated
feature instance. Each wfs:Feature element shall contain a fes:ResourceId element see ISO 19143:2010,
100
Copyright © 2010 Open Geospatial Consortium
7.11 that shall include the rid attribute whose value is the feature identifier of the newly created version of the feature and the oldRid attribute whose value shall be the identifier of previous version.
In addition, the wfs:Feature elements shall be presented in the order in which the update actions were encountered in the wfs:Transaction element.
Additionally, wfs:Feature elements may be correlated to update actions using the handle attribute. If a value was specified for the handle attribute on an wfs:Update element that updated a feature, that same handle
value may be specified as the value of the handle attribute on the wfs:Feature element to indicate which update action change which feature.
15.3.6 ReplaceResults element
If a transaction request contains replace actions and the server supports versioning, then the wfs:ReplaceResults element shall be specified in the transaction response to report which features have been
replaced and what their new identifiers are.
The wfs:ReplaceResults element contains one or more wfs:Feature elements that indicate the new feature identifiers of the replaced feature instances. One wfs:Feature element shall be reported for each replaced
feature instance. Each wfs:Feature element shall contain a fes:ResourceId element see ISO 19143:2010, 7.11 that shall include the rid attribute whose value is the feature identifier of the newly created version of the
feature and the oldRid attribute whose value shall be the identifier of previous version.
In addition, the wfs:Feature elements shall be presented in the order in which the replace actions were encountered in the wfs:Transaction element.
Additionally, wfs:Feature elements may be correlated to replace actions using the handle attribute. If a value was specified for the handle attribute on a wfs:Replace element that replaced a feature, that same handle
value may be specified as the value of the handle attribute on the wfs:Feature element to indicate which replace action replaced which feature instance.
15.4 Exceptions
In the event that a web feature service encounters an error parsing a Transaction request, it shall raise a OperationParsingFailed exception as described in 7.5.
If a web feature service encounters an error while processing a particular action contained in a Transaction request, then the service shall raise an OperationProcessingFailed exception as described in 7.5.
