Start of change
IBM Integration Bus, Version 9.0.0.6 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Selecting the indices of input and output 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 indices of the input and output elements that you want the transform to operate over.

For each input array, you can select the indices of the elements that you want the transform to operate on. To specify the indices, enter a value in the Input array indices field of the Cardinality properties page for the transform.

The following table shows examples of the values that you can enter:
Table 1. Example values of input array indices
Selected index elements Value in input array indices field
All indices * (or leave empty)
Only index 5 5
Indices 1 - 3 1:3
Indices 1, 3, and 5 1,3,5
Indices 2 and up 2:*
Indices 1, 3, 5 and up 1,3,5:*
Indices 2 - 8, but not 5 2:4,6:8
All indices except 5 1:4,6:*

To set the index of the output array element on which the transform will operate, enter a value in the Output array indices field of the Cardinality properties page. This is slightly different from input index entries, because only a single index is allowed. Leave the field empty to indicate that the whole output array is to be used.

The indices 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 indices are taken. If you have multiple levels of nested array elements, blank cardinality fields imply that all indices are taken. Therefore, if the input element to a transform is A/B[]/C[], where B and C are arrays with no indices specified, all indices 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.

End of change