🇫🇷 Edit fields

Contacter Ocade Fusion

Le nœud Edit Fields est l’outil de transformation de données dans N8N. Il permet de créer, modifier, renommer et supprimer des variables à tout moment de votre workflow. Que vous souhaitiez structurer des données brutes, enrichir des informations existantes, ou préparer un format spécifique pour un nœud suivant, Edit Fields est votre couteau suisse. Ce guide vous accompagne dans la maîtrise des deux modes (JSON et Manual Mapping), les types de données, et les options avancées.

Qu’est-ce que le nœud Edit Fields ?

Le nœud Edit Fields (anciennement appelé « Set ») permet de manipuler les données qui transitent dans votre workflow. Vous pouvez créer de nouvelles variables, modifier des valeurs existantes, ou filtrer les champs à transmettre aux nœuds suivants.

C’est un nœud fondamental que vous utiliserez dans pratiquement tous vos workflows : pour préparer des données avant un envoi API, reformater une réponse, ou simplement stocker des valeurs intermédiaires.

Les deux modes de saisie

Mode JSON

Le mode JSON permet de définir vos données directement au format JSON. C’est la méthode la plus rapide pour créer des structures complexes ou importer des données existantes.

{
  "prenom": "Jean",
  "nom": "Dupont",
  "age": 50
}

Cliquez sur l’icône d’agrandissement pour avoir plus d’espace d’écriture. Le JSON doit être valide : accolades pour les objets, crochets pour les tableaux, guillemets pour les chaînes de caractères.

Mode Manual Mapping

Le mode Manual Mapping permet de créer les champs un par un, avec une interface visuelle. Chaque champ se compose de trois éléments : le nom de la variable, son type, et sa valeur.

Ce mode est plus lisible et facilite le glisser-déposer de valeurs depuis les nœuds précédents. Il est recommandé pour les workflows où vous devez récupérer dynamiquement des données.

Les types de données

String : chaîne de caractères

Le type String stocke du texte. C’est le type le plus courant pour les noms, emails, descriptions, ou tout contenu textuel. En JSON, les valeurs sont entre guillemets : "prenom": "Victor".

Number : nombre

Le type Number stocke des valeurs numériques : entiers ou décimaux. Utilisez-le pour les âges, montants, quantités. En JSON, pas de guillemets : "age": 23.

Boolean : vrai/faux

Le type Boolean stocke une valeur binaire : true (vrai) ou false (faux). Utilisez-le pour les états, validations, ou indicateurs. En JSON : "estActif": true.

Array : tableau

Le type Array stocke une liste ordonnée de valeurs. C’est l’équivalent d’une liste de courses : plusieurs éléments dans un ordre précis. En JSON, les tableaux sont entre crochets :

"listeCourses": ["salade", "tomate", "radis"]

Chaque élément est accessible par son index (position) : 0 pour le premier, 1 pour le deuxième, etc.

Object : objet

Le type Object stocke un ensemble de propriétés clé-valeur. C’est idéal pour représenter des entités complexes comme une personne, un produit, ou une configuration. En JSON :

"personne": {
  "prenom": "Bernadette",
  "age": 14,
  "taille": 160
}

Les objets peuvent contenir tous les autres types, y compris d’autres objets (imbrication).

Inclure des champs du nœud précédent

L’option Include Other Input Fields permet de conserver les données du nœud précédent en plus de celles que vous créez.

All : tout inclure

Sélectionnez All pour faire passer toutes les données précédentes plus vos nouvelles variables. Les données s’ajoutent sans écraser les existantes (sauf si vous créez une variable avec le même nom).

Selected : sélection

Sélectionnez Selected pour ne conserver que certains champs du nœud précédent. Faites glisser-déposer les champs souhaités ou saisissez leurs noms séparés par des virgules.

Except : exclusion

Sélectionnez Except pour inclure tous les champs sauf ceux que vous spécifiez. Utile pour exclure des données sensibles ou inutiles.

Options avancées

Strip Binary Data

Lorsque vous travaillez avec des fichiers (images, PDF, etc.), N8N stocke le fichier binaire et ses métadonnées. L’option Strip Binary Data conserve uniquement les métadonnées (nom, taille, extension) et supprime le fichier lui-même. Utile pour alléger le workflow si vous n’avez besoin que des informations sur le fichier.

Ignore Type Conversion Errors

Si vous définissez un champ comme Number mais lui passez une chaîne de caractères, N8N génère une erreur. L’option Ignore Type Conversion Errors ignore ces erreurs de type et continue le workflow. À utiliser avec précaution : les données incorrectes peuvent causer des problèmes dans les nœuds suivants.

Support Dot Notation

Cette option transforme les noms de variables avec des points en objets imbriqués. Par exemple :

• personne.prenom = « Jean »
• personne.age = 50
• personne.nom = « Dupont »

Devient automatiquement :

{
  "personne": {
    "prenom": "Jean",
    "age": 50,
    "nom": "Dupont"
  }
}

Sans cette option, vous obtiendriez trois variables distinctes nommées littéralement « personne.prenom », « personne.age », etc.

Panneau Settings

Le panneau Settings contient les options de comportement du nœud, communes à la plupart des nœuds N8N.

Always Output Data

Force le nœud à toujours renvoyer des données, même si le résultat est vide. Évite de bloquer le workflow en cas de réponse vide d’un nœud précédent.

Execute Once

Si plusieurs items arrivent en entrée (par exemple, un tableau de 10 personnes), le nœud ne s’exécute que sur le premier item. Utile pour les tests où vous ne voulez pas traiter toutes les données.

Retry On Fail

Relance automatiquement le nœud en cas d’échec. Configurez le nombre maximum de tentatives (jusqu’à 5) et l’intervalle entre chaque essai. Particulièrement utile pour les appels API ou les nœuds IA qui peuvent échouer temporairement.

On Error

Définit le comportement si le nœud échoue après toutes les tentatives :

• Stop Workflow : arrête complètement le workflow (défaut)
• Continue : ignore l’erreur et passe au nœud suivant
• Continue with Error Output : continue mais fournit les informations d’erreur pour traitement

Duplicate Item

Option spécifique au nœud Edit Fields : duplique les données en sortie le nombre de fois spécifié. Utile pour les tests où vous voulez simuler plusieurs entrées identiques.

Note et Display Note In Flow

Ajoutez une description au nœud. Activez Display Note In Flow pour afficher cette note sous le nœud dans l’éditeur. Indispensable pour documenter vos workflows.

Cas d’usage du nœud Edit Fields

• Préparation de données API : reformater les données avant un envoi HTTP Request.
• Enrichissement : ajouter des informations calculées ou statiques à des données existantes.
• Nettoyage : supprimer les champs inutiles ou sensibles avant transmission.
• Renommage : adapter les noms de champs aux attentes d’un service externe.
• Stockage temporaire : créer des variables intermédiaires utilisées plus loin dans le workflow.

À quoi sert l'option 'Support Dot Notation' dans le nœud Edit Fields ?

Elle permet d'accéder aux propriétés des objets du nœud précédent en utilisant la notation pointée. Sans cette option, vous ne pouvez pas lire les sous-propriétés des objets. Elle active la validation syntaxique des noms de variables et affiche une erreur si un nom contient des caractères non autorisés comme les points. Elle ajoute automatiquement un point à la fin de chaque nom de variable pour respecter les conventions de nommage JavaScript dans N8N. Elle transforme les noms de variables avec des points (comme 'personne.prenom') en objets imbriqués. Au lieu d'avoir une variable nommée littéralement 'personne.prenom', vous obtenez un objet 'personne' contenant une propriété 'prenom'.

Conclusion

Le nœud Edit Fields est indispensable dans N8N. Que vous créiez des variables en JSON ou via le Manual Mapping, maîtriser ce nœud vous permet de structurer, transformer et enrichir vos données à chaque étape du workflow. Les options comme Support Dot Notation et Include Other Input Fields offrent une flexibilité précieuse pour des cas d’usage variés.

Le point clé à retenir : utilisez le mode JSON pour les structures complexes ou l’import de données, et le Manual Mapping pour le glisser-déposer dynamique depuis les nœuds précédents. Pour aller plus loin, explorez nos autres ressources N8N ou contactez notre équipe pour concevoir des workflows adaptés à vos besoins métier.

Vous recherchez d’autres contenus ?