Dictionnaires
Les dictionnaires permettent de gérer des variables configurables par environnement.
Qu'est-ce qu'un dictionnaire ?
Un dictionnaire est un conteneur de variables :
- Stocke des paires clé–valeur (entrées)
- Valeurs paramétrables selon l'environnement d'exécution
- Réutilisable dans les flux
- Les valeurs sensibles peuvent être masquées dans l'interface
Cas d'usage
Les dictionnaires servent notamment à :
- Configuration : URL, points de terminaison, paramètres
- Secrets variabilisés par environnement : clés API, tokens, mots de passe — les valeurs sensibles peuvent être masquées dans l'interface et sont consommées dans les champs des nœuds comme dans les champs des méthodes d'authentification
- Variables métier : paramètres modifiables sans republier le flux
- Séparer les environnements : mêmes clés, valeurs différentes en dev, staging, production
Structure
| Élément | Rôle |
|---|---|
| Nom | Identifie le dictionnaire dans Ecosystem et dans les références |
| Entrées | Paires clé–valeur (équivalent conceptuel des entries dans l'interface) |
| Environnements | Jeu de valeurs par environnement pour chaque clé |
Syntaxe d'utilisation
Une valeur s'exprime au format {{dictionaries.nomDuDico.cleDuDico}} dans les champs des nœuds (en-têtes, URL, paramètres, etc.) :
Exemple : {{dictionaries.api.baseUrl}} renvoie la valeur de la clé baseUrl du dictionnaire api pour l'environnement actif.
Valeurs par environnement
Une même clé peut avoir une valeur différente par environnement (développement, staging, production). Lors de la création ou de la modification d'une entrée — voir Gérer les entrées — vous sélectionnez les environnements concernés et définissez une valeur pour chacun.
Dictionnaire api, clé baseUrl :
| Environnement | Valeur |
|---|---|
| Développement | https://api-dev.example.com |
| Production | https://api.example.com |
Dans un flux, {{dictionaries.api.baseUrl}} est résolu automatiquement selon l'environnement d'exécution : la valeur de développement en dev, celle de production en production, sans modifier le flux.