For Each

For Each

Tipo: foreach  ·  Paquete: Core Activities v1.0.0

Recorre una colección —una lista, un arreglo o las filas de una DataTable— y ejecuta un bloque de actividades una vez por cada elemento. Es el bucle que más vas a usar: “por cada fila del Excel…”, “por cada correo recibido…”, “por cada factura pendiente…”.

En cada vuelta, el elemento actual queda disponible en una variable de iteración que tú nombras.

Cómo funciona

1. Evalúa la colección indicada en items.
2. Para cada elemento, lo guarda en la variable itemVariable y ejecuta las activities.
3. Repite hasta agotar la colección.

Dentro del bucle puedes usar Break (para salir antes) y Continue (para saltar a la siguiente vuelta).

Parámetros requeridos

Parámetro	Editor	Descripción
items	expresión	La colección a recorrer (lista, arreglo o DataTable). Ej: = correos, = tabla.
itemVariable	nombre de variable	Variable donde se guarda el elemento actual en cada vuelta. Ej: item, fila, correo.

Parámetros opcionales

Ninguno.

Sub-flujos (lanes)

activities requerido

Las actividades que se ejecutan en cada iteración. Se configuran como un lane en el canvas.

Ejemplo

Recorrer las filas de un Excel y registrar cada cliente:

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

La variable de iteración solo existe dentro del bucle

No necesitas declarar itemVariable en el panel: el For Each la crea y la actualiza en cada vuelta. Fuera del bucle, no está disponible. Ver Variables de iteración.

Recorrer una tabla

Cuando items es una DataTable, cada elemento es una fila (DataRow). Lee sus celdas con str(fila["Columna"]) o num(fila["Columna"]) para manejar con seguridad las celdas vacías. Ver DataRow.

El editor conoce el tipo del elemento

Dentro del bucle, el Designer infiere el tipo de la variable de iteración a partir de items (una DataTable → DataRow, una List<int> → int, un arreglo texto[] → texto, etc.). Por eso las expresiones sobre el elemento se validan correctamente y el editor autocompleta sus miembros al escribir = item.. La inferencia es más precisa cuando items es una variable directa (ej. = tablaClientes); con expresiones complejas el editor cae a un tipo genérico.

Errores comunes

Síntoma	Causa	Solución
'items' is not iterable	Pasaste un valor que no es lista/tabla (ej. un texto o número)	Asegúrate de que items sea una colección o DataTable
El bucle no hace nada	La colección está vacía	Verifica que la actividad anterior devolvió datos

Actividades relacionadas

• For Loop — repetir un número contado de veces (cuando no recorres una colección).
• While — repetir mientras se cumpla una condición.
• Break / Continue — controlar el bucle desde dentro.