All Downloads are FREE. Search and download functionalities are using the official Maven repository.

net.opengis.schemas.wfs.1.1.0.wfs.xsd Maven / Gradle / Ivy

There is a newer version: 3.22.0
Show newest version



   

   
   
   
   

   
   
   
   
      
         
            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