Restauration de données avec itemMatching() dans un nœud Code - Workflow n8n

Cette automatisation est idéale pour :
Les développeurs n8n qui apprennent des techniques de script avancées.
Les utilisateurs ayant besoin de méthodes fiables pour préserver la lignée des données à travers des workflows n8n complexes.
Les ingénieurs concevant des modèles n8n modulaires où les indices des éléments doivent être conservés pour la corrélation des données.
Toute personne cherchant à approfondir sa compréhension de la manipulation des données dans le contexte d'exécution de n8n.

Lors de la construction de workflows n8n complexes, il est souvent nécessaire de transformer ou de filtrer des flux de données, ce qui peut parfois entraîner la perte temporaire de champs d'origine (comme les e-mails ou les identifiants). Ce workflow n8n spécifique apporte une solution robuste utilisant la fonction intégrée itemMatching() disponible dans le nœud Code n8n.

L'intérêt de cette automatisation n8n réside dans la garantie de l'intégrité des données. Elle simule un scénario où les données initiales sont générées, puis drastiquement élaguées (ne conservant que les noms), et enfin, l'adresse e-mail d'origine est récupérée et restaurée avec précision grâce à la corrélation des indices d'éléments. Cette approche est vitale pour la manipulation avancée de données et démontre l'une des fonctionnalités les plus puissantes de l'environnement de scripting n8n pour lier des éléments de données entre différentes étapes du workflow n8n.

Ce workflow n8n fonctionne en quatre phases distinctes :

1. Initialisation (Déclencheur Manuel) : Le déclencheur n8n démarre le processus lorsque l'utilisateur clique sur 'Exécuter le workflow'.


2. Génération des données : Le nœud n8n Customer Datastore (n8n training) génère une liste d'enregistrements clients d'exemple, incluant noms et adresses e-mail. Cela établit le flux de données initial.


3. Réduction des données : Le nœud n8n Edit Fields (Set) supprime intentionnellement tous les champs sauf le nom du client. Ceci simule un scénario courant où les données sont rationalisées et où le contexte d'origine semble perdu.


4. Restauration des données (Nœud Code) : Le nœud n8n final, un nœud Code Python, exécute la logique centrale. Il parcourt les éléments de données réduits. Pour chaque élément, il utilise la méthode itemMatching(i), en faisant référence à la sortie de données d'origine du nœud n8n 'Customer Datastore', pour récupérer l'adresse e-mail correspondante en se basant sur l'indice i. Cet e-mail récupéré est ensuite rajouté à l'élément actuel sous un nouveau champ nommé restoreEmail. Cette technique puissante assure la cohérence des données tout au long du workflow n8n.

Pour déployer ce modèle n8n, suivez ces étapes :

1. Importer le workflow n8n : Copiez le code JSON fourni.


2. Ouvrez votre instance n8n et naviguez vers la section 'Workflows'.


3. Cliquez sur 'Nouveau' ou 'Importer depuis JSON' et collez le code.


4. Exécution : Étant donné que ce workflow n8n utilise un déclencheur manuel n8n et des nœuds de données factices (à des fins de formation), aucune information d'identification externe n'est requise.


5. Cliquez sur le bouton 'Exécuter le workflow' sur le nœud n8n 'When clicking "Execute Workflow"' pour voir la logique de correspondance d'éléments en action. Examinez la sortie du nœud Code n8n final pour confirmer que les adresses e-mail ont été restaurées avec succès.

Ce workflow n8n tire parti des types de nœuds n8n clés suivants :

When clicking "Execute Workflow" (Déclencheur Manuel) :
Fonction :
Sert de déclencheur n8n de départ pour les tests et le développement.
Configuration clé :
Aucune configuration requise ; démarre le workflow n8n à la demande.

Customer Datastore (n8n training) :
Fonction :
Génère des données d'exemple (clients avec noms et e-mails) pour fournir un flux de données source.
Configuration clé :
Opération définie sur getAllPeople, avec returnAll coché.

Edit Fields (Set) :
Fonction :
Ce nœud n8n effectue une transformation de données, réduisant les éléments entrants pour ne conserver que le champ 'name'. Cela simule le scénario de perte de données que nous avons l'intention de corriger.
Configuration clé :
N'inclut que le champ name, réglant l'option d'entrée sur none pour supprimer tous les autres champs.

Code (Python) :
Fonction :
Le nœud n8n critique où la méthode itemMatching() est utilisée. Il met en corrélation l'indice de l'élément actuel avec l'indice d'origine provenant du 'Customer Datastore' pour récupérer l'e-mail original.
Configuration clé :
Utilise la logique Python :

for i,item in enumerate(input.all()):
          input.all()[i].json.restoreEmail = ('Customer Datastore (n8n training)').itemMatching(i).json.email
        return input.all();