Universal Item Iteration: Configuration Reference

Iteration Sources (4 properties)

Specify which array to iterate over. Set exactly one of the three item source properties.

Property Name	Type	Default	Description
`itemsIterationEnabled`	Boolean	`false`	Enable/disable iteration on this node. When true, all iteration properties become active.
`itemsIterationPropertyName`	String	`null`	Top-level property name containing items array. Example: `"customers"`
`itemsIterationPropertyFormula`	String	`null`	Expression evaluating to items array. Example: `"@{input:data\|orders}"`
`itemsIterationSubQuery`	String	`null`	JSONPath query to extract items. Example: `"$.response.data[*]"`

Core Behavior (4 properties)

Control how items are processed: limits, error handling, empty arrays, and timeouts.

Property Name	Type	Default	Description
`maxAllowedCount`	Integer	`null`	Maximum items to process. Stop after this many. Use for safety limits.
`breakOnFirstError`	Boolean	`false`	Stop iteration if any item fails. True = fail-fast, False = continue.
`skipOnEmpty`	Boolean	`true`	Skip iteration silently if array is empty. False = raise error on empty.
`timeoutPerIteration`	Integer (ms)	`null`	Timeout per item in milliseconds. Example: 5000 for 5 seconds.

Limits & Exits (2 properties)

Enforce minimum count and force early exit.

Property Name	Type	Default	Description
`minAllowedCount`	Integer	`null`	Minimum items required. Error if array has fewer items.
`forceExitAfterCount`	Integer	`null`	Force stop after processing this many items (explicit exit).

Error Handling (3 properties)

Configure failure strategies and error reporting.

Property Name	Type	Default	Description
`retryFailedItems`	Integer	`0`	Number of retries per failed item. Exponential backoff applied automatically.
`returnFirstError`	Boolean	`false`	Return first error encountered instead of processing all items.
`breakOnFirstError`	Boolean	`false`	Stop immediately on first error. (Also listed under Core Behavior)

Result Management (2 properties)

Control how results are aggregated and returned.

Property Name	Type	Default	Description
`aggregateResults`	Boolean	`false`	Collect all results into single array. False = each result flows independently.
`returnLastResultOnly`	Boolean	`false`	Return only the last item's result. Discard previous iterations.

Performance & Batching (3 properties)

Tune speed and resource usage with batching and parallelization.

Property Name	Type	Default	Description
`batchSize`	Integer	`null`	Items per batch. Null = sequential (one at a time). Set to 10-1000 for batching.
`parallelExecution`	Boolean	`false`	Process items within batch concurrently. Requires batchSize to be set.
`reverseOrder`	Boolean	`false`	Process items in reverse order (last item first). LIFO processing.

Batch Timing (2 properties)

Rate limiting and startup delays.

Property Name	Type	Default	Description
`batchWaitTimeMs`	Integer (ms)	`0`	Wait between batch completions. Use for rate limiting (e.g., 100 = 100ms wait).
`batchStartDelayMs`	Integer (ms)	`0`	Delay before first batch starts. Use for staggering multiple workflows.

Filtering & Sorting (2 properties)

Pre-iteration transformations: reduce and reorder items.

Property Name	Type	Default	Description
`filterExpression`	String	`null`	Expression returning true/false. Only items matching filter are iterated.
`sortByExpression`	String	`null`	Expression for sort key. Items sorted by this value (ascending).

Complete Alphabetical Reference

Property	Type	Default	Category	Notes
`aggregateResults`	Boolean	false	Result Mgmt	Collect into array
`batchSize`	Integer	null	Performance	Items per batch
`batchStartDelayMs`	Integer	0	Batch Timing	Delay before start
`batchWaitTimeMs`	Integer	0	Batch Timing	Wait between batches
`breakOnFirstError`	Boolean	false	Core Behavior	Stop on error
`filterExpression`	String	null	Filtering	Include if true
`forceExitAfterCount`	Integer	null	Limits	Stop after N items
`itemsIterationEnabled`	Boolean	false	Iteration Source	Master toggle
`itemsIterationPropertyFormula`	String	null	Iteration Source	Expression-based
`itemsIterationPropertyName`	String	null	Iteration Source	Property lookup
`itemsIterationSubQuery`	String	null	Iteration Source	JSONPath query
`maxAllowedCount`	Integer	null	Core Behavior	Upper limit
`minAllowedCount`	Integer	null	Limits	Lower limit
`parallelExecution`	Boolean	false	Performance	Concurrent processing
`returnFirstError`	Boolean	false	Error Handling	Report first error
`returnLastResultOnly`	Boolean	false	Result Mgmt	Keep last only
`retryFailedItems`	Integer	0	Error Handling	Retry count
`reverseOrder`	Boolean	false	Performance	LIFO processing
`skipOnEmpty`	Boolean	true	Core Behavior	Silent skip empty
`sortByExpression`	String	null	Sorting	Sort key
`timeoutPerIteration`	Integer	null	Core Behavior	Per-item timeout