Thanks for your feedback!
EDIT
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.
|
Considere la integración de una plataforma de E-commerce con un CRM. Para cada cliente que realiza una compra en la plataforma, usted desea:
En esta integración, el For Each maneja varios clientes en un solo pedido. Garantiza que, para cada cliente encontrado en los detalles del pedido, las acciones subsecuentes (agregar al CRM y enviar un correo electrónico) se realicen individualmente. |
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 triggers) 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.
El icono de alerta 
del cuadro sólo desaparecerá si lo hay:
-
Al menos un step dentro del For Each;
-
La conexión de entrada, a la izquierda;
-
La conexión de salida, a la derecha.
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: lista de variables ejecutadas. 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.
Haciendo clic en el botón de Properties 
a la derecha, puede:
a. Seleccionar variables previamente registradas.
b. Crear expresiones utilizando el Expression Builder. -
Iteration Element: nombre de la estructura que identifica los elementos 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.
Se puede visualizar el nombre registrado 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 la integración entre una plataforma de E-commerce y un sistema de gestión de inventario. Cada pedido contiene múltiples ítems y, para cada ítem, usted necesita actualizar los niveles de inventario.
|
-
El For Each externo es responsable de iterar a través de cada pedido, garantizando que cada pedido sea procesado uno a la vez.
-
El For Each interno opera dentro del contexto de un solo pedido, iterando a través de cada ítem en ese pedido para realizar las operaciones necesarias, como actualizar los niveles de inventario.
Esta sería una representación visual de esta integración:
| 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:
-
Haga clic en el icono Properties
, a la derecha del campo Variable List. -
A continuación, haga clic en el icono
de la esquina superior derecha.
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]