IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

ForEach

The ForEach transform iterates over one input array element, which can be either a simple type or a complex type. The output element must be an array of complex types.

The ForEach transform can only have one primary input, and the input must be repeatable.

The ForEach transform can only have one primary input connection. Additional connections to the ForEach transform must be of type Supplement.

The ForEach transform contains a nested map. The elements in the nested map must be mapped, otherwise no action is performed when the transform runs.

Use the Cardinality property to specify the indices that will be processed by the transform. The first index element is 1. The output array size is equal to the input array size, minus any elements that are filtered out from the cardinality property page.

Use the Filter Inputs property tab to:
  • Provide an optional XPath expression as a condition. Each element of the repeatable input will be tested against the condition. The transform will run for those elements that satisfy the condition.
    Note: you can use context assist by pressing Ctrl+Space while constructing the XPath expression.
  • Enable Allow Empty. When Allow Empty is checked, if the input array element is empty or no inputs match a provided filter condition, then the transform is still entered exactly once. In this case, the primary input in the nested transform will be missing, and the index variable will be zero.

cm28647_.htm | Last updated Friday, 21 July 2017