Introduction

L'éditeur n8n est l'endroit où vous passerez le plus de temps — construire, tester et déboguer des workflows d'automatisation. Avant d'écrire la moindre logique, vous devez vous sentir à l'aise dans l'interface. Cette leçon vous guide à travers chaque zone majeure de l'éditeur et présente les trois blocs de construction dont est fait chaque workflow n8n : les workflows, les nodes et les connexions.

L'interface de l'éditeur

Lorsque vous ouvrez n8n et créez un nouveau workflow, vous arrivez sur le canvas — une grille vierge où vous glissez, déposez et connectez les éléments. L'interface comporte quelques zones clés à connaître.

La barre supérieure contient le nom du workflow (cliquez dessus pour le renommer), le bouton Save, et le bouton Execute Workflow, qui exécute l'intégralité du workflow manuellement. À l'extrême droite, vous avez accès aux paramètres du workflow et au menu de votre compte.

La barre latérale gauche est votre panneau de nodes. Cliquez sur l'icône plus ou appuyez sur Tab pour l'ouvrir. C'est ici que vous recherchez et ajoutez des nodes au canvas. Les nodes sont regroupés par catégorie : les trigger nodes (les points de départ), les action nodes (ceux qui effectuent le travail) et les utility nodes (assistants de transformation de données).

Le canvas lui-même prend en charge quelques raccourcis de navigation qu'il vaut mieux apprendre tôt. La molette permet de zoomer et dézoomer. Maintenez Espace et faites glisser pour vous déplacer. Appuyez sur Ctrl+Shift+F (ou Cmd+Shift+F sur Mac) pour adapter l'intégralité du workflow à la vue.

Workflows, Nodes et Connexions

Chaque automatisation dans n8n est un workflow — un document sauvegardé qui contient un graphe de nodes connectés entre eux. Un workflow peut être actif (s'exécute automatiquement lorsqu'il est déclenché) ou inactif (s'exécute uniquement lorsque vous l'exécutez manuellement).

Un node est une unité de travail unique. Chaque node a une fonction spécifique : récupérer des données depuis une API, transformer une valeur, envoyer un email, insérer une ligne dans une base de données. Les nodes sont les verbes de votre automatisation. Quand vous double-cliquez sur un node, son panneau de paramètres s'ouvre sur le côté droit, où vous configurez ce qu'il fait.

Les nodes existent en deux variantes. Les trigger nodes démarrent un workflow — ils écoutent un événement (un appel webhook, une planification, une nouvelle ligne dans une feuille) et se déclenchent lorsque cet événement survient. Chaque workflow nécessite exactement un trigger node, et il se place toujours à gauche. Les nodes réguliers effectuent le travail réel et s'enchaînent à partir du trigger.

Les connexions sont les flèches entre les nodes. Elles transportent les données d'un node au suivant. Pour tracer une connexion, survolez le bord droit d'un node jusqu'à voir un cercle, puis glissez vers la poignée d'entrée du node suivant. Les données circulent de gauche à droite.

Travailler avec les données des nodes

n8n fait transiter les données entre les nodes sous forme de tableau d'items. Chaque item est un objet JSON. Lorsqu'un node s'exécute, il reçoit des items du node précédent, les traite, et produit de nouveaux items pour le node suivant.

Pour voir quelles données un node a produites, cliquez dessus après une exécution de test. Le panneau de sortie affiche chaque item sous forme d'objet JSON formaté. C'est votre principal outil de débogage — vous inspectez la sortie de chaque node pour vérifier que les données sont correctes avant de construire l'étape suivante.

Voici à quoi ressemble un item typique dans le panneau de sortie :

{
  "id": 42,
  "name": "Alice",
  "email": "alice@example.com",
  "createdAt": "2024-01-15T10:30:00Z"
}

Pour référencer une valeur provenant d'un node précédent dans un champ de paramètre, n8n utilise des expressions. Vous basculez un champ du texte statique vers une expression en cliquant sur le toggle d'expression (la petite icône signe égal à côté du champ). Dans une expression, vous utilisez la syntaxe ci-dessous pour extraire une valeur :

{{ $json.email }}

Cela extrait le champ email de l'objet JSON de l'item courant. Vous utiliserez ce pattern en permanence — c'est la principale façon dont les nodes communiquent entre eux.

Sauvegarder et exécuter

Sauvegardez toujours votre workflow avant de l'exécuter. Appuyez sur Ctrl+S (ou Cmd+S) ou cliquez sur le bouton Save. Les modifications non sauvegardées sont signalées par un point à côté du nom du workflow.

Pour tester un workflow, cliquez sur Execute Workflow dans la barre supérieure. n8n exécute chaque node à partir du trigger et affiche une coche verte sur chaque node ayant réussi ou un badge d'erreur rouge sur ceux ayant échoué. Cliquez sur un node en échec pour lire le message d'erreur dans son panneau de sortie.

Pour les trigger nodes qui attendent des événements externes (comme un node Webhook), n8n dispose d'un Test mode. Cliquez sur Listen for Test Event sur le node Webhook, puis déclenchez la requête depuis votre système externe. n8n capture un véritable payload et vous permet de construire et tester le reste du workflow sur la base de ces données sans attendre un autre événement réel.

Résumé

L'éditeur n8n s'articule autour d'un canvas, d'une bibliothèque de nodes et des connexions entre eux. Les workflows contiennent votre logique d'automatisation. Les trigger nodes lancent l'exécution. Les nodes réguliers traitent les données. Les connexions transportent les items JSON de gauche à droite. Le panneau de sortie après chaque exécution de test vous permet de vérifier que tout fonctionne. Prenez vos aises en cliquant partout, en ajoutant des nodes et en inspectant les sorties — le reste du cours s'appuie directement sur ces mécanismes.