Domínio do Nó de Código: Processamento de Dados, Chamadas de API e Geração de Ficheiros - Fluxo de trabalho n8n

Desenvolvedores e Utilizadores Técnicos que procuram alavancar JavaScript personalizado dentro do n8n.
Utilizadores que precisam de realizar transformações ou agregações de dados complexas que não são possíveis com os nós padrão do n8n.
Especialistas em automação que procuram compreender os diferentes modos de execução do nó Code do n8n (Item a Item vs. Uma Vez para Todos).
Qualquer pessoa que utilize modelos do n8n para aprimorar as suas competências de programação personalizada.

O nó Code do n8n é, sem dúvida, a ferramenta mais poderosa da plataforma, permitindo aos utilizadores injetar lógica JavaScript personalizada diretamente no seu fluxo de trabalho do n8n. Este fluxo de trabalho específico do n8n serve como um guia prático, demonstrando quatro casos de uso críticos para o nó Code do n8n:

1. Enriquecimento de Itens: Cálculo de novos campos (como idade e nome completo) para itens individuais.


2. Integração Externa: Realização de pedidos HTTP assíncronos a APIs externas utilizando ajudantes integrados.


3. Agregação de Dados: Resumo de todos os dados recebidos (por exemplo, cálculo da idade média).


4. Geração de Ficheiros: Criação de dados binários (como um relatório CSV) a partir de entrada JSON agregada.

Ao seguir este modelo do n8n, os utilizadores podem transitar rapidamente da construção básica de fluxos para a programação de automações poderosas e dinâmicas.

Este fluxo de trabalho abrangente do n8n começa com um gatilho manual do n8n (Start Tutorial) e prossegue através de várias etapas lógicas, cada uma destacando uma faceta diferente do nó Code do n8n:

1. Inicialização de Dados: O nó 1. Sample Data do n8n inicializa uma lista de objetos de utilizador. O nó 2. Split Out Users do n8n garante que cada utilizador se torna um item individual, preparando os dados para o processamento 'Item a Item'.


2. Transformação Item a Item (Local): O nó Code do n8n 3. Process Each User é executado para cada item de utilizador. Calcula o fullName e a age exata do utilizador utilizando funções de data do JavaScript.


3. Transformação Item a Item (API Externa): O nó Code do n8n 4. Fetch External Data (Advanced) continua a ser executado por item. Demonstra como usar this.helpers.httpRequest para chamar uma API externa (genderize.io) com base no primeiro nome do utilizador, enriquecendo os dados com a probabilidade de género.


4. Agregação: O nó Code do n8n 5. Calculate Average Age muda para o modo 'Executar Uma Vez para Todos os Itens'. Utiliza a função $items() para aceder a todos os resultados das etapas anteriores e calcula uma única saída de resumo contendo o número total de utilizadores e a idade média. Esta é uma função crucial do nó do n8n ao lidar com grandes conjuntos de dados.


5. Geração de Ficheiros (Avançado): O nó Code do n8n final, 6. Create a Binary File (Expert), agrega novamente os dados, gera uma string CSV e utiliza this.helpers.prepareBinaryData para converter a string num ficheiro de relatório binário pronto a utilizar dentro do fluxo de trabalho do n8n.

Para instalar e testar este fluxo de trabalho do n8n, siga estes passos:

1. Copiar o JSON: Copie o código JSON do fluxo de trabalho do n8n fornecido.


2. Importar para o n8n: Na sua instância do n8n, clique em 'New' (Novo) e selecione 'Import from JSON' (Importar de JSON). Cole o código e clique em 'Import' (Importar).


3. Rever a Lógica: Examine as notas adesivas anexadas aos nós Code do n8n para obter explicações sobre o código JavaScript e os modos de execução.


4. Executar: Como o gatilho inicial do n8n é um Manual Trigger (Gatilho Manual), clique em 'Run Workflow' (Executar Fluxo de Trabalho) e depois clique em 'Start Tutorial' (Iniciar Tutorial) para executar o fluxo de trabalho do n8n passo a passo.


5. Inspecionar a Saída: Verifique a saída de cada nó Code do n8n para observar como a estrutura dos dados muda, passando de itens individuais para um único relatório agregado contendo metadados JSON e um ficheiro CSV binário. Não são necessárias credenciais externas para este modelo específico do n8n.

Start Tutorial (Gatilho Manual): O ponto de gatilho inicial do n8n para executar manualmente este fluxo de trabalho do n8n.
1. Sample Data (Nó Set do n8n): Inicializa o fluxo de trabalho com um array de amostra de objetos de utilizador, servindo como entrada para o tutorial.
2. Split Out Users (Nó Split Out do n8n): Nó essencial do n8n que converte o item único contendo o array de utilizadores em múltiplos itens individuais, permitindo que os nós Code subsequentes os processem um de cada vez.
3. Process Each User (Nó Code do n8n): A função é calcular dados derivados (fullName, age) para o item atual. Configuração Chave: O Modo está definido como Executar Uma Vez para Cada Item.
4. Fetch External Data (Advanced) (Nó Code do n8n): A função é demonstrar operações assíncronas utilizando await this.helpers.httpRequest para obter dados externos (estimativa de género) para o utilizador atual. Configuração Chave: O Modo está definido como Executar Uma Vez para Cada Item.
5. Calculate Average Age (Nó Code do n8n): A função é agregar dados de todos os itens anteriores. Utiliza $items() e reduce do JavaScript para calcular a idade média. Configuração Chave: O Modo está definido como Executar Uma Vez para Todos os Itens.

• 6. Create a Binary File (Expert) (Nó Code do n8n): A função é gerar um relatório CSV a partir dos dados agregados e convertê-lo num ficheiro binário utilizando this.helpers.prepareBinaryData. Configuração Chave: O Modo está definido como Executar Uma Vez para Todos os Itens.