- 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
The XML Reader partitions the mapping rules that are specified in an xfMap document into subsets. A subset of mapping rules is called a search-set. Every search-set is not examined for matching mapping rules when an element is being read. The XML Reader only looks into a search-set when that search-set becomes an active-search-set.
The XML Reader maintains several active-search-sets:
- one or more feature-search-set(s): the multi-feature-construction attribute on the <feature-map> element controls the number of feature-search-sets. By default only one feature-search-set exist, several feature-search-set may exist at a time when the multi-feature-construction attribute is set to true. The XML reader allows multiple features to be constructed at a time by always having an additional feature-search-set set to the <feature-map>, only the activation of the mapping rules in the <feature-map> trigger the construction of a new FME feature.
- one group-search-set: the active-search-set containing group mapping rules.
- one reference-search-set: the active-search-set containing reference mapping rules.
The next section describes how the contents, i.e., the mapping rules, of an active-search-set change.