Foreach

The Foreach action node loops over objects in a data source and runs a block of action nodes for each object.

Usage

This action node is used to run a block of other action nodes repeatedly. The block will be run once for each object in the data source according to the object selection. On each iteration, the current object becomes the object in context.

Good to know

If you want to update or delete a selection of objects use the Update object or Delete objects action nodes.

Example

Loop through active projects

Your app has a data source containing all projects. You'd like to iterate over active projects to calculate resource utilization.

Use Foreach to loop over a filtered selection of projects with a filter Project.State EQUALS Active to only iterate over active projects.

Showroom

A Foreach example is available in our Showroom. You can view the demo, as well as access the setup in Appfarm Create. Don't have access? Register.

Working with schemas

ForEach can iterate over an action variable or action param of type schema, provided the schema is an array. On each iteration, the current element becomes available as the object in context.

A single ForEach node descends one array level only. To iterate a nested array — for example, to loop over each Address on each Company — use two ForEach nodes: the outer node iterates the Company array, and an inner node iterates the Address array on each company.

Good to know Array-of-arrays schemas are not supported. If you need to represent a nested list, wrap the inner array in an object. For example, instead of an array of arrays of strings, define an array of objects where each object contains an array of strings.

Properties

Property	Description
Data Source	Select a multi-cardinality data source containing the objects to iterate over. You may also select a multi-reference property (an Object Class Property with Cardinality Many), and iterate over the referenced objects.
Selection	Define the objects to update. All objects Selected object(s) Filtered selection
Filter	Available when Selection is Filtered selection. Define the filter to apply to the data source.
Execution Mode	Sequential: The default. All action nodes inside the Foreach loop will be executed in sequence. Parallel: Execute all action nodes inside the Foreach loop in parallel.