Aller au contenu principal

Gestion des dictionnaires

Les dictionnaires remplacent les valeurs en dur saisies dans chaque nœud par un endroit unique, décliné par environnement. C'est le mécanisme central de la dynamisation des flux : une modification se fait à un seul endroit et s'applique à tous les flux au prochain déploiement. Pour créer et configurer des dictionnaires, voir Dictionnaires.

Comment ça s'articule​

  • Une valeur de dictionnaire s'exprime au format {{dictionaries.nomDuDico.cleDuDico}} et se dynamise selon l'environnement d'exécution.
  • Un dictionnaire par domaine facilite la maintenance : api-erp (variables ERP), api-ecommerce, sftp-partenaire (accès SFTP), config-global (configuration globale).
  • Une nomenclature de clés claire évite les collisions et les ambiguïtés :
✅ Bon                    ❌ À éviter
api_base_url              url
api_client_id             id
sftp_host                 host1
sftp_port                 temp_value

Fonctionnalités pratiques​

  • Création rapide — lors de la saisie d'une valeur dans un nœud, clic droit → « Définir comme variable », puis choisissez le dictionnaire à enrichir : la valeur en dur est externalisée sans copier-coller.
  • Duplication de valeurs — pour initialiser un nouvel environnement : cliquez sur les trois petits points à côté de l'environnement source, puis « Dupliquer la clé et ses valeurs » et choisissez l'environnement cible.

Dictionnaires vs méthodes d'authentification​

Les deux espaces peuvent contenir des secrets. La différence ne porte pas sur « secret → méthode d'authentification, configuration → dictionnaire », mais sur ce que l'on centralise :

DictionnairesMéthodes d'authentification
Centralisent des variables par environnementCentralisent un schéma d'authentification
Réutilisables dans n'importe quel champ (URL, headers…)Sélectionnées dans les nœuds qui supportent l'auth
Les valeurs peuvent être masquéesLes valeurs sont chiffrées et masquées
Règle d'or

Un secret peut vivre dans un dictionnaire, pourvu qu'il soit masqué. Le vrai critère : si plusieurs nœuds partagent le même schéma d'auth, centralisez-le dans une méthode d'authentification. Si une valeur — secrète ou non — varie selon l'environnement et se réutilise dans des champs, elle va dans un dictionnaire. Comparatif complet : Gestion des méthodes d'authentification.

Ce qu'il faut savoir avant de commencer​

  • Les dictionnaires dans les déclencheurs — la configuration d'un déclencheur (ex. connexion SFTP : hôte, port, répertoire) accepte {{dictionaries.sftp_import.host}} : le même déclencheur pointe vers différents serveurs selon l'environnement.
  • La valeur d'un secret doit être masquée dans l'interface pour ne pas apparaître en clair dans les traces.
Avant de déployer
  • Les valeurs sont renseignées pour tous les environnements
  • Les clés utilisent une nomenclature cohérente
  • Les secrets stockés dans les dictionnaires sont masqués
  • Les schémas d'auth partagés sont centralisés dans des méthodes d'authentification
  • Les variables en dur sont externalisées

Aller plus loin​

Voir aussi : Dictionnaires