Selecting the indexes of input array elements
When you are transforming array elements in the Graphical Data Mapping editor, you can use the Cardinality page of the properties view to select the indexes of the input elements that you want the transform to operate over.
When you restrict the indexes of an input array, you reduce the number of indexes processed by the transform. This helps improve performance.
To specify the indexes, enter a value in the Input array indexes field of the Cardinality properties page for the transform.
| Selected index elements | Value in input array indexes field |
|---|---|
| All indexes | * (or leave empty) |
| Only index 5 | 5 |
| indexes 1 - 3 | 1:3 |
| indexes 1, 3, and 5 | 1,3,5 |
| indexes 2 and up | 2:* |
| indexes 1, 3, 5 and up | 1,3,5:* |
| indexes 2 - 8, but not 5 | 2:4,6:8 |
| All indexes except 5 | 1:4,6:* |
The indexes are 1-based, which means that the first element of the array is referenced as
1, the second element as 2, and so on. If the cardinality field is left blank for a
specified array, all indexes are taken. If you have multiple levels of nested array
elements, blank cardinality fields imply that all indexes are taken. Therefore, if the
input element to a transform is A/B[]/C[], where B and
C are arrays with no indexes specified, all indexes are taken. This
means that all C's part of B[1], all C's part of B[2], all C's part of B[3], and so on,
are taken.