Logica: Para Cada (For Each)

Quando usar

• Enviar um e-mail individualizado para cada contato de uma lista


• Processar cada linha retornada de uma busca em tabela


• Atualizar multiplos cards de um projeto, um por um


• Aplicar uma transformacao ou verificacao em cada item de um array

---

Como funciona

O node recebe uma lista* (array) e executa os nodes conectados a saida *Loop (Item) uma vez para cada item dessa lista. A cada iteracao, o item atual, o indice e o total ficam disponiveis como variaveis para os nodes seguintes.

Quando todos os itens forem processados, o fluxo continua pela saida Done.

Saidas (portas)

| Porta | Descricao |
|-------|-----------|
| Loop (Item) | O fluxo conectado aqui e executado uma vez para cada item da lista. Os nodes recebem o item atual, indice e total. |
| Done | O fluxo segue por aqui apos todos os itens terem sido processados |

---

Configuracoes

Lista para Iteracao

Campo onde voce seleciona a variavel que contem a lista (array) a ser iterada. Use o seletor de variaveis para referenciar dados de nodes anteriores.

Exemplos comuns:


• `tabela_buscar.rows` -- lista de registros retornados por um node de busca em tabela


• `contato_buscar.contacts` -- lista de contatos encontrados


• `trigger.body.items` -- lista enviada no body de um webhook

---

Dados de saida

A cada iteracao, os nodes conectados a porta Loop recebem:

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `item` | Objeto | O item atual da lista sendo processado |
| `index` | Numero | O indice da iteracao atual (comecando em 0) |
| `total` | Numero | Quantidade total de itens na lista |

Exemplo: se a lista tem 5 contatos, na terceira iteracao voce tera `item` = terceiro contato, `index` = 2, `total` = 5.

---

Dicas

• Certifique-se de que a variavel selecionada e realmente um array. Se for um objeto unico, o iterator nao funcionara como esperado.


• Use o `index` para logicas como "no primeiro item, faca X" ou "no ultimo item, faca Y" (comparando `index` com `total - 1`).


• Cuidado com listas muito grandes -- cada iteracao executa todos os nodes conectados. Para listas com milhares de itens, considere paginar a busca e processar em lotes.


• A porta Done e ideal para acoes de finalizacao, como enviar um resumo apos processar todos os itens ou atualizar um status.


• Voce pode aninhar iterators (um dentro do outro) para processar listas dentro de listas, mas use com moderacao para evitar complexidade excessiva.