Skip to main content

Welcome to a Grasp lesson

Create a free account to keep studying and create your own study path.

Lesson 9

Transformer et mapper les données avec les expressions n8n

Recommended resources

Bonjour ! Dans la leçon précédente, nous avons exploré comment utiliser les nœuds de logique IF et Switch pour diriger le flux de nos workflows. Vous avez eu un premier aperçu des expressions, ces petites instructions entre {{ }} qui nous ont permis de récupérer les données nécessaires pour nos conditions.

Aujourd'hui, nous allons plonger au cœur de ce mécanisme. L'objectif est de maîtriser les expressions n8n pour non seulement récupérer, mais aussi transformer et manipuler les données à la volée entre les nœuds. En tant que développeur, vous découvrirez que les expressions sont essentiellement des extraits de JavaScript, ce qui devrait rendre leur apprentissage très intuitif. Maîtriser les expressions est la compétence qui transformera vos workflows statiques en automatisations dynamiques et intelligentes.

À la fin de cette leçon, vous saurez comment accéder à n'importe quelle donnée transitant dans votre workflow, la formater, la nettoyer et la combiner pour répondre précisément à vos besoins.

Qu'est-ce qu'une expression n8n ?

Une expression n8n est un morceau de code JavaScript encapsulé dans des doubles accolades {{ }}. Lorsque n8n exécute un nœud, il évalue ce code et remplace l'expression par le résultat. C'est le principal moyen de rendre les paramètres de vos nœuds dynamiques.

Ces expressions sont utilisées partout : pour définir l'URL dans un nœud HTTP Request, pour créer le corps d'un e-mail, pour filtrer des données, ou, comme nous allons le voir, pour transformer des données dans des nœuds comme le Set ou l'Edit Fields.

Pour bien comprendre leur importance et leur fonctionnement, je vous propose de visionner cette vidéo qui explique le rôle fondamental du format de données JSON et pourquoi sa compréhension est la clé pour utiliser efficacement les expressions.

Si tu ne comprends pas le format des données sur n8n, cette vidéo est pour toi (guide JSON)

Cette vidéo de la chaîne "Ousmane Automatise" est un excellent guide sur le format de données dans n8n.

Regardez la première partie, qui explique ce qu'est le JSON et pourquoi il est essentiel pour créer des expressions dynamiques sur n8n (introduction au JSON). Ensuite, regardez la section sur la syntaxe de base (paires clé-valeur). Votre expérience en développement vous rendra ces concepts familiers, mais c'est un bon rappel dans le contexte de n8n.


Accéder aux données avec les expressions

La première étape pour manipuler une donnée est de savoir comment y accéder. Dans n8n, les données de l'item en cours de traitement sont principalement accessibles via une variable spéciale : $json.

Imaginez qu'un nœud précédent a produit la structure JSON suivante :

{
  "orderId": "AB-123",
  "customer": {
    "firstName": "Jean",
    "email": "jean@example.com"
  },
  "items": [
    { "product": "Livre", "price": 15 },
    { "product": "Stylo", "price": 2 }
  ]
}

Voici comment vous accéderiez aux différentes parties de cette structure :

  • Notation par point (Dot Notation) : Pour accéder aux propriétés d'un objet. C'est exactement comme en JavaScript.

    • {{ $json.orderId }} → retourne "AB-123"
    • {{ $json.customer.email }} → retourne "jean@example.com"
  • Notation par crochet (Bracket Notation) : Pour accéder aux éléments d'un tableau (un array). L'indexation commence à 0.

    • {{ $json.items[0].product }} → retourne "Livre"
    • {{ $json.items[1].price }} → retourne 2

Cette vidéo vous montrera de manière très concrète comment n8n vous aide à construire ces expressions, notamment par un simple glisser-déposer.

n8n : le Tutoriel Complet

Reprenons le tutoriel complet de "theyo". Cette section est un cas pratique parfait qui montre le passage de la théorie à la pratique.

Concentrez-vous sur le passage qui explique le mapping des données. L'auteur montre comment, en glissant une donnée, n8n génère automatiquement l'expression correspondante, comme {{$json.body.email}}, et explique la logique de la notation par points pour naviguer dans la structure JSON.


Transformer les données : la puissance de JavaScript

Le véritable pouvoir des expressions réside dans la possibilité d'utiliser les fonctions et opérateurs JavaScript pour transformer les données.

Ce nœud "Edit Fields" montre parfaitement comment les expressions permettent de transformer les données. Par exemple, la date est extraite et formatée, et les autres champs sont mappés à partir des données d'entrée.

Analysons l'expression pour le champ "Date" de l'image ci-dessus :
{{ $json.response.date.split('T')[0] }}

  1. $json.response.date : Accède à la valeur de la date, qui est probablement une chaîne au format ISO comme "2023-10-27T10:00:00.000Z".
  2. .split('T') : C'est une méthode JavaScript standard pour les chaînes de caractères. Elle coupe la chaîne au niveau du caractère 'T' et retourne un tableau : ["2023-10-27", "10:00:00.000Z"].
  3. [0] : On accède au premier élément de ce tableau, ce qui nous donne "2023-10-27".

En une seule ligne, nous avons extrait et reformaté une donnée. C'est bien plus efficace que d'ajouter un nœud de code dédié pour une opération si simple.

La vidéo suivante continue le cas pratique précédent et illustre parfaitement cette capacité de transformation.

n8n : le Tutoriel Complet

Continuons avec le même cas pratique.

Regardez attentivement la section sur la manipulation des données pour séparer le nom et le prénom. C'est un excellent exemple d'utilisation de la fonction .split() et de l'accès par index pour manipuler des chaînes de caractères.

Types de données et conversions

Comme en JavaScript, les données ont des types (String, Number, Boolean, Array, Object). Les expressions n8n sont sensibles à ces types. Par exemple, vous ne pouvez pas utiliser .split() sur un nombre.

Le guide vidéo ci-dessous détaille les différents types de données dans n8n et comment les reconnaître, ce qui est crucial pour appliquer les bonnes transformations.

Si tu ne comprends pas le format des données sur n8n, cette vidéo est pour toi (guide JSON)

Revenons à ce guide sur le JSON pour approfondir deux points.

D'abord, familiarisez-vous avec les différents types de données et leurs icônes dans l'interface n8n en regardant cette section. Ensuite, visionnez la partie sur la conversion de types, qui montre comment transformer une donnée d'un type à un autre, par exemple une String en Number.


Recettes et bonnes pratiques

Maintenant que vous comprenez les principes, voici un guide textuel qui vous servira de référence pour des manipulations plus avancées et des bonnes pratiques. En tant que développeur, vous apprécierez la rigueur de ces techniques.

Guide complet pour maitriser les expressions n8n

Cet article de "Formations Analytics" est une mine d'or d'exemples pratiques et de conseils d'experts.

Lisez attentivement ces trois sections : Comment écrire des expressions robustes : Vous y découvrirez l'optional chaining (?.) et le nullish coalescing (??), des pratiques que vous connaissez bien et qui sont essentielles pour éviter les erreurs lorsque des données sont absentes. Manipulation des chaînes : Cette section propose des "recettes" prêtes à l'emploi pour des tâches courantes comme la création de slugs ou l'extraction d'un domaine d'email. Manipulation des tableaux et objets : Découvrez des exemples concis utilisant .map(), .filter(), .reduce() pour agréger et transformer des collections de données.


Conclusion

Aujourd'hui, vous avez acquis une compétence centrale de n8n. Vous ne voyez plus les données comme des blocs statiques, mais comme une matière malléable que vous pouvez sculpter à volonté.

Voici les points clés à retenir :

  • Les expressions {{ }} sont des extraits JavaScript qui rendent vos workflows dynamiques.
  • La variable $json est le point d'entrée pour accéder aux données de l'item courant.
  • On navigue dans les données JSON avec la notation par point pour les objets et par crochets pour les tableaux.
  • Toutes les méthodes natives de JavaScript pour les chaînes, tableaux et objets peuvent être utilisées pour transformer les données.
  • Des techniques comme l'optional chaining (?.) permettent de construire des expressions robustes qui ne génèrent pas d'erreur en cas de données manquantes.

Nous avons vu comment effectuer des transformations complexes en une seule ligne. Cependant, il arrivera un moment où la logique deviendra trop complexe pour une simple expression. Vous aurez besoin de déclarer des variables, d'écrire des boucles ou d'utiliser des bibliothèques externes. C'est précisément l'objet de notre prochaine leçon : le nœud Function, qui vous ouvrira les portes de l'écriture de blocs de code JavaScript complets au sein même de vos workflows.