wfs:Insert
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.
Element information
Namespace: http://niem.gov/niem/external/ogc-wfs/1.1.0/dhs-gmo/1.0.0
Schema document: external/ogc-wfs/1.1.0/dhs-gmo/1.0.0/wfs.xsd
Type: wfs:InsertElementType
Properties: Global, Qualified
Content
- Choice [1..*]
- mo:MovingObject
- mo:MovingObjectCollection
- wfs:FeatureCollection This element is a container for the response to a GetFeature or GetFeatureWithLock (WFS-transaction.xsd) request.
- gml:FeatureCollection
- om:Event
- om:CommonObservation Observation event
- om:Observation Generic Observation event
- om:Measurement Measurement event
- om:CategoryObservation Observation, in which the result is a textual value from a controlled vocabulary
- om:CountObservation Observation, in which the result is an integer representing the count of the observed property
- om:TruthObservation Observation, in which the result is a boolean value representing the truth value (usually existence) of the observed property
- om:ComplexObservation Observation, in which the result is a record representing a multi-component phenomenon
- om:DiscreteCoverageObservation Observation, in which the result is a generalized discrete coverage
- om:PointCoverageObservation Observation, in which the result is a point coverage which samples a property at points in the feature of interest
- om:TimeSeriesObservation Observation, in which the result is a time-instant coverage which samples a property of the feature of interest at different times
- om:ElementCoverageObservation Observation, in which the result is a coverage whose domain elements contain references to objects encoded elsewhere, sampling the feature of interest in some way
- om:DiscreteCoverageObs Observation event
- om:PointCoverageObs Observation event
- om:TimeSeriesObs Observation event
- om:ObservationCollection Observation collection, using the "Composite" pattern
- om:ProcedureEvent Description of an event involving a procedure.
from subst. group gml:_Featurefrom subst. group gml:_FeatureCollectionfrom subst. group gml:_DiscreteCoveragefrom subst. group om:Eventfrom subst. group om:AbstractObservationfrom subst. group om:ProcedureEvent
Attributes
| Name | Occ | Type | Description | Notes |
|---|---|---|---|---|
| idgen | [0..1] | wfs:IdentifierGenerationOptionType | 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. | Default value is "GenerateNew". |
| handle | [0..1] | xsd:string | 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). | |
| inputFormat | [0..1] | xsd:string | 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. | Default value is "text/xml; subtype=gml/3.1.1". |
| srsName | [0..1] | xsd:anyURI | ===== 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. |
Used in
- Type wfs:TransactionType (Element wfs:Transaction)
Sample instance
<wfs:Insert> <mo:MovingObject> <gml:metaDataProperty> <!--any element--> </gml:metaDataProperty> <gml:description>string</gml:description> <gml:name>string</gml:name> <gml:boundedBy> <gml:Envelope>... </gml:Envelope> </gml:boundedBy> <mo:geometryProperty> <gml:Point>... </gml:Point> </mo:geometryProperty> <gml:validTime> <gml:TimeInstant>... </gml:TimeInstant> </gml:validTime> <mo:track> <mo:MovingObjectStatus>... </mo:MovingObjectStatus> </mo:track> <gml:dataSource>string</gml:dataSource> </mo:MovingObject> </wfs:Insert>