Ressources · Intégration n8n

Nœud Edit Fields (Set) n8nConfigurer Edit Fields (Set) dans n8n.

Entre deux nœuds, il faut presque toujours remettre les données en forme. C'est le rôle du nœud Edit Fields (Set) n8n : il ajoute des champs, écrase ceux qui existent et décide du sort du reste de l'item. Sept paramètres couvrent le mapping, la duplication et les fichiers.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert le nœud Edit Fields (Set) n8n ?

Edit Fields (Set) modifie, ajoute ou retire des champs sur les items qui traversent un workflow, c'est-à-dire la suite de nœuds enchaînés dans n8n. Placé entre deux nœuds, il donne au suivant une forme stable : les noms de champs choisis, les valeurs construites, et uniquement les données d'entrée gardées volontairement. Le nœud est livré avec n8n, sur le Cloud comme en auto-hébergé.

Premier cas, le plus fréquent. Un trigger, le nœud qui déclenche le workflow, envoie un item dont les noms de champs viennent de l'outil source et pas de la destination. Mode sur Manual Mapping, les valeurs glissées à la main, et la ligne écrite dans Google Sheets porte enfin les noms de colonnes du tableau.

Deuxième cas : fabriquer un corps de requête. Quand un workflow appelle une API via HTTP Request, le corps attendu contient souvent des clés imbriquées qu'aucun nœud précédent ne produit. Le mode JSON écrit cet objet directement, expressions comprises, et Support Dot Notation tranche : un nom comme number.one s'imbrique, ou reste tel quel.

Troisième cas, l'allègement. Un item qui traîne quarante champs ne ralentit rien, mais il rend le panneau suivant illisible et emporte des données qui n'ont rien à faire dans un message Slack. Include in Output réglé sur All Input Fields Except, avec deux ou trois noms dans Fields to Exclude, suffit à nettoyer.

Quand vaut-il mieux prendre autre chose ? Edit Fields travaille champ par champ. Dès qu'il faut boucler, tester une condition ou parcourir un tableau, le nœud Code est plus à sa place. Et une valeur qui n'existe nulle part en amont doit d'abord être récupérée, par le nœud dédié de l'outil ou par HTTP Request, avant qu'Edit Fields puisse la poser.

Les limites se voient vite. Le nœud n'a aucune opération et aucun credential, ce mot désignant les identifiants stockés dans n8n : rien ne sort vers un service externe ici. Il traite les items reçus, donc une entrée vide ne produit aucune sortie. Et Ignore Type Conversion Errors n'existe qu'en Manual Mapping : en mode JSON, une valeur bancale fait échouer l'exécution. La Formation n8n revient sur ces réflexes de construction.

Paramètres

Quels paramètres propose le nœud ?

Le nœud Edit Fields (Set) compte 7 paramètres. Pour chacun : le nœud tel que tu le configures dans n8n, ce que le paramètre change, et nos notes de terrain.

01

Mode

mode

Ce que tu vois dans n8n

Notes & cas d'usage

Mode détermine la façon de décrire la sortie : par l'interface, ou en écrivant soi-même l'objet. C'est le premier choix à faire, parce que le reste du panneau en dépend.

Paramètres clés

  • Manual Mapping (manual) : éditer les champs un par un, ce qui ouvre Fields to Set, où chaque champ reçoit un nom et une valeur.
  • JSON (raw) : personnaliser la sortie en JSON, saisi dans le champ JSON, expressions comme {{ $json.id }} comprises.
Cas d'usage
Manual Mapping pour trois champs renommés avant une insertion en base. JSON dès que la structure attendue comporte des objets imbriqués ou des tableaux.
02

Duplicate Item

duplicateItem

Ce que tu vois dans n8n

Notes & cas d'usage

Activé, ce réglage recopie l'item un nombre fixé de fois au lieu de le laisser passer une seule fois. C'est un outil de mise au point, pas une façon de générer du volume.

Paramètres clés

  • Duplicate Item (duplicateItem) : indique si l'item doit être dupliqué un nombre défini de fois.
  • Duplicate Item Count (duplicateCount) : combien de fois l'item est dupliqué, surtout pour les tests et le débogage.
Cas d'usage
envoyer plusieurs items identiques au nœud suivant pour observer son comportement sur un lot, sans attendre qu'un vrai déclenchement les apporte.
03

Include in Output

include

Ce que tu vois dans n8n

Notes & cas d'usage

Ce paramètre décide du sort des champs d'entrée auxquels tu n'as pas touché. Laissé de côté, c'est la première raison pour laquelle un champ disparaît plus loin dans le workflow.

Paramètres clés

  • All Input Fields (all) : garder aussi tous les champs inchangés de l'entrée.
  • No Input Fields (none) : ne garder que les champs définis plus haut.
  • Selected Input Fields (selected) et Fields to Include : la liste des noms de champs à conserver, séparés par des virgules.
  • All Input Fields Except (except) et Fields to Exclude : la même liste, prise dans l'autre sens.
Cas d'usage
retirer un identifiant interne avant que l'item ne parte vers une réponse publique, pendant que les autres champs continuent leur route.
04

Include Binary File

options.includeBinary

Ce que tu vois dans n8n

Notes & cas d'usage

Un item peut transporter des données binaires à côté de son JSON, un PDF ou une image attrapés plus haut. Cette option dit si ce fichier traverse le nœud.

Paramètres clés

  • Include Binary File (includeBinary) : inclure les données binaires si l'item d'entrée en contient.
Cas d'usage
une facture téléchargée en amont conserve son fichier pendant que ses métadonnées changent de nom, pour que le nœud qui l'envoie trouve encore quelque chose à transmettre.
05

Strip Binary Data

options.stripBinary

Ce que tu vois dans n8n

Notes & cas d'usage

L'option symétrique de la précédente. Ici le fichier est retiré volontairement, et seule la partie JSON de l'item poursuit son chemin.

Paramètres clés

  • Strip Binary Data (stripBinary) : retirer les données binaires de l'item d'entrée. Ne s'applique que si Include Other Input Fields est activé.
Cas d'usage
un workflow qui a lu une pièce jointe et n'a plus besoin que du texte extrait, où traîner le fichier dans tous les nœuds restants n'apporte rien.
06

Ignore Type Conversion Errors

options.ignoreConversionErrors

Ce que tu vois dans n8n

Notes & cas d'usage

Chaque champ défini en Manual Mapping porte un type. Quand la valeur reçue ne correspond pas, l'exécution s'arrête. Cette option assouplit ce contrôle.

Paramètres clés

  • Ignore Type Conversion Errors (ignoreConversionErrors) : ignorer les erreurs de type et appliquer une conversion moins stricte. Manual Mapping uniquement.
Cas d'usage
une date qui arrive en texte sur certains items et en nombre sur d'autres, où bloquer tout le traitement pour un cas isolé coûte plus cher qu'une conversion souple.
07

Support Dot Notation

options.dotNotation

Ce que tu vois dans n8n

Notes & cas d'usage

Par défaut, un point dans un nom de champ crée un objet imbriqué. Désactivé, le point redevient un simple caractère du nom.

Paramètres clés

  • Support Dot Notation (dotNotation) : activé, un nom number.one avec la valeur 20 donne { "number": { "one": 20 } } ; désactivé, il donne { "number.one": 20 }.
Cas d'usage
une API dont les noms de champs contiennent eux-mêmes des points, où l'imbrication enverrait une structure que l'endpoint n'attend pas.
Besoin d'aide

Besoin d'aide pour automatiser Edit Fields (Set) avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Les questions qui reviennent sur ce nœud

01Le nœud Edit Fields (Set) est-il inclus dans n8n ?
Oui. Edit Fields (Set) fait partie des nœuds core livrés avec n8n, aussi bien sur n8n Cloud que sur une instance auto-hébergée. Rien à installer, aucun paquet à ajouter, aucun surcoût côté n8n pour s'en servir. Un workflow construit avec ce nœud se comporte de la même façon quel que soit l'hébergement choisi, ce qui compte le jour où un workflow passe d'une instance locale au Cloud ou l'inverse. Le nœud n'appelle aucun service externe, donc il n'alourdit non plus aucune facture tierce.
02Que faut-il configurer avant de s'en servir ?
Rien côté compte. Le nœud n'a ni credential, c'est-à-dire des identifiants enregistrés dans n8n, ni sélecteur Authentication. Pas de clé à créer, pas de droit à accorder, pas de connexion à tester. Ce qu'il lui faut, en revanche, c'est un item en entrée : il s'exécute sur chaque item reçu et n'ouvre pas un workflow, donc un déclencheur le précède, Schedule Trigger, Webhook ou le trigger d'un outil. Les valeurs venues de ce nœud précédent se citent avec une expression du type {{ $json.champ }}.
03Quelles limites a le nœud Edit Fields (Set) n8n ?
Il met en forme des champs, et rien d'autre. Aucune opération à appeler, aucune API derrière lui : tout ce qui doit être récupéré, cherché ou envoyé relève d'un autre nœud. Ignore Type Conversion Errors ne vaut qu'en Manual Mapping, donc une valeur mal formée en mode JSON arrête l'exécution. La page décrit la version 3 du nœud, la plus élevée du catalogue : un workflow ancien peut afficher une version antérieure, avec moins d'options, et un nœud ne change jamais de version tout seul.
04Edit Fields ou le nœud Code ?
Edit Fields quand le travail consiste à nommer et à affecter des valeurs. Quelques champs renommés, un corps de requête assemblé, des données d'entrée écartées via Include in Output : le panneau raconte ce qui se passe sans qu'il faille lire du code. Code quand la logique elle-même est le sujet, avec une boucle, une condition ou une transformation qui court sur plusieurs items. Un bon signal : si l'objet saisi en mode JSON demande de la logique pour être construit, cette logique appartient au nœud Code.
05n8n ou Make pour ce type de mapping ?
Les deux remettent des données en forme entre deux étapes, donc le choix se joue ailleurs. n8n s'auto-héberge en Docker ou en npm, ou s'utilise sur n8n Cloud, avec un workflow identique dans les deux cas : utile quand les données qui passent par ce nœud doivent rester sur ton infrastructure. Make est hébergé uniquement, sans option d'auto-hébergement, et se facture à l'opération, donc un workflow qui traite beaucoup d'items voit son coût suivre son volume. La logique visuelle diffère aussi, et là c'est surtout une affaire d'habitude.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.