Padrão de Recuperação de Dados Binários Usando o Nó Code - Fluxo de trabalho n8n

Usuários avançados do n8n que processam arquivos binários (imagens, PDFs) em múltiplas etapas.
Desenvolvedores que criam templates complexos do n8n onde a integridade do arquivo é essencial.
Usuários que buscam dominar o nó Code do n8n para manipulação interna de dados.
Qualquer pessoa que precise de persistência de dados confiável dentro de um fluxo de trabalho longo do n8n.

Muitos nós padrão do n8n, como o nó Set do n8n demonstrado aqui, frequentemente não encaminham automaticamente dados binários para as etapas subsequentes. Essa 'perda de dados' é um obstáculo comum ao construir pipelines de processamento de arquivos. Este fluxo de trabalho do n8n fornece uma solução técnica robusta ao definir um padrão de recuperação customizado. Ao utilizar o nó Code do n8n e a função auxiliar interna $(), o fluxo de trabalho do n8n pode consultar qualquer nó anterior especificado (mesmo vários passos atrás) e recuperar o payload binário original. Esta técnica garante a integridade dos dados e é um padrão crítico para quem trabalha com templates sofisticados do n8n que envolvem transformações complexas de arquivos.

Este fluxo de trabalho do n8n começa com o gatilho Start do n8n, iniciando o processo. Primeiro, o nó HTTP Request 'Get n8n Logo (Binary)' busca um arquivo de imagem, criando dados binários no contexto do item atual. Em seguida, o nó Set subsequente 'Remove Binary Data' é executado. Como o nó Set do n8n não preserva dados binários por padrão, o anexo do arquivo é perdido, simulando um ponto de interrupção comum em um fluxo de trabalho complexo do n8n.

O núcleo deste fluxo de trabalho do n8n é o nó Code 'Re-Access Binary Data from Previous Node'. Este nó customizado do n8n executa JavaScript que ignora a saída do nó anterior e acessa diretamente a saída do item do nó 'Get n8n Logo (Binary)' usando o acessador $(nodeName).item. O script então itera pelos dados do arquivo binário recuperado, usa Buffer.from() para decodificá-lo e utiliza a função auxiliar essencial do n8n, this.helpers.prepareBinaryData(), para reconectar corretamente o objeto binário recuperado ao contexto de execução do item atual, restaurando o caminho dos dados para os nós subsequentes do n8n no fluxo.

1. Importar: Copie o código JSON do fluxo de trabalho do n8n fornecido e cole-o em sua instância do n8n usando a opção 'New' -> 'Import from JSON'.


2. Credenciais: Este fluxo de trabalho específico do n8n não requer credenciais, pois utiliza nós centrais do n8n e uma URL pública para demonstração.


3. Personalização: Se você adaptar este template do n8n para seus próprios arquivos, certifique-se de atualizar a variável previousNodeName dentro do nó Code 'Re-Access Binary Data from Previous Node' para corresponder ao nome do nó do n8n que gerou originalmente os dados binários que você deseja recuperar.


4. Execução: Clique no botão 'Run Workflow' para testar o fluxo de trabalho do n8n e observe como os dados binários são restaurados após terem sido descartados intencionalmente pelo nó intermediário Set do n8n.

Start (Gatilho do n8n): Um gatilho manual usado para iniciar facilmente este fluxo de trabalho específico do n8n para fins de teste e demonstração.
Get n8n Logo (Binary) (Requisição HTTP): Busca a imagem do logotipo do n8n de uma URL especificada, criando os dados binários que serão recuperados posteriormente no fluxo de trabalho do n8n.
Remove Binary Data (Set): Este nó do n8n é configurado para adicionar um campo de texto simples ('valor de teste'), mas descarta intencionalmente os dados binários, simulando um cenário em que arquivos binários não são passados automaticamente por nós intermediários do n8n.
Re-Access Binary Data from Previous Node (Code): O nó customizado central do n8n. Ele contém um script JavaScript que visa especificamente a saída do nó 'Get n8n Logo (Binary)' para recuperar o objeto binário bruto, decodifica os dados Base64 e usa this.helpers.prepareBinaryData para reintegrar o arquivo de volta ao fluxo do item atual. A variável codificada previousNodeName determina qual saída de nó anterior do n8n será acessada.