net.opengis.schemas.wfs.1.1.0.wfs.xsd Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of print-lib Show documentation
Show all versions of print-lib Show documentation
Library for generating PDFs and images from online webmapping services
XML encoded WFS operation request base, for all operations
except GetCapabilities.
The service attribute is included to support service
endpoints that implement more than one OGC service.
For example, a single CGI that implements WMS, WFS
and WCS services.
The endpoint can inspect the value of this attribute
to figure out which service should process the request.
The value WFS indicates that a web feature service should
process the request.
This parameter is somewhat redundant in the XML encoding
since the request namespace can be used to determine
which service should process any give request. For example,
wfs:GetCapabilities and easily be distinguished from
wcs:GetCapabilities using the namespaces.
The version attribute is used to indicate the version of the
WFS specification that a request conforms to. All requests in
this schema conform to V1.1 of the WFS specification.
For WFS implementations that support more than one version of
a WFS sepcification ... if the version attribute is not
specified then the service should assume that the request
conforms to greatest available specification version.
The handle attribute allows a client application
to assign a client-generated request identifier
to a WFS request. The handle is included to
facilitate error reporting. A WFS may report the
handle in an exception report to identify the
offending request or action. If the handle is not
present, then the WFS may employ other means to
localize the error (e.g. line numbers).
The Property element is used to specify one or more
properties of a feature whose values are to be retrieved
by a Web Feature Service.
While a Web Feature Service should endeavour to satisfy
the exact request specified, in some instance this may
not be possible. Specifically, a Web Feature Service
must generate a valid GML3 response to a Query operation.
The schema used to generate the output may include
properties that are mandatory. In order that the output
validates, these mandatory properties must be specified
in the request. If they are not, a Web Feature Service
may add them automatically to the Query before processing
it. Thus a client application should, in general, be
prepared to receive more properties than it requested.
Of course, using the DescribeFeatureType request, a client
application can determine which properties are mandatory
and request them in the first place.
This element may be used in place of an wfs:PropertyName element
in a wfs:Query element in a wfs:GetFeature element to selectively
request the traversal of nested XLinks in the returned element for
the named property. This element may not be used in other requests
-- GetFeatureWithLock, LockFeature, Insert, Update, Delete -- in
this version of the WFS specification.
This attribute indicates the depth to which nested property
XLink linking element locator attribute (href) XLinks are
traversed and resolved if possible. A value of "1" indicates
that one linking element locator attribute (href) Xlink
will be traversed and the referenced element returned if
possible, but nested property XLink linking element locator
attribute (href) XLinks in the returned element are not
traversed. A value of "*" indicates that all nested property
XLink linking element locator attribute (href) XLinks will be
traversed and the referenced elements returned if possible.
The range of valid values for this attribute consists of
positive integers plus "*".
The traverseXlinkExpiry attribute value is specified in
minutes It indicates how long a Web Feature Service should
wait to receive a response to a nested GetGmlObject request.
Request to a WFS to perform the GetCapabilities operation.
This operation allows a client to retrieve a Capabilities
XML document providing metadata for the specific WFS server.
The GetCapapbilities element is used to request that a Web Feature
Service generate an XML document describing the organization
providing the service, the WFS operations that the service
supports, a list of feature types that the service can operate
on and list of filtering capabilities that the service support.
Such an XML document is called a capabilities document.
XML encoded WFS GetCapabilities operation response. This
document provides clients with service metadata about a
specific service instance, including metadata about the
tightly-coupled data served. If the server does not implement
the updateSequence parameter, the server shall always return
the complete Capabilities document, without the updateSequence
parameter. When the server implements the updateSequence
parameter and the GetCapabilities operation request included
the updateSequence parameter with the current value, the server
shall return this element with only the "version" and
"updateSequence" attributes. Otherwise, all optional elements
shall be included or not depending on the actual value of the
Contents parameter in the GetCapabilities operation request.
A list of feature types available from this server.
An element of this type that describes a feature in an application
namespace shall have an xml xmlns specifier, e.g.
xmlns:bo="http://www.BlueOx.org/BlueOx"
Name of this feature type, including any namespace prefix
Title of this feature type, normally used for display
to a human.
Brief narrative description of this feature type, normally
used for display to a human.
The DefaultSRS element indicated which spatial
reference system shall be used by a WFS to
express the state of a spatial feature if not
otherwise explicitly identified within a query
or transaction request. The SRS may be indicated
using either the EPSG form (EPSG:posc code) or
the URL form defined in subclause 4.3.2 of
refernce[2].
The OtherSRS element is used to indicate other
supported SRSs within query and transaction
operations. A supported SRS means that the
WFS supports the transformation of spatial
properties between the OtherSRS and the internal
storage SRS. The effects of such transformations
must be considered when determining and declaring
the guaranteed data accuracy.
A Web Feature Server MAY use zero or more MetadataURL
elements to offer detailed, standardized metadata about
the data underneath a particular feature type. The type
attribute indicates the standard to which the metadata
complies; the format attribute indicates how the metadata is
structured. Two types are defined at present:
'TC211' or 'ISO19115' = ISO TC211 19115;
'FGDC' = FGDC CSDGM.
'ISO19139' = ISO 19139
List of GML Object types available for GetGmlObject requests
List of GML Object types that WFS is capable of serving, either
directly, or as validly derived types defined in a GML application
schema.
Name of this GML object type, including any namespace prefix
An element of this type that describes a GML object in an
application namespace shall have an xml xmlns specifier,
e.g. xmlns:bo="http://www.BlueOx.org/BlueOx"
Name of this GML Object type, including any namespace prefix.
Title of this GML Object type, normally used for display
to a human.
Brief narrative description of this GML Object type, normally
used for display to a human.
The DescribeFeatureType element is used to request that a Web
Feature Service generate a document describing one or more
feature types.
The DescribeFeatureType operation allows a client application
to request that a Web Feature Service describe one or more
feature types. A Web Feature Service must be able to generate
feature descriptions as valid GML3 application schemas.
The schemas generated by the DescribeFeatureType operation can
be used by a client application to validate the output.
Feature instances within the WFS interface must be specified
using GML3. The schema of feature instances specified within
the WFS interface must validate against the feature schemas
generated by the DescribeFeatureType request.
The TypeName element is used to enumerate the
feature types to be described. If no TypeName
elements are specified then all features should
be described. The name must be a valid type
that belongs to the feature content as defined
by the GML Application Schema.
The outputFormat attribute is used to specify what schema
description language should be used to describe features.
The default value of 'text/xml; subtype=3.1.1' means that
the WFS must generate a GML3 application schema that can
be used to validate the GML3 output of a GetFeature
request or feature instances specified in Transaction
operations.
For the purposes of experimentation, vendor extension,
or even extensions that serve a specific community of
interest, other acceptable output format values may be
advertised by a WFS service in the capabilities document.
The meaning of such values in not defined in the WFS
specification. The only proviso is such cases is that
clients may safely ignore outputFormat values that do
not recognize.
The GetFeature element is used to request that a Web Feature
Service return feature type instances of one or more feature
types.
A GetFeature element contains one or more Query elements
that describe a query operation on one feature type. In
response to a GetFeature request, a Web Feature Service
must be able to generate a GML3 response that validates
using a schema generated by the DescribeFeatureType request.
A Web Feature Service may support other possibly non-XML
(and even binary) output formats as long as those formats
are advertised in the capabilities document.
The resultType attribute is used to indicate
what response a WFS should return to user once
a GetFeature request is processed.
Possible values are:
results - meaning that the full response set
(i.e. all the feature instances)
should be returned.
hits - meaning that an empty response set
should be returned (i.e. no feature
instances should be returned) but
the "numberOfFeatures" attribute
should be set to the number of feature
instances that would be returned.
The outputFormat attribute is used to specify the output
format that the Web Feature Service should generate in
response to a GetFeature or GetFeatureWithLock element.
The default value of 'text/xml; subtype=gml/3.1.1'
indicates that the output is an XML document that
conforms to the Geography Markup Language (GML)
Implementation Specification V3.1.1.
For the purposes of experimentation, vendor extension,
or even extensions that serve a specific community of
interest, other acceptable output format values may be
used to specify other formats as long as those values
are advertised in the capabilities document.
For example, the value WKB may be used to indicate that a
Well Known Binary format be used to encode the output.
The maxFeatures attribute is used to specify the maximum
number of features that a GetFeature operation should
generate (regardless of the actual number of query hits).
This attribute indicates the depth to which nested property
XLink linking element locator attribute (href) XLinks are
traversed and resolved if possible. A value of "1"
indicates that one linking element locator attribute
(href) Xlink will be traversed and the referenced element
returned if possible, but nested property XLink linking
element locator attribute (href) XLinks in the returned
element are not traversed. A value of "*" indicates that
all nested property XLink linking element locator attribute
(href) XLinks will be traversed and the referenced elements
returned if possible. The range of valid values for this
attribute consists of positive integers plus "*".
If this attribute is not specified then no xlinks shall be
resolved and the value of traverseXlinkExpiry attribute (if
it specified) may be ignored.
The traverseXlinkExpiry attribute value is specified in
minutes. It indicates how long a Web Feature Service
should wait to receive a response to a nested GetGmlObject
request.
This attribute is only relevant if a value is specified
for the traverseXlinkDepth attribute.
Indicates that a complete response should be generated
by the WFS. That is, all response feature instances
should be returned to the client.
Indicates that an empty response should be generated with
the "numberOfFeatures" attribute set (i.e. no feature
instances should be returned). In this manner a client may
determine the number of feature instances that a GetFeature
request will return without having to actually get the
entire result set back.
The Query element is used to describe a single query.
One or more Query elements can be specified inside a
GetFeature element so that multiple queries can be
executed in one request. The output from the various
queries are combined in a wfs:FeatureCollection element
to form the response document.
The Query element is of type QueryType.
The Property element is used to specify one or more
properties of a feature whose values are to be retrieved
by a Web Feature Service.
While a Web Feature Service should endeavour to satisfy
the exact request specified, in some instance this may
not be possible. Specifically, a Web Feature Service
must generate a valid GML3 response to a Query operation.
The schema used to generate the output may include
properties that are mandatory. In order that the output
validates, these mandatory properties must be specified
in the request. If they are not, a Web Feature Service
may add them automatically to the Query before processing
it. Thus a client application should, in general, be
prepared to receive more properties than it requested.
Of course, using the DescribeFeatureType request, a client
application can determine which properties are mandatory
and request them in the first place.
A function may be used as a select item in a query.
However, if a function is used, care must be taken
to ensure that the result type matches the type in the
The Filter element is used to define spatial and/or non-spatial
constraints on query. Spatial constrains use GML3 to specify
the constraining geometry. A full description of the Filter
element can be found in the Filter Encoding Implementation
Specification.
The SortBy element is used specify property names whose
values should be used to order (upon presentation) the
set of feature instances that satisfy the query.
The handle attribute allows a client application
to assign a client-generated identifier for the
Query. The handle is included to facilitate error
reporting. If one Query in a GetFeature request
causes an exception, a WFS may report the handle
to indicate which query element failed. If the a
handle is not present, the WFS may use other means
to localize the error (e.g. line numbers).
The typeName attribute is a list of one or more
feature type names that indicate which types
of feature instances should be included in the
reponse set. Specifying more than one typename
indicates that a join operation is being performed.
All the names in the typeName list must be valid
types that belong to this query's feature content
as defined by the GML Application Schema.
For systems that implement versioning, the featureVersion
attribute is used to specify which version of a particular
feature instance is to be retrieved. A value of ALL means
that all versions should be retrieved. An integer value
'i', means that the ith version should be retrieve if it
exists or the most recent version otherwise.
This attribute is used to specify a specific WFS-supported SRS
that should be used for returned feature geometries. The value
may be the WFS StorageSRS value, DefaultRetrievalSRS value, or
one of AdditionalSRS values. If no srsName value is supplied,
then the features will be returned using either the
DefaultRetrievalSRS, if specified, and StorageSRS otherwise.
For feature types with no spatial properties, this attribute
must not be specified or ignored if it is specified.
Example typeName attribute value might be:
typeName="ns1:Inwatera_1m=A, ns2:CoastL_1M=B"
In this example, A is an alias for ns1:Inwatera_1m
and B is an alias for ns2:CoastL_1M.
This element is a container for the response to a GetFeature
or GetFeatureWithLock (WFS-transaction.xsd) request.
This type defines a container for the response to a
GetFeature or GetFeatureWithLock request. If the
request is GetFeatureWithLock, the lockId attribute
must be populated. The lockId attribute can otherwise
be safely ignored.
The value of the lockId attribute is an identifier
that a Web Feature Service generates when responding
to a GetFeatureWithLock request. A client application
can use this value in subsequent operations (such as a
Transaction request) to reference the set of locked
features.
The timeStamp attribute should contain the date and time
that the response was generated.
The numberOfFeatures attribute should contain a
count of the number of features in the response.
That is a count of all features elements dervied
from gml:AbstractFeatureType.
The GetGmlObject element is used to request that a Web Feature
Service return an element with a gml:id attribute value specified
by an ogc:GmlObjectId.
A GetGmlObjectType element contains exactly one GmlObjectId.
The value of the gml:id attribute on that GmlObjectId is used
as a unique key to retrieve the complex element with a
gml:id attribute with the same value.
This attribute indicates the depth to which nested
property XLink linking element locator attribute
(href) XLinks are traversed and resolved if possible.
A value of "1" indicates that one linking element
locator attribute (href) XLink will be traversed
and the referenced element returned if possible, but
nested property XLink linking element locator attribute
(href) XLinks in the returned element are not traversed.
A value of "*" indicates that all nested property XLink
linking element locator attribute (href) XLinks will be
traversed and the referenced elements returned if
possible. The range of valid values for this attribute
consists of positive integers plus "*".
The traverseXlinkExpiry attribute value is specified
in minutes. It indicates how long a Web Feature Service
should wait to receive a response to a nested GetGmlObject
request.
This is the root element for the GetFeatureWithLock request.
The GetFeatureWithLock operation performs identically to a
GetFeature request except that the GetFeatureWithLock request
locks all the feature instances in the result set and returns
a lock identifier to a client application in the response.
The lock identifier is returned to the client application
using the lockId attribute define on the wfs:FeatureCollection
element.
A GetFeatureWithLock request operates identically to a
GetFeature request expect that it attempts to lock the
feature instances in the result set and includes a lock
identifier in its response to a client. A lock identifier
is an identifier generated by a Web Feature Service that
a client application can use, in subsequent operations,
to reference the locked set of feature instances.
The expiry attribute is used to set the length
of time (expressed in minutes) that features will
remain locked as a result of a GetFeatureWithLock
request. After the expiry period elapses, the
locked resources must be released. If the
expiry attribute is not set, then the default
value of 5 minutes will be enforced.
See definition of wfs:GetFeatureType.
See definition of wfs:GetFeatureType.
See definition of wfs:GetFeatureType.
See definition of wfs:GetFeatureType.
See definition of wfs:GetFeatureType.
This is the root element for a LockFeature request.
The LockFeature request can be used to lock one or
more feature instances.
This type defines the LockFeature operation. The LockFeature
element contains one or more Lock elements that define which
features of a particular type should be locked. A lock
identifier (lockId) is returned to the client application which
can be used by subsequent operations to reference the locked
features.
The lock element is used to indicate which feature
instances of particular type are to be locked.
The expiry attribute is used to set the length
of time (expressed in minutes) that features will
remain locked as a result of a LockFeature
request. After the expiry period elapses, the
locked resources must be released. If the
expiry attribute is not set, then the default
value of 5 minutes will be enforced.
The lockAction attribute is used to indicate what
a Web Feature Service should do when it encounters
a feature instance that has already been locked by
another client application.
Valid values are ALL or SOME.
ALL means that the Web Feature Service must acquire
locks on all the requested feature instances. If it
cannot acquire those locks then the request should
fail. In this instance, all locks acquired by the
operation should be released.
SOME means that the Web Feature Service should lock
as many of the requested features as it can.
This type defines the Lock element. The Lock element
defines a locking operation on feature instances of
a single type. An OGC Filter is used to constrain the
scope of the operation. Features to be locked can be
identified individually by using their feature identifier
or they can be locked by satisfying the spatial and
non-spatial constraints defined in the filter.
The handle attribute allows a client application
to assign a client-generated request identifier
to a Lock action. The handle is included to
facilitate error reporting. If one of a set of
Lock actions failed while processing a LockFeature
request, a WFS may report the handle in an exception
report to localize the error. If a handle is not
present then a WFS may employ some other means of
localizing the error (e.g. line number).
The value of the typeName attribute is the name
of the feature type to be updated. The name
specified must be a valid type that belongs to
the feature content as defined by the GML
Application Schema.
The LockFeatureResponse element contains a report
about the completion status of a LockFeature request.
The LockFeatureResponseType is used to define an
element to contains the response to a LockFeature
operation.
The LockFeatureResponse includes a LockId element
that contains a lock identifier. The lock identifier
can be used by a client, in subsequent operations, to
operate upon the locked feature instances.
The LockFeature or GetFeatureWithLock operations
identify and attempt to lock a set of feature
instances that satisfy the constraints specified
in the request. In the event that the lockAction
attribute (on the LockFeature or GetFeatureWithLock
elements) is set to SOME, a Web Feature Service will
attempt to lock as many of the feature instances from
the result set as possible.
The FeaturesLocked element contains list of ogc:FeatureId
elements enumerating the feature instances that a WFS
actually managed to lock.
In contrast to the FeaturesLocked element, the
FeaturesNotLocked element contains a list of
ogc:Filter elements identifying feature instances
that a WFS did not manage to lock because they were
already locked by another process.
This is the root element for a Transaction request.
A transaction request allows insert, update and
delete operations to be performed to create, change
or remove feature instances.
The TransactionType defines the Transaction operation. A
Transaction element contains one or more Insert, Update
Delete and Native elements that allow a client application
to create, modify or remove feature instances from the
feature repository that a Web Feature Service controls.
In order for a client application to operate upon
locked feature instances, the Transaction request
must include the LockId element. The content of
this element must be the lock identifier the client
application obtained from a previous
GetFeatureWithLock or LockFeature operation.
If the correct lock identifier is specified the Web
Feature Service knows that the client application may
operate upon the locked feature instances.
No LockId element needs to be specified to operate upon
unlocked features.
The releaseAction attribute is used to control how a Web
Feature service releases locks on feature instances after
a Transaction request has been processed.
Valid values are ALL or SOME.
A value of ALL means that the Web Feature Service should
release the locks of all feature instances locked with the
specified lockId regardless or whether or not the features
were actually modified.
A value of SOME means that the Web Feature Service will
only release the locks held on feature instances that
were actually operated upon by the transaction. The
lockId that the client application obtained shall remain
valid and the other, unmodified, feature instances shall
remain locked.
If the expiry attribute was specified in the original
operation that locked the feature instances, then the
expiry counter will be reset to give the client
application that same amount of time to post subsequent
transactions against the locked features.
The LockId element contains the value of the lock identifier
obtained by a client application from a previous GetFeatureWithLock
or LockFeature request.
The Insert element is used to indicate that the Web Feature
Service should create a new instance of a feature type. The
feature instance is specified using GML3 and one or more
feature instances to be created can be contained inside the
Insert element.
An Insert element may contain a feature collection or one
or more feature instances to be inserted into the
repository.
The idgen attribute control how a WFS generates identifiers
from newly created feature instances using the Insert action.
The default action is to have the WFS generate a new id for
the features. This is also backward compatible with WFS 1.0
where the only action was for the WFS to generate an new id.
The handle attribute allows a client application
to assign a client-generated request identifier
to an Insert action. The handle is included to
facilitate error reporting. If an Insert action
in a Transaction request fails, then a WFS may
include the handle in an exception report to localize
the error. If no handle is included of the offending
Insert element then a WFS may employee other means of
localizing the error (e.g. line number).
This inputFormat attribute is used to indicate
the format used to encode a feature instance in
an Insert element. The default value of
'text/xml; subtype=gml/3.1.1' is used to indicate
that feature encoding is GML3. Another example
might be 'text/xml; subtype=gml/2.1.2' indicating
that the feature us encoded in GML2. A WFS must
declare in the capabilities document, using a
Parameter element, which version of GML it supports.
===== PAV 12NOV2004 ====
WHY IS THIS HERE? WOULDN'T WE KNOW THE INCOMING SRS FROM THE
GML GEOMETRY ELEMENTS? I ASSUME THAT IF THE INCOMING SRS
DOES NOT MATCH ONE OF THE STORAGE SRS(s) THEN THE WFS WOULD
EITHER PROJECT INTO THE STORAGE SRS OR RAISE AN EXCEPTION.
The UseExsiting value indicates that WFS should not
generate a new feature identifier for the feature
being inserted into the repositry. Instead, the WFS
should use the identifier encoded if the feature.
If a duplicate exists then the WFS should raise an
exception.
The ReplaceDuplicate value indicates that WFS should
not generate a new feature identifier for the feature
being inserted into the repositry. Instead, the WFS
should use the identifier encoded if the feature.
If a duplicate exists then the WFS should replace the
existing feature instance with the one encoded in the
Insert action.
The GenerateNew value indicates that WFS should
generate a new unique feature identifier for the
feature being inserted into the repositry.
One or more existing feature instances can be changed by
using the Update element.
Changing or updating a feature instance means that
the current value of one or more properties of
the feature are replaced with new values. The Update
element contains one or more Property elements. A
Property element contains the name or a feature property
who's value is to be changed and the replacement value
for that property.
The Filter element is used to constrain the scope
of the update operation to those features identified
by the filter. Feature instances can be specified
explicitly and individually using the identifier of
each feature instance OR a set of features to be
operated on can be identified by specifying spatial
and non-spatial constraints in the filter.
If no filter is specified then update operation
applies to all feature instances.
The handle attribute allows a client application
to assign a client-generated request identifier
to an Insert action. The handle is included to
facilitate error reporting. If an Update action
in a Transaction request fails, then a WFS may
include the handle in an exception report to localize
the error. If no handle is included of the offending
Insert element then a WFS may employee other means of
localizing the error (e.g. line number).
The value of the typeName attribute is the name
of the feature type to be updated. The name
specified must be a valid type that belongs to
the feature content as defined by the GML
Application Schema.
This inputFormat attribute is used to indicate
the format used to encode a feature instance in
an Insert element. The default value of
'text/xml; subtype=gml/3.1.1' is used to indicate
that feature encoding is GML3. Another example
might be 'text/xml; subtype=gml/2.1.2' indicating
that the feature us encoded in GML2. A WFS must
declare in the capabilities document, using a
Parameter element, which version of GML it supports.
DO WE NEED THIS HERE?
The Property element is used to specify the new
value of a feature property inside an Update
element.
The Name element contains the name of a feature property
to be updated.
The Value element contains the replacement value for the
named property.
The Delete element is used to indicate that one or more
feature instances should be removed from the feature
repository.
The Filter element is used to constrain the scope
of the delete operation to those features identified
by the filter. Feature instances can be specified
explicitly and individually using the identifier of
each feature instance OR a set of features to be
operated on can be identified by specifying spatial
and non-spatial constraints in the filter.
If no filter is specified then an exception should
be raised since it is unlikely that a client application
intends to delete all feature instances.
The handle attribute allows a client application
to assign a client-generated request identifier
to an Insert action. The handle is included to
facilitate error reporting. If a Delete action
in a Transaction request fails, then a WFS may
include the handle in an exception report to localize
the error. If no handle is included of the offending
Insert element then a WFS may employee other means of
localizing the error (e.g. line number).
The value of the typeName attribute is the name
of the feature type to be updated. The name
specified must be a valid type that belongs to
the feature content as defined by the GML
Application Schema.
Many times, a Web Feature Service interacts with a repository
that may have special vendor specific capabilities. The native
element allows vendor specific command to be passed to the
repository via the Web Feature Service.
The vendorId attribute is used to specify the name of
vendor who's vendor specific command the client
application wishes to execute.
In the event that a Web Feature Service does not recognize
the vendorId or does not recognize the vendor specific command,
the safeToIgnore attribute is used to indicate whether the
exception can be safely ignored. A value of TRUE means that
the Web Feature Service may ignore the command. A value of
FALSE means that a Web Feature Service cannot ignore the
command and an exception should be raised if a problem is
encountered.
The TransactionResponse element contains a report
about the completion status of a Transaction operation.
The response for a transaction request that was successfully
completed. If the transaction failed for any reason, an
exception report is returned instead.
The TransactionSummary element is used to summarize
the number of feature instances affected by the
transaction.
For systems that do not support atomic transactions,
the TransactionResults element may be used to report
exception codes and messages for all actions of a
transaction that failed to execute successfully.
A transaction is a collection of Insert,Update and Delete
actions. The Update and Delete actions modify features
that already exist. The Insert action, however, creates
new features. The InsertResults element is used to
report the identifiers of the newly created features.
The version attribute contains the version of the request
that generated this response. So a V1.1.0 transaction
request generates a V1.1.0 transaction response.
Reports the total number of features affected by some kind
of write action (i.e, insert, update, delete).
The TransactionResults element may be used to report exception
codes and messages for all actions of a transaction that failed
to complete successfully.
The Action element reports an exception code
and exception message indicating why the
corresponding action of a transaction request
failed.
If an action fails, the message element may be used
to supply an exception message.
The locator attribute is used to locate an action
within a <Transaction> element. The value
of the locator attribute is either a string that
is equal to the value of the handle attribute
specified on an <Insert>, <Update>
or <Delete> action. If a value is not
specified for the handle attribute then a WFS
may employ some other means of locating the
action. For example, the value of the locator
attribute may be an integer indicating the order
of the action (i.e. 1=First action, 2=Second action,
etc.).
The code attribute may be used to specify an
exception code indicating why an action failed.
Reports the list of identifiers of all features created
by a transaction request. New features are created using
the Insert action and the list of idetifiers must be
presented in the same order as the Insert actions were
encountered in the transaction request. Features may
optionally be correlated with identifiers using the
handle attribute (if it was specified on the Insert
element).
This is the feature identifier for the newly created
feature. The feature identifier may be generated by
the WFS or provided by the client (depending on the
value of the idgen attribute). In all cases of idgen
values, the feature id must be reported here.
If the insert element that generated this feature
had a value for the "handle" attribute then a WFS
may report it using this attribute to correlate
the feature created with the action that created it.
© 2015 - 2025 Weber Informatics LLC | Privacy Policy