For Dashboard Designers Reference Iterate
Wednesday, May 17, 2023 12:20 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
update
event to the IA_Iterate function instance with thenextIteration
parameter 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.