Array Handlers

Created by Reachware Support, Modified on Wed, 18 Mar at 1:12 AM by Reachware Support

Array Handlers in Reachware Studio are predefined functions used to search, sort, filter, transform, and manipulate arrays (lists) of items during the mapping process.

Accessing Array Handlers

Click on any destination field in the mapping panel

A pop-up window opens titled "FUNCTION FOR WORKING WITH AN ARRAY"

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"]

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 }
]

Output

Standard mapping only picks up the first item. loopOverItems iterates through every element.
✕ Output Without loopOverItems
ORD-001 → processed
ORD-002 → ignored
ORD-003 → ignored
ORD-004 → ignored
ORD-005 → ignored
Only 1/5 processed → data loss
✓ Output With loopOverItems
ORD-001 → processed
ORD-002 → processed
ORD-003 → processed
ORD-004 → processed
ORD-005 → processed
5/5 processed → 100% complete
Important: The destination field must support an array to correctly receive the output from the loopOverItems handler.