Usar Iterador

​

Cuándo usar el iterador

​

Comprender el iterador

1. Toma el primer elemento del array
2. Ejecuta todas las acciones dentro del iterador con ese elemento
3. Pasa al siguiente elemento
4. Repite hasta que se procesen todos los elementos

​

Configuración básica

​

Ejemplo: enviar un correo electrónico a todos en los resultados de búsqueda

​

Paso 1: Buscar registros

1. Añade la acción Search Records
2. Objeto: People
3. Filtro: Company es igual a “Acme Inc”
4. Esto devuelve un array de personas

​

Paso 2: Comprobar que existan resultados

1. Añade la acción Filter
2. Condición: {{searchRecords.length}} es mayor que 0
3. Esto evita errores del iterador con resultados vacíos

​

Paso 3: Añadir un iterador

1. Añade la acción Iterator
2. Entrada del array: selecciona {{searchRecords}}
3. Esto crea un bucle

​

Paso 4: Añadir acciones dentro del iterador

1. Añade la acción Send Email (dentro del iterador)
2. Para: {{iterator.currentItem.email}}
3. Asunto: Hola {{iterator.currentItem.firstName}}!
4. Cuerpo: Mensaje personalizado utilizando los campos del elemento actual

​

Resultado

• Envía un correo electrónico a la persona 1
• Envía un correo electrónico a la persona 2
• … continúa con las 5

​

Acceder a los datos del elemento actual

​

Patrones comunes

​

Actualizar varios registros

1. Search Records (Tasks, Due Date < Today, Status ≠ Completed)
2. Filter (length > 0)
3. Iterator (searchRecords)
   └── Update Record
       - Object: Tasks
       - Record: {{iterator.currentItem.id}}
       - Status: Late

​

Crear registros desde un array

1. Webhook Trigger (receives items array)
2. Filter (items.length > 0)
3. Iterator (trigger.body.items)
   └── Create Record
       - Object: Order Items
       - Name: {{iterator.currentItem.name}}
       - Quantity: {{iterator.currentItem.qty}}
       - Related Order: {{trigger.body.orderId}}

​

Procesamiento condicional dentro del bucle

1. Search Records (People)
2. Iterator (searchRecords)
   └── Filter (currentItem.email is not empty)
       └── Send Email
           - To: {{iterator.currentItem.email}}

​

Solución de Problemas

​

”El iterador espera un array”

✅ Correct: {{searchRecords}}
❌ Wrong: {{searchRecords[0]}}

​

El iterador no se ejecuta

Filter: {{searchRecords.length}} > 0

​

Las acciones se ejecutan demasiadas veces

• Añade filtros más específicos a Search Records
• Establece un límite en Search Records (máx. 200)
• Añade un Filter dentro del iterador para condiciones adicionales

​

Consideraciones de rendimiento

• Uso de créditos: Cada iteración consume créditos por sus acciones
• Tiempo: Los arrays grandes tardan más en procesarse
• Límites: Considera procesar por lotes las operaciones muy grandes
• Límites de velocidad: Las llamadas a API externas pueden alcanzar límites de velocidad con muchas iteraciones

​

Mejores prácticas

1. Comprueba siempre la longitud del array antes del iterador para evitar errores
2. Añade filtros dentro de los bucles cuando no sea necesario procesar todos los elementos
3. Renombra tu paso del iterador para describir qué está recorriendo
4. Prueba con arrays pequeños antes de procesar conjuntos de datos grandes
5. Supervisa las ejecuciones de flujos de trabajo para asegurarte de que las iteraciones se completen como se espera

​

Relacionado

• Acciones de flujos de trabajo
• Cómo usar ramas
• Preguntas frecuentes sobre flujos de trabajo