O que o Edit Fields Faz
O nó Set, agora chamado de nó Edit Fields no n8n, é a pedra fundamental para moldar e reestruturar dados como sua "fonte única de verdade". Ele permite criar, renomear, formatar, combinar e preparar qualquer variável que seu workflow precise para nós downstream.
- Define, sobrescreve ou cria novos campos nos dados de item do seu workflow
- Edita nomes de campos, valores e tipos de dados (string, number, boolean, array, object)
- Permite mapeamento manual (usando expressões ou valores fixos) ou autoria direta de JSON para estruturas complexas
- Permite limpar, formatar e padronizar entrada para que cada nó downstream saiba exatamente onde encontrar seus dados necessários
Principais Casos de Uso
- Normalização de dados: Alterar tipos de dados ou corrigir valores de fontes inconsistentes (ex: converter timestamps, dividir/combinar campos)
- Criar novas variáveis para lógica, chamadas de API ou relatórios
- Reestruturar payloads JSON para requisições de saída ou inserções de banco de dados
- Manter, remover ou mesclar campos seletivamente para produzir apenas as variáveis relevantes necessárias downstream
- Armazenar valores estáticos ou calculados (ex: "status=approved", "price=total * 0.8") para uso posterior no workflow
Como Configurar e Usar
- Inserir o Nó: Adicione após qualquer nó que gere dados brutos, não estruturados ou bagunçados
- Escolher Modo:
- Manual Mapping: Arraste e solte campos da entrada, defina valores fixos ou expressões
- JSON Output: Edite ou cole diretamente um objeto JSON para transformar o item inteiro
- Definir Campos:
- Especifique novos nomes de campos e valores
- Altere tipos de dados, crie arrays/objetos e aplique fórmulas com expressões
- "Include Other Input Fields" pode manter todos os dados originais, ou escolha "Keep Only Set Fields" para descartar tudo exceto campos adicionados explicitamente
- Notação de ponto permite aninhar campos (ex: "user.name" ou "address.street"), ou pode desabilitar para objetos planos
- Saída: Nós downstream sempre referenciam os valores limpos e estruturados do seu nó Edit Fields, tornando as automações confiáveis e modulares
Melhores Práticas e Dicas
- Use cedo no seu workflow (frequentemente logo após o trigger ou primeiro nó de dados) para padronizar todos os dados e prevenir problemas mais tarde
- Agrupe variáveis relacionadas à lógica em um único objeto para referência e manutenção mais fáceis
- Combine com Aggregate/Split Out para processar dados em massa ou individualmente, depois moldá-los para resumo, mensagens ou armazenamento
- Verifique "Keep Only Set Fields" se precisar de payloads ultra-limpos para APIs ou bancos de dados
Exemplo Prático
Cenário: Padronizando Dados de Webhook
Um webhook recebido retorna {username: "john", timestamp: "2024-01-01T08:00:00Z"}
Você usa o nó Edit Fields para:
- Renomear "username" para "user_id"
- Converter "timestamp" para uma data formatada
- Adicionar um novo campo "status: active"
Resultado: Seus nós downstream veem apenas campos bem nomeados e com tipos corretos, perfeitos para integração ou relatórios.
O nó Edit Fields é essencial para construir automações robustas, legíveis e manuteníveis. Ele dá controle total sobre os dados do seu workflow, definindo um único ponto onde "verdade" e estrutura são garantidas.