XFA Specification
Chapter 16, Config Specification
Config Element Reference
696
The range element
This option controls which records are processed.
<range
Properties:
desc="cdata"
>
...pcdata...
</range>
The range element is used within the following other elements:
data
When
range
has non-null content the XFA application loads only those records indicated into the XFA
Data DOM. During the data-unload phase the skipped records are restored to the output XML document
by copying them from the XML Data DOM. When the content of
range
is the null string, or the
range
element is omitted, the range defaults to the entire document. Note that this is the reverse of the usual
default behavior - the
range
element names the records which are to be processed, yet when no records
are named the result is not to exclude all records but to include all records.
This option affects processing during data load and data unload.
For more information about this element see
Extended Mapping Rules.
Content
When it is not the null string, the value of
range
is a comma-separated list of one or more record numbers
and/or record number ranges. A record number is a non-negative decimal integer, where
0
(zero) indicates
the first record. A record number range is a record number, followed by a
-
character, followed by another
record number which is numerically equal to or greater than the other record number. Record number
ranges and record numbers are allowed to overlap.
For example, the following
<range>3-5,9,4,5-6</range>
causes records 3, 4, 5, 6 and 9 to be processed and all other records to be ignored.
The desc property
An attribute to hold human-readable metadata.