Array Handlers
Array Handlers in Studio are predefined functions used to search, sort, filter, transform, and manipulate arrays (lists) of items during the mapping process.
Accessing Array Handlers
1
Click on any destination field in the mapping panel
2
A pop-up window opens titled "FUNCTION FOR WORKING WITH AN ARRAY"
3
You'll see two sections:
- Handlers — Available array functions
- Keywords — Sort keywords (Asc, Desc)
Available Array Handlers
append()
append(array1; array2)
Combines multiple arrays into one.
Example
append(["123", "456", "789"] ; ["234", "567", "890"])
// Output
["123", "456", "789", "234", "567", "890"]
// Output
["123", "456", "789", "234", "567", "890"]
loopOverItems()
loopOverItems(array)
The loopOverItems handler processes each item within a list or array mapping from the source to the destination, ensuring all items are handled during flow execution.
Example
Source
orders = [
{ id:"ORD-001", customer:"Alice", total:320 },
{ id:"ORD-002", customer:"Bob", total:145 },
{ id:"ORD-003", customer:"Carol", total:890 },
{ id:"ORD-004", customer:"David", total:67 },
{ id:"ORD-005", customer:"Eve", total:512 }
]
{ id:"ORD-001", customer:"Alice", total:320 },
{ id:"ORD-002", customer:"Bob", total:145 },
{ id:"ORD-003", customer:"Carol", total:890 },
{ id:"ORD-004", customer:"David", total:67 },
{ id:"ORD-005", customer:"Eve", total:512 }
]
Output
Standard mapping only picks up the first item. loopOverItems iterates through every element.
Important: The destination field must support an array to correctly receive the output from the loopOverItems handler.
Related Topics