Usar Iterador

​

Quando usar o Iterador

​

Compreender o Iterador

1. Obtém o primeiro item do array
2. Executa todas as ações dentro do Iterador com esse item
3. Passa para o item seguinte
4. Repete até que todos os itens sejam processados

​

Configuração básica

​

Exemplo: Enviar e-mail a todos nos resultados da pesquisa

​

Etapa 1: Pesquisar registos

1. Adicione a ação Pesquisar Registos
2. Objeto: Pessoas
3. Filtro: Empresa igual a “Acme Inc”
4. Isto devolve um array de pessoas

​

Etapa 2: Verificar se existem resultados

1. Adicione a ação Filtro
2. Condição: {{searchRecords.length}} é maior do que 0
3. Isto evita erros do Iterador em resultados vazios

​

Etapa 3: Adicionar um Iterador

1. Adicione a ação Iterador
2. Entrada do array: selecione {{searchRecords}}
3. Isto cria um ciclo

​

Etapa 4: Adicionar ações dentro do Iterador

1. Adicione a ação Enviar e-mail (dentro do Iterador)
2. Para: {{iterator.currentItem.email}}
3. Assunto: Olá {{iterator.currentItem.firstName}}!
4. Corpo: Mensagem personalizada utilizando os campos do item atual

​

Resultado

• Envia e-mail para a pessoa 1
• Envia e-mail para a pessoa 2
• … continua para todas as 5

​

Aceder aos dados do item atual

​

Padrões comuns

​

Atualizar vários registos

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

​

Criar registos a partir de um 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}}

​

Processamento condicional dentro do ciclo

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

​

Resolução de Problemas

​

”O Iterador espera um array”

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

​

O Iterador não é executado

Filter: {{searchRecords.length}} > 0

​

Ações executadas vezes demais

• Adicione filtros mais específicos a Pesquisar Registos
• Defina um limite em Pesquisar Registos (máx. 200)
• Adicione um Filtro dentro do Iterador para condições adicionais

​

Considerações de desempenho

• Utilização de créditos: Cada iteração consome créditos pelas suas ações
• Tempo: Arrays grandes demoram mais a processar
• Limites: Considere agrupar em lotes operações muito grandes
• Limites de taxa: Chamadas a APIs externas podem atingir limites de taxa com muitas iterações

​

Melhores Práticas

1. Verifique sempre o tamanho do array antes do Iterador para evitar erros
2. Adicione filtros dentro dos ciclos quando nem todos os itens precisam de processamento
3. Renomeie a etapa do seu Iterador para descrever o que está a percorrer
4. Teste com arrays pequenos antes de processar conjuntos de dados grandes
5. Monitorize as execuções dos fluxos de trabalho para garantir que as iterações se concluam conforme o esperado

​

Relacionados

• Ações de Fluxo de Trabalho
• Como usar ramificações
• FAQ de Fluxos de Trabalho