Aller au contenu principal

Gestion des Dictionnaires

Conseils et astuces pour bien utiliser les dictionnaires dans vos projets.

Prérequis

Pour créer et configurer vos dictionnaires, consultez la documentation Dictionnaires.

Principe clé​

Pourquoi les dictionnaires ?

Plutôt que de saisir des valeurs en dur dans chaque nœud, utilisez les dictionnaires pour :

  • Centraliser toutes vos variables
  • Avoir des valeurs différentes par environnement
  • Modifier une valeur à un seul endroit

Syntaxe : une valeur de dictionnaire s'exprime au format {{dictionaries.nomDuDico.cleDuDico}}, ce qui permet de dynamiser la valeur selon l'environnement d'exécution.

Astuces d'organisation​

Un dictionnaire par domaine​

Astuce : Organisez par système/domaine
api-erp          → Variables liées à l'ERP
api-ecommerce    → Variables liées à l'e-commerce
sftp-partenaire  → Accès SFTP partenaire
config-global    → Configuration globale

Nomenclature des clés​

Astuce : Noms explicites
✅ Bon                    ❌ À éviter
api_base_url              url
api_client_id             id
sftp_host                 host1
sftp_port                 temp_value

Fonctionnalité pratique : création rapide​

Pro Tip : Créez depuis un nœud

Lors de la saisie d'une valeur dans un nœud :

  1. Saisissez la valeur
  2. Clic droit → "Définir comme variable"
  3. Choisissez le dictionnaire à enrichir

Cette fonctionnalité permet d'extraire rapidement des valeurs hardcodées vers des dictionnaires.

Duplication de valeurs​

Astuce : Dupliquez entre environnements

Si la même valeur est utilisée dans plusieurs environnements :

  1. Cliquez sur les trois petits points à côté de l'environnement source
  2. Sélectionnez "Dupliquer les valeurs vers"
  3. Choisissez l'environnement cible

Utile pour initialiser rapidement un nouvel environnement.

Dictionnaires vs Méthodes d'authentification​

Important : Ne confondez pas !
DictionnairesMéthodes d'authentification
Variables de configurationSecrets d'authentification
Valeurs visiblesValeurs masquées/chiffrées
URLs, timeouts, IDs publicsMots de passe, tokens, clés

Règle : Si c'est un secret → utilisez les méthodes d'authentification

Ce qui va dans les dictionnaires​

✅ URLs d'endpoints ✅ Identifiants clients (non secrets) ✅ Timeouts et configurations ✅ Chemins de fichiers

Ce qui va dans les méthodes d'authentification​

❌ Mots de passe ❌ Clés API privées ❌ Tokens d'authentification

Utilisation dans les déclencheurs​

Pro Tip : Variables dans les triggers

Les dictionnaires sont particulièrement utiles dans les déclencheurs.

Exemple SFTP :

  • Hôte : {{dictionaries.sftp_import.host}}
  • Port : {{dictionaries.sftp_import.port}}
  • Répertoire : {{dictionaries.sftp_import.directory}}

Le même déclencheur pointe vers différents serveurs selon l'environnement !

Checklist dictionnaires​

Avant de déployer, vérifiez
  • Les valeurs sont renseignées pour tous les environnements
  • Les clés utilisent une nomenclature cohérente
  • Les secrets sont dans les méthodes d'authentification (pas les dictionnaires)
  • Les variables hardcodées sont externalisées

En savoir plus​