n8n-nodes-vars-ce

Nœud communautaire n8n qui fournit un petit stockage clé/valeur en mémoire, inspiré de $vars, pour l'édition Community Edition. Les données sont conservées dans la mémoire du processus Node.js et disparaissent au redémarrage.

Installation rapide

Consultez le fichier INSTALLATION.md pour obtenir toutes les options d'installation. La méthode recommandée est l'installation depuis l'interface d'administration de n8n :

Depuis l'interface d'administration de n8n (recommandé)

1. Accédez à l'interface d'administration de n8n
2. Allez dans Settings (Paramètres)
3. Ouvrez la section Community Nodes
4. Cliquez sur Install
5. Entrez le nom du package : n8n-nodes-vars-ce
   • Pour une version spécifique : [email protected]
6. Cochez la case de confirmation des risques
7. Cliquez sur Install

Le nœud Vars (CE) sera alors disponible dans la catégorie Transform après l'installation.

Depuis les sources (développement)

1. Installez les dépendances puis compilez :

npm install
npm run build

2. Définissez la variable d'environnement N8N_CUSTOM_EXTENSIONS vers le dossier dist compilé :

export N8N_CUSTOM_EXTENSIONS=/absolute/path/to/n8n-nodes-vars-ce/dist

3. Redémarrez votre instance n8n. Le nœud Vars (CE) sera alors disponible dans la catégorie Transform.

Utilisation

• Set : sélectionnez l'opération « Set » puis ajoutez autant de paires clé/valeur que nécessaire via le bouton d'ajout. Chaque exécution enregistre l'ensemble des paires et renvoie un objet JSON tel que { "best": "42", "other": "x" }, où chaque clé de sortie correspond à la clé stockée.
• Get : sélectionnez l'opération « Get » et ajoutez les clés à lire. La sortie est un objet JSON { "best": "42", "unknown": null }, idéal pour accéder directement aux valeurs via {{$json.best}}. Les clés absentes renvoient null.
• Reset : par défaut, l'opération « Reset » vide complètement la carte mémoire et retourne l'état précédent. Choisissez Keys Only pour cibler une liste de clés à réinitialiser : toutes les clés demandées doivent exister, sinon une erreur est levée.
• Merge Input : activez cette option pour fusionner l'objet d'entrée ($json) avec les données produites en sortie, évitant l'usage d'un nœud Merge supplémentaire.

Les collections de clés et de valeurs acceptent l'ajout et la suppression via les contrôles standards (« + » et poubelle) de l'interface n8n.

Publication sur npm

Le package n8n-nodes-vars-ce est publié sur npm et peut être installé depuis l'interface d'administration de n8n (voir section Installation rapide). Pour publier une nouvelle version :

1. Assurez-vous d'avoir un compte npm et d'être connecté :

npm login

2. Mettez à jour le numéro de version dans package.json si nécessaire :

npm version patch

3. Compilez le projet :

npm run build

4. Publiez le package :

npm publish --access public

Une fois publié, l'installation pourra se faire directement depuis l'interface d'administration de n8n (voir section Installation rapide) ou via npm install n8n-nodes-vars-ce. Pensez à pousser votre tag git correspondant à la version pour conserver l'historique.

Portée et comportement

• Les données sont conservées dans une Map<string, string> globale au processus : elles sont volatiles et disparaissent lors d'un redémarrage.
• Aucune persistance disque n'est effectuée et il n'y a pas de coordination entre plusieurs processus ou workers.
• Les clés et valeurs sont manipulées comme des chaînes simples, destinées à un usage interne à vos workflows CE.

Option « reset par exécution »

Si vous souhaitez effacer automatiquement le stockage à chaque exécution, décommentez le bloc indiqué en début de méthode execute dans src/VarsCe.node.ts :

// const runId = this.getExecutionId();
// if (runId !== undefined && store.get('__run') !== runId) {
//   store.clear();
//   store.set('__run', runId);
// }

Cette option compare l'identifiant d'exécution courant et réinitialise la carte lorsqu'il change.

Licence

Projet distribué sous licence Apache 2.0. Ce module n'ajoute aucune persistance ni fonctionnalité équivalente aux options payantes d'n8n ; il se contente d'exposer un stockage temporaire purement en mémoire.