- XML (Extensible Markup Language) Reader/Writer
- XML Quick Facts
- Workbench XML Reader Parameters
- Workbench XML Writer Parameters
- Feature Representation
- Mapping File Reference
- xfMap
- Reading the Input XML Document
- Mapping Rules
- Types of Mapping Rules
- Match and Except Expression
- Specifying Several Match Expressions for One Mapping Rule
- Limiting Mapping Rule Activation with Except Expressions
- Mapping Rule States (activation, execution, suspension, and de-activation)
- Using Force Elements During Mapping Rule Activation and Deactivation
- Search-sets
- Expression Elements (Extract and Literal)
- Expression Sequence
- Feature Mapping Rules
- FME Feature Construction
- Feature Type Element
- Attributes Element
- FME Feature Construction (defining mapping rules under the <feature-content-map> element)
- Attribute Element (handling multiple values)
- Attribute Element (handling optional attributes)
- Attribute Element (sequenced attributes)
- Attribute Element (Nillable Attributes)
- Geometry Element
- Geometry Builder States (activation, execution, suspension, and de-activation)
- Geometry Construction
- Composite Geometry Builders
- Built-in Geometry Builders
- xml-point
- xml-point-xy
- xml-line
- xml-area
- xml-donut
- xml-aggregate
- xml-box
- xml-text
- xml-path
- xml-arc
- xml-arc-by-center-point
- xml-elliptical-arc
- xml-circle
- xml-clothoid
- xml-polygon
- xml-face
- xml-composite-surface
- xml-triangulated-surface
- xml-enclosed-surface
- xml-composite-solid
- xml-multi-point
- xml-multi-curve
- xml-multi-area
- xml-multi-text
- xml-multi-surface
- xml-multi-solid
- xml-null
- xml-reverse-geometry
- xml-geodesic-string
- fme-geometry
- Mapping Segmented Geometric Information
- Geometry Traits (trait element)
- FME Feature Construction (constructing multiple features at a time)
- Structure Element
- References Element
- Apply References Element
- Group Mapping Rules
- Reference Mapping Rules
- Mapping Rules (Optional Elements)
- More Expression Elements
- FME Schema Features
- Reading the Input XML Document
Geometry Builder States (activation, execution, suspension, and de-activation)
Similar to mapping rules a geometry builder may be activated, set on execution, suspended, and de-activated.
Let R be the mapping rule containing a <geometry> element having a activate attribute that specifies the geometry builder B, and
let E be the element whose start-tag is being read from the input XML document stream,
then:
- B is activated when R is activated, (recall that R is activated when R is the first mapping rule in an active-search-set matching E),
- B is executing as long as E is the context element,
- B is suspended when E is not the context element
Note: B if suspended, may again be set to the execution state. For example, when a mapping rule R1, matching a child element of E, say E1, contains a <geometry> element with no activate attribute. The <geometry> element in R1 then indicates to the XML Reader that B should again be executing and that the geometry data parameters in R1 should be given to B. This mechanism is provided for input XML documents that might structured their information in a segmented manner, say:
<line>
<coord>2.9,3.4</coord>
...
</line>
so that a separate mapping rule must be defined to match each <coord> element to complete one polyline feature.
- B is de-activated after E is completely read.
Note: Note: A geometry builder can only be executing or suspended if it is not de-activated.