Detecção de Conclusão de Processamento em Lote usando 'noItemsLeft' - Fluxo de trabalho n8n

• Desenvolvedores que exigem controle preciso sobre loops assíncronos.


• Usuários que lidam com grandes conjuntos de dados e precisam de confirmação confiável da conclusão do lote.


• Qualquer pessoa que esteja criando modelos (templates) n8n personalizados ou buscando técnicas avançadas de controle de fluxo em seu fluxo de trabalho n8n.

Este modelo de fluxo de trabalho n8n demonstra uma técnica poderosa para gerenciar o controle de fluxo ao processar dados em lotes. Ao lidar com potencialmente milhares de itens, saber exatamente quando o lote final foi concluído é crucial para iniciar ações de limpeza, notificações ou etapas de processo subsequentes. Esta demonstração de nó n8n aproveita a propriedade de contexto específica noItemsLeft exposta pelo nó n8n Split In Batches. Ao verificar esta variável em um nó IF subsequente do n8n, o fluxo de trabalho n8n garante que a ação final de conclusão seja executada apenas uma vez, após todos os itens terem sido processados com sucesso.

Este modelo de fluxo de trabalho n8n foi projetado especificamente para mostrar os mecanismos internos do nó n8n Split In Batches.

1. Início e Inicialização: O fluxo de trabalho n8n começa com o gatilho Manual do n8n ('Ao clicar em 'executar'').


2. Geração de Dados: Um nó n8n Function gera 10 itens de dados de amostra (simulando um grande conjunto de dados de entrada) para alimentar o processador em lote.


3. Divisão em Lotes: O nó n8n Split In Batches pega esses 10 itens e é configurado para processá-los em lotes de tamanho 1.


4. Verificação de Conclusão: Após o processamento de cada lote, o fluxo segue para o nó n8n IF. Este nó n8n crucial verifica a expressão {{$node["SplitInBatches"].context["noItemsLeft"]}}. O valor desta variável de contexto se torna true apenas durante o ciclo de execução final, indicando que o fluxo de dados de origem foi totalmente consumido pelo nó n8n Split In Batches.


5. Ação Final: Se a condição IF for verdadeira (o que significa que não há mais itens), o fluxo de trabalho n8n executa o nó n8n Set final, que define uma mensagem de confirmação. Se a condição for falsa, o loop de processamento continua implicitamente até que todos os lotes se esgotem.

Para usar este fluxo, siga estas etapas para importar este valioso modelo n8n:

1. Importar o fluxo de trabalho n8n: Copie os dados JSON fornecidos.


2. Faça login na sua instância n8n e navegue até a seção Fluxos de Trabalho (Workflows).


3. Clique em 'Novo' e selecione 'Importar de JSON'. Cole o JSON do fluxo de trabalho n8n copiado.


4. Execução: Como este modelo n8n usa um gatilho manual do n8n, você pode testar a funcionalidade diretamente clicando em 'Executar Fluxo de Trabalho'. Observe os caminhos de saída do nó n8n IF no log de execução para ver quando a condição noItemsLeft é avaliada como verdadeira.

Gatilho Manual (Ao clicar em 'executar'): O gatilho inicial do n8n para testar facilmente a estrutura do fluxo de trabalho n8n.
Function: Gera 10 itens de espaço reservado (i=0 a i=9) para simular uma carga útil (payload) que precisa de processamento em lote. Este script de codificação personalizado permite testes rápidos do fluxo.
Nó n8n Split In Batches: Nó central de controle de fluxo do n8n. Ele divide os 10 itens de entrada em lotes de tamanho 1, ciclando pelos nós subsequentes até que todos os itens sejam processados. Este nó n8n disponibiliza a variável de contexto crítica noItemsLeft.
Nó n8n IF: O ponto de decisão. Ele verifica o status de conclusão do lote usando a expressão: ={{$node["SplitInBatches"].context["noItemsLeft"]}}. Esta é a chave para detectar com precisão o fim da operação em lote dentro deste fluxo de trabalho n8n.

• Nó n8n Set: Executa somente na conclusão do lote (quando noItemsLeft é verdadeiro). Ele define uma mensagem simples: "Nenhum Item Restante", confirmando a terminação bem-sucedida do loop Split In Batches.