For Each
La herramienta For Each permite procesar cada elemento en una colección, uno a la vez. Esto es importante para operaciones en lote donde varios elementos necesitan manipulación similar.
Automatizar el procesamiento de varios elementos reduce la intervención manual, aumentando así la eficiencia y la consistencia en el procesamiento de datos.
Imagine que usted tiene una plataforma de E-commerce que recibe pedidos de clientes. Cada pedido puede tener varios artículos (productos) y, después de la compra, cada artículo del pedido debe ser procesado individualmente para realizar acciones como verificar el inventario, calcular impuestos y generar una factura consolidada, por ejemplo. En este caso, usted podría usar un For Each para iterar sobre los artículos del pedido y realizar una serie de acciones para cada uno de esos artículos de manera independiente. |
Mire cómo quedaría el flujo descrito arriba:
A continuación, aprende a añadir el For Each al canvas y a configurar su formulario.
Añade el For Each al canvas
-
Haga clic en el icono
en el menú de edición de la izquierda.
-
Seleccione el For Each para añadirlo al canvas. Puede utilizar la barra de búsqueda
para encontrarlo.
-
Arrastre al cuadro del For Each los steps (excepto gatillos) que serán iterados (repetidos).
Para remover los steps de dentro de For Each sin eliminarlos del canvas, hay dos botones:
-
Detach: desvincula un único step. Seleccione el step que desea desvincular y haga clic en el tercer botón de la derecha.
-
Ungroup: desagrupa todos los steps y deja el cuadro de For Each vacío. Seleccione el cuadro de For Each y haga clic en el tercer botón de la derecha.
Para eliminar el For Each del canvas, selecciónelo y haga clic en el botón .
Se eliminarán todos los steps dentro del For Each y las conexiones.
Solo puede tener un subflujo dentro del For Each, es decir, no es posible ejecutar subflujos paralelos dentro del For Each.
Si hay steps inactivos, verá un ícono de alerta amarillo ![]() |
Configure el formulario
-
Seleccione el For Each en el canvas.
-
Haga clic en el icono de edición
.
-
Rellene los siguientes campos del formulario:
-
Name: inserte un nombre único para el step For Each. Este es un campo alfanumérico que permite caracteres especiales y espacios en blanco, con un límite de 20 caracteres.
-
Variable List: inserte la lista de variables a ejecutar, es decir, la lista que contiene los elementos que deben ser ejecutados individualmente. Los valores deben ser un array (lista). Este es un campo alfanumérico que permite caracteres especiales y espacios en blanco, con un límite de 1024 caracteres.
A continuación, demostramos la selección de una lista (array) de elementos (desde Properties
) que serán procesados por la herramienta For Each.
-
Iteration Element: nombre de la estructura que identifica los elementos que serán repetidos dentro del For Each. Este es un campo alfanumérico que permite caracteres especiales y espacios en blanco, con un límite de 250 caracteres.
Podrá visualizar el nombre del elemento a iterar en Properties o en el Data Mapping (FROM/TO) de los steps que están dentro del For Each. El número de iteraciones se determina por el número de elementos del array (lista).
-
-
Configure el botón Ignore Errors: por defecto, el botón está desactivado y puede activarlo.
Activado Desactivado La ejecución continúa, incluso si hay errores en el proceso.
La ejecución se detendrá inmediatamente.
Los logs muestran el step con un error.
Los logs muestran la ejecución hasta la última iteración.
Se ejecutarán los steps posteriores al For Each.
No se ejecutará ningún step después del For Each.
-
Haga clic en SAVE.

Consulte un ejemplo de integración con CRM y For Each. |
For Each dentro de otro For Each
Se puede añadir un For Each dentro de otro For Each. De esta manera, su flujo de integración procesará datos en estructuras con loops anidados.
Considere el ejemplo anterior de un flujo con un pedido que contiene varios artículos (productos). Imagine que cada artículo está sujeto al pago de dos impuestos.
De esta manera, tenemos una lista (array) dentro de otra lista:
|
El flujo descrito quedaría de esta manera:
Para mover un step entre dos cuadros de For Each, usted debe desvincularlo del For Each inicial. Para ello, haga clic en X y arrástrelo hasta el nuevo For Each. |
Ignorando errores
Cuando un flujo contiene un For Each dentro de un For Each, se aplican las siguientes reglas al botón Ignore Errors:
"Ignore Errors" en For Each externo | "Ignore Errors" en For Each interno | Resultado |
---|---|---|
Deshabilitado |
Deshabilitado |
El flujo se interrumpirá cuando ocurra un error. |
Habilitado |
Habilitado |
El flujo NO se interrumpirá cuando ocurra un error. |
Habilitado |
Deshabilitado |
Ocorrerá la ejecución de toda la iteración del For Each externo |
Deshabilitado |
Habilitado |
El flujo NO se interrumpirá cuando ocurra un error. |
Expression Builder
El componente Expression Builder le permite crear expresiones con parámetros y variables mediante funciones y condiciones disponibles dentro del componente. Así, puede ajustar la expresión según lo requieran sus necesidades.
Siga los pasos a continuación para acceder a la pantalla de Expression Builder:
La pantalla de Expression Builder contiene las siguientes secciones:
-
Properties: muestra los datos de los steps anteriores y de las variables de entorno. Puede filtrar los atributos utilizando el campo de búsqueda situado en la parte superior de la sección y haciendo clic en
. Puede seleccionar más de un atributo. Al seleccionarlo, el atributo aparece en el campo Expression.
-
Expression: campo para insertar los atributos de entrada o crear una expresión haciendo clic en el botón
a la derecha. Solo la función Concat está disponible para crear la expresión.
Al seleccionar dos o más atributos en el campo Properties, la creación de una expresión será obligatoria. |
Para guardar la información, haga clic en CONFIRM.
Share your suggestions with us!
Click here and then [+ Submit idea]