Pour définir les valeurs des entrées qui apparaissent de manière répétée dans plusieurs chaînes ou commandes au sein d'une même chaîne, vous pouvez utiliser les variables . Plutôt que de saisir la même valeur dans plusieurs chaînes ou commandes, vous pouvez la définir comme une variable et gérer sa valeur en un seul endroit.
- Les variables de l'espace de travail définissent des valeurs qui apparaissent dans plusieurs chaînes.
- Les variables de chaîne définissent des valeurs qui apparaissent dans plusieurs commandes d'une chaîne et qui peuvent changer fréquemment.
- Les variables dynamiques définissent les valeurs à définir lors de l'exécution d'une chaîne ou pendant l'exécution d'une chaîne, par exemple en fonction de la sortie d'une commande antérieure.
Formation complémentaire disponible
Vous pouvez apprendre la puissance des chaînes grâce à notre cours autodidacte dans le Workiva Learning Hub. Ce cours complet vous guide tout au long du processus de création d’une chaîne, du début à la fin, en vous offrant une expérience pratique et une compréhension approfondie de la plateforme Générateur de chaînes.
Visitez le centre d'apprentissage Workiva
Gérer les variables de votre espace de travail
Depuis votre espace de travail, vous pouvez définir les variables utilisées par plusieurs chaînes :
- Dans Chain Builder, sélectionnez Settings en haut à gauche.
- A droite de Variables, cliquez sur Ajouter.
- Pour faciliter l'identification de la variable, saisissez son nom et, si nécessaire, sa valeur par défaut et sa description. Ces valeurs par défaut peuvent être personnalisées ultérieurement pour des chaînes individuelles.
- Pour plus de sécurité, sélectionnez Encrypt - cela dissimulera toutes les valeurs sensibles telles que les mots de passe.
- Cliquez sur Enregistrer.
Après avoir ajouté une variable à votre espace de travail, vous pouvez modifier son nom, sa valeur ou son cryptage si nécessaire. Pour supprimer une variable de l'espace de travail, cliquez sur Delete.
Gérer les variables d'une chaîne
Pour les valeurs qui apparaissent dans plusieurs commandes au sein d'une chaîne et qui changent fréquemment, ajoutez-les en tant que variables pour la chaîne. Il n'y a pas de limite stricte au nombre de variables dans une chaîne, mais une dégradation de la réactivité a été observée lorsque les chaînes approchent les 1000 variables.
- Dans la chaîne, cliquez sur Chain Settings.
- Sous Variables, cliquez sur Ajouter.
- Saisissez un nom et une description uniques pour aider à identifier la variable et son objectif.
- Saisir la valeur par défaut de la variable.
- Pour que seuls les administrateurs puissent voir la valeur de la variable, par exemple pour les mots de passe, sélectionnez Encrypt.
- Cliquez sur Enregistrer.
Pour mettre à jour une variable, cliquez sur Editer pour la chaîne, et ajustez la valeur sous Variables.
Pour supprimer une variable dont vous n'avez plus besoin, cliquez sur Delete.
Gérer les variables dynamiques d'une chaîne
Pour définir des valeurs lors de l'exécution de la chaîne, ou pour baser les valeurs sur la sortie d'une autre commande, ajoutez-les en tant que variables dynamiques pour la chaîne.
Note : Pour faciliter les exécutions consécutives, les variables dynamiques conservent les valeurs définies lors de l'exécution précédente de la chaîne.
- Dans la chaîne, cliquez sur Chain Settings.
- Sous Dynamic Variables, cliquez sur Add.
- Entrez un nom unique pour aider à identifier la variable et son intention.
Note : Le champ Valeur initiale n'est pas applicable ici et doit être laissé vide.
- Cliquez sur Enregistrer.
Remarque : Pour définir les valeurs des variables dynamiques lorsqu'une chaîne commence à s'exécuter, démarrez-la avec a Runtime Inputs trigger event. Pour interrompre une chaîne afin de définir la valeur d'une variable dynamique avant de passer à l'étape suivante, ajoutez a Set Dynamic Chain Variables event.
Pour supprimer une variable dont vous n'avez plus besoin, cliquez sur Delete.
Utiliser des variables comme entrées de commande
Pour utiliser des variables comme entrées textuelles pour une commande :
- Dans la chaîne, sélectionnez la commande qui utilisera les variables.
- Dans l'entrée textuelle pour utiliser une variable, cliquez sur Variable et sélectionnez la variable.
Note : Pour concaténer plusieurs variables dans une entrée, sélectionnez les variables à utiliser, puis entrez le texte qui doit apparaître avant ou après chacune d'elles.
- Cliquez sur Enregistrer.
Note : Pour modifier ou formater une variable afin de l'utiliser comme entrée de commande, appliquez une transformation de variable .
Variables d'exécution
Pour inclure des données relatives à l'exécution d'une chaîne, vous pouvez utiliser plusieurs variables d'exécution.
| Variable | Description |
|---|---|
| Chain.Environment | L'environnement de la chaîne en cours d'exécution |
| Date d'exécution de la chaîne | La date et l'heure du début de la chaîne |
| Chain.ExecutorId | L'identifiant numérique de la chaîne en cours d'exécution |
| Chaîne.Id | L'identifiant numérique d'une chaîne dans l'état non en cours d'exécution |
| Nom de la chaîne | Le nom de la chaîne en cours d'exécution |
| Chain.PreviousExecutionDateTime | La date et l'heure de la dernière exécution de la chaîne |
| Chain.URL | URL unique de la chaîne en cours d'exécution |
| Espace de travail de la chaîne | L'espace de travail de la chaîne en cours d'exécution |
| Command.ExecutorId | ID numérique de la commande en cours d'exécution |
| Commande.Id | ID numérique d'une commande dans l'état non exécuté |
| Nom de la commande | Le nom de la commande en cours d'exécution |
| Commande.URL | URL unique de la commande en cours d'exécution |
| Runner.InstallationDirectory | Le répertoire d'installation du GroundRunner de la chaîne ; null si un CloudRunner est utilisé |
| System.Date | La date actuelle du système |
| System.DateTime | La date et l'heure actuelles du système |
| Utilisateur.Email | L'adresse électronique du collaborateur qui a géré la chaîne |
| User.Id | L'ID du collaborateur qui a exécuté la chaîne |
| Nom de l'utilisateur | Le nom du collaborateur qui a dirigé la chaîne |