For Loop

For Loop

Tipo: for-loop  ·  Paquete: Core Activities v1.0.8

Repite un bloque de actividades un número contado de veces, llevando un índice numérico que aumenta en cada vuelta. Úsalo cuando sabes cuántas veces repetir (recorrer 10 páginas, generar 5 reportes) y no estás recorriendo los elementos de una colección.

Cómo funciona

Cuenta desde from (incluido) hasta to (excluido), sumando step en cada vuelta. En cada iteración guarda el valor actual en la variable indexVariable y ejecuta las activities.

from = 0, to = 3, step = 1   →   índice toma 0, 1, 2   (3 vueltas; el 3 NO se ejecuta)
from = 1, to = 11, step = 1  →   índice toma 1, 2, …, 10  (10 vueltas)
from = 0, to = 10, step = 2  →   índice toma 0, 2, 4, 6, 8
from = 5, to = 5             →   0 vueltas (el flujo sigue sin entrar)

• from, to y step se redondean a entero antes de empezar; el índice siempre es un número entero.
• El bucle solo cuenta hacia arriba: sigue mientras el índice sea menor que to. Un step de 0 o negativo con from < to nunca alcanza el final y deja el bucle girando; usa siempre un step positivo.
• Admite Break y Continue dentro del cuerpo. Antes de cada vuelta se revisa si la ejecución se terminó, así que Terminar lo corta entre una vuelta y la siguiente.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
from	int	—	Índice inicial (incluido). Se redondea a entero.
to	int	—	Índice final (excluido): el bucle se ejecuta mientras el índice sea < to. Se redondea a entero.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
step	number	1	Cuánto aumenta el índice por vuelta. Debe ser mayor que 0.
indexVariable	string	"i"	Nombre de la variable con el índice actual.

Sub-flujos

activities requerido

Actividades que se ejecutan en cada vuelta.

Salida

Esta actividad no devuelve ningún valor. Lo que produce es la variable indexVariable, que se actualiza en cada vuelta.

Ejemplo

Recorrer las primeras 5 páginas de un listado web:

For Loop   from = 1   to = 6   indexVariable = pagina
 └─ activities:
      Page Navigate   url = "https://portal.example.com/listado?page=" + pagina
      Log             level = info   message = "Procesando página " + pagina

El to es exclusivo

Para repetir N veces empezando en 1, usa from = 1, to = N+1. Para empezar en 0, usa from = 0, to = N. Si esperas 5 vueltas y solo ves 4, casi siempre es porque el to (exclusivo) está uno corto.

No hace falta declarar el índice

For Loop crea la variable indexVariable y la actualiza en cada vuelta; puedes usarla en expresiones ("página " + pagina). Si no le das nombre, se llama i.

Errores comunes

Mensaje	Causa y solución
'activities' es obligatorio.	El bucle no tiene lane de actividades. Agrega al menos una actividad dentro.
El bucle no termina	step es 0 o negativo, o el cuerpo nunca llega a un Break esperado. Usa un step positivo.
Una vuelta menos de lo esperado	to es exclusivo. Súmale 1.
El valor de from, to o step no se puede convertir a número	La expresión devolvió un texto que no es un número. Conviértelo con num(...) o revisa la variable de origen.

Actividades relacionadas

• For Each — cuando recorres los elementos de una lista o tabla, no un conteo.
• While — cuando no sabes cuántas vueltas, sino que dependes de una condición.
• Break / Continue — salir del bucle o saltar a la siguiente vuelta.