- 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
- 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
A mapping rule must be defined inside an <X-map> or <X-content-map> element, where X may be substituted by either feature, group, or reference. This means that the containing element determines the mapping rule’s type.
All mapping rules, regardless of their type, are represented in xfMap by the <mapping> element. A mapping rule has the following form:
<mapping match="..."> <!-- mapping rule contents --> </mapping>
The types of mapping rule and their corresponding containing elements are:
- feature mapping rules: These specify the construction of FME features, and they must be defined inside the <feature-map> or <feature-content-map> elements.
- group mapping rules: These specify the construction of xfMap groups, and they must be defined inside the <group-map> or <group-content-map> elements.
- reference mapping rules: These specify the construction of xfMap references, and they must be defined inside the <reference-map> or <reference-content-map> elements.
Each mapping rule type will be described in separate sections: Feature Mapping Rules,Group Mapping Rules, and Reference Mapping Rules.
The following section describes the mapping rule’s match expression and states. Every mapping rules may also contain some optional elements, which are discussed in Mapping Rules (Optional Elements).