For Dashboard Designers Reference Iterate
Friday, November 11, 2022 12:54 PMIterate
Label: :IA_Function
Property: type: Iterate
Inherits from: Function
Iterates over an array or object input. For each key-value pair in input data it triggers an iteration event with that pair.
There are two types of iteration:
- Parallel: all iterations will be triggered/started immediately in parallel
 - Serial: next iterations will be triggered after an 
updateevent to the IA_Iterate function instance with thenextIterationparameter updated 
Parameters
| Key | Description | Default value | Possible values | 
|---|---|---|---|
data | 
Collection of values to iterate over | object or array | |
iterationType | 
How the iterations will be made | serial | 
serial or parallel | 
nextIndex | 
Specifies which item should be iterated next. This is set and updated automatically but can be used to customize the iteration order. | null | 
integer | 
nextIteration | 
Parameter should be updated with true in serial mode to trigger the next iteration | 
null | 
true or null | 
If nextIndex item does not exist the iteration ends.
Outgoing triggers
An Iterate triggers following events:
Type: iteration
Occurrence: Triggered when the function executes for each key-value pair in input data.
Additional event properties (besides the inherited properties):
| Key | Description | Possible values | 
|---|---|---|
data | 
Item data | any | 
index | 
Item index | string | 
Type: iterationEnd
Occurrence: Triggered when there are no more items to iterate through or when nextIndex specifies an item that does not exist.