O que é Loop?

O que é um loop

Loop é uma repetição de etapas sobre uma coleção de itens ou enquanto uma condição permitir continuar. Cada passagem é chamada de iteração, e o processamento precisa definir qual trabalho será feito nessa passagem e quando a repetição deve terminar.

Uma automação pode percorrer inscrições para emitir certificados ou consultar páginas de uma API até receber o sinal de que não há continuação. Nos dois casos existe repetição, mas o primeiro pode conhecer a quantidade de itens desde o início, enquanto o segundo descobre a continuação a cada resposta.

Repetir sobre uma lista

Quando a lista já está disponível, cada iteração pode selecionar um item e aplicar a mesma etapa a ele. O término ocorre quando todos os itens previstos foram tratados, conforme a forma de percorrer a coleção.

Isso não determina, sozinho, a ordem de conclusão ou a execução simultânea. Uma implementação pode esperar cada certificado ficar pronto antes de iniciar o próximo, enquanto outra admite várias gerações em andamento, com um limite de concorrência.

Repetir enquanto houver continuação

Em uma consulta paginada, a resposta pode trazer um cursor para buscar o próximo grupo de resultados. O loop precisa usar esse cursor na consulta seguinte e terminar quando a API informar que não existe mais continuação.

Se a automação repetir sempre o primeiro cursor, ela poderá buscar a mesma página indefinidamente. Conferir apenas se a resposta contém itens não basta quando a condição de término real depende de outro campo do contrato.

Um limite adicional de páginas ou de tempo pode interromper uma repetição inesperada, mas atingir esse limite não significa que toda a coleção foi processada. A execução precisa registrar que terminou antes do fim previsto para que você possa investigar e retomar.

Como o n8n trata os itens

Muitos Nodes do n8n já aplicam seu processamento aos itens recebidos, sem exigir um loop desenhado manualmente. Antes de acrescentar uma repetição, confira o comportamento do Node para não repetir uma coleção que ele já processaria inteira.

O Loop Over Items permite dividir a entrada em grupos conforme o tamanho configurado. As etapas conectadas processam um grupo e retornam ao componente para continuar, enquanto a saída de conclusão permite seguir depois de terminar os grupos.

O batch define o agrupamento dos itens, e o loop define a repetição do processamento. Um grupo de dez itens, por exemplo, não informa por si só se as ações internas acontecem simultaneamente ou uma depois da outra.

Falhas e retomada exigem acompanhamento por item

Um resultado geral de falha pode esconder certificados já produzidos antes da interrupção. Recomeçar toda a lista sem reconhecer esses resultados pode repetir arquivos ou notificações de itens concluídos.

Acompanhe quais itens terminaram, quais falharam e quais ainda não começaram. Esse registro permite retomar o trabalho conforme a idempotência prevista, em vez de presumir que toda execução incompleta deve repetir tudo.

Como conferir a parada

Teste uma lista vazia, uma com um item e outra com três itens quando o tamanho do grupo está configurado como dois. Durante a execução, observe o avanço do índice ou cursor e confira se a etapa posterior ao loop só recebe o resultado quando todas as passagens previstas terminam.

Inclua também uma falha no meio da coleção. O teste deve mostrar se o processamento interrompe ou continua e quais itens precisam de recuperação, sem transformar a ausência de erro na última etapa em confirmação de que todos foram concluídos.

Aplicação na formação

n8n Experts

Loops repetem etapas da automação e precisam de uma condição de término compatível com o trabalho previsto.

Conhecer a formação →