Tutorial Interativo: Dominar o Fluxo de Dados, Execução e Depuração do n8n - Fluxo de trabalho n8n

• Programadores e developers em transição para plataformas de automação visual.


• Novos utilizadores do n8n que procuram conhecimento técnico aprofundado sobre fluxo de dados e execução.


• Utilizadores que queiram perceber como um nó n8n processa itens únicos face a múltiplos itens.


• Qualquer pessoa à procura de templates n8n robustos focados na lógica central e técnicas de depuração.

Este workflow n8n abrangente funciona como um documento vivo e um tutorial, guiando novos utilizadores através dos aspetos críticos, muitas vezes contraintuitivos, da construção de automações no n8n. Aborda conceitos fundamentais como a forma como os itens de dados transformam o fluxo de execução, a diferença crucial entre caminhos de execução e a referência correta aos dados. Ao contrário da documentação passiva, este template interativo do n8n permite que os utilizadores executem e depurem conceitos em tempo real, garantindo uma compreensão sólida do modelo de dados e do controlo de fluxo do n8n. Dominar esta lógica central é essencial para criar soluções n8n complexas e fiáveis.

Este workflow n8n autodirigido utiliza uma série de nós Form para pausar e apresentar as lições, exigindo interação do utilizador para prosseguir, permitindo a inspeção em tempo real dos caminhos dos dados.

1. Iniciação: O workflow n8n começa com o acionador Form Start do n8n, solicitando ao utilizador que inicie o tutorial.


2. Controlo de Fluxo: O workflow demonstra primeiro a execução sequencial: quando um nó se liga a múltiplos caminhos, o caminho superior (Do Thing 1) completa-se sempre na totalidade antes de o caminho inferior (Do Thing 2) começar.


3. Âmbito e Isolamento de Dados: Mostra como os dados definidos por um nó Set do n8n são naturalmente isolados para o seu ramo (Cant See It não consegue aceder a dados paralelos).


4. Junção de Dados: O nó Merge do n8n (configurado como Combine) é então usado para unificar com sucesso dados de ramos separados num único item de fluxo, que fica acessível pelo formulário Can See Both.


5. Modos de Execução: Vários nós Code são utilizados para gerar vários itens de dados, demonstrando o conceito fundamental de que passar múltiplos itens faz com que os nós n8n a jusante sejam executados uma vez por item, a menos que configurado de outra forma.


6. Agregação: O nó Aggregate Items do n8n mostra como consolidar cinco itens de dados separados de volta num único item contendo um array, seguido pelo nó Split Out para inverter o processo.


7. Controlo Avançado: O workflow n8n introduz o nó Loop Over Items (Split In Batches) para processamento iterativo e utiliza a configuração Only Once num nó NoOp do n8n para limitar intencionalmente um fluxo de múltiplos itens a uma única execução.


8. Depuração: O passo final direciona o utilizador para inspecionar os registos (logs) do workflow, um passo vital para depurar qualquer workflow n8n complexo.

1. Importar: Copie todo o código JSON fornecido acima.


2. Abrir n8n: Na sua instância n8n, clique no '+' para criar um novo workflow.


3. Importar de JSON: Clique no botão 'Import from JSON' (Importar de JSON) localizado no canto superior direito e cole o JSON do workflow n8n copiado.


4. Execução: Uma vez que este template n8n utiliza um acionador Form Start do n8n, não necessita de credenciais externas. Clique em 'Execute Workflow' (Executar Workflow) para abrir o formulário interativo e começar o tutorial. Siga as instruções fornecidas nos nós Sticky Note e nas janelas do formulário interativo. Lembre-se de parar frequentemente a execução para inspecionar as configurações de cada nó n8n conforme instruído.

• Form Start (Acionador n8n): Serve como ponto de partida interativo para o tutorial. Inicia um formulário web que controla o ritmo de execução de todo o workflow n8n.


• Form (n8n Node): Utilizado extensivamente ao longo do workflow n8n para pausar a execução, fornecer texto explicativo e exibir os resultados dos testes de manipulação de dados.


• Sticky Note: Contém a maior parte do conteúdo instrutivo, guiando o utilizador através de cada conceito, como regras de fluxo de dados e modos de execução.


• Set: Um nó central do n8n usado para criar e atribuir pares de chave-valor (myvalue1e, myvalue1f) para demonstrar como os dados são transportados através do fluxo.


• Merge: Configurado com mode: combine, este nó n8n é crucial para mostrar como os dados de dois ramos de execução paralelos podem ser reunidos com sucesso.


• Code: Usado para gerar dinamicamente dados de teste (ex.: Create Three Items, Create Five Items) e para demonstrar as diferenças entre executar um nó n8n 'uma vez para todos os itens' versus 'uma vez para cada item'.


• Aggregate Items: Este nó colapsa um fluxo de múltiplos itens de dados (ex.: 5 itens) num único item de dados contendo um array de todos os itens originais, demonstrando a preparação para processamento em lote (batch).


• Split Out: O inverso de Aggregate, este nó n8n pega num array dentro de um único item e expande-o de volta para múltiplos itens individuais, reiniciando o fluxo de execução baseado em itens.


• NoOp: Usado principalmente para layout, mas uma instância é configurada como executeOnce: true para demonstrar a limitação do fluxo de execução a jusante de múltiplos itens de volta para um, uma técnica poderosa de nó n8n para controlo de fluxo.