For Each

For Each

Type: foreach  ·  Package: Core Activities v1.0.0

Loops through a collection—a list, an array, or the rows of a DataTable—and runs a block of activities once for each element. It is the loop that you will use the most: “for each Excel row…”, “for each email received…”, “for each pending invoice…”.

On each round, the current element becomes available in an iteration variable that you name.

How it works

1. Evaluates the collection indicated in items.
2. For each element, it saves it in the variable itemVariable and executes activities.
3. Repeat until the collection is exhausted.

Inside the loop you can use Break (to exit early) and Continue (to jump to the next lap).

Required parameters

Parameter	Editor	Description
items	expression	The collection to traverse (list, array or DataTable). Ex: = correos, = tabla.
itemVariable	nombre de variable	Variable where the current element is saved on each turn. Ex: item, fila, correo.

Optional parameters

Ninguno.

Subflows (lanes)

activities requerido

The activities that are executed in each iteration. They are configured as a lane on the canvas.

Example

Go through the rows of an Excel and record each client:

For Each   items = = tablaClientes   itemVariable = fila
 └─ activities:
      Log   level = info   message = = "Procesando: " + str(row["Nombre"])
      If    condition = = isEmpty(str(row["Correo"]))
       └─ then:
            Continue          // salta esta fila y pasa a la siguiente
      SMTP Send   to = = str(row["Correo"])   subject = "Aviso"

Iteration variable only exists inside the loop

You don’t need to declare itemVariable in the panel: For Each creates it and updates it on each turn. Outside the loop, it is not available. See Iteration variables.

Loop through a table

When items is a DataTable, each element is a row (DataRow). Read your cells with str(row["Columna"]) or num(fila["Columna"]) to safely handle empty cells. See DataRow.

The editor knows the element type

Inside the loop, the Designer infers the type of the iteration variable from items (a DataTable → DataRow, a List<int> → int, an array text[] → text, etc.). That’s why expressions over the element are validated correctly and the editor autocompletes its members as you type = item.. The inference is most precise when items is a direct variable (e.g. = tablaClientes); with complex expressions the editor falls back to a generic type.

Common errors

Symptom	Causa	Solution
'items' is not iterable	You passed a value that is not a list/table (e.g. a text or number)	Make sure items is a collection or DataTable
The loop does nothing	The collection is empty	Verify that the previous activity returned data

Related activities

• For Loop — repeat a counted number of times (when not looping through a collection).
• While — repeat as long as a condition is met.
• Break / Continue — control the loop from within.