Les variables d'automatisation permettent aux actions de se transmettre des données les unes aux autres dans le même pipeline. Une action écrit une valeur dans une variable - le code de sortie d'un script, une valeur de champ personnalisé, un résultat de patch - et une action ou une condition ultérieure le lit.

Les variables sont limitées à l'automatisation dans laquelle elles sont définies. Elles ne se transfèrent pas entre automatisations.

Création de Variables d'Automatisation

Il existe deux façons de créer une variable d'automatisation.

À partir de l'Onglet Variables

Ouvrez une automatisation et cliquez sur Variables dans la barre latérale gauche.
Cliquez sur + Ajouter une variable.
Entrez un nom (sans espaces) et une valeur par défaut optionnelle.
Cliquez sur Enregistrer.

Les variables créées ici sont immédiatement disponibles dans toutes les actions et conditions de l'automatisation.

À partir de la Sortie d'une Action

N'importe quelle action peut écrire sa sortie dans une variable au moment de l'exécution.

Ouvrez une action en mode édition et faites défiler jusqu'à Options supplémentaires.
Dans le champ Assigner la sortie de l'action à une variable, entrez un nom de variable ou sélectionnez-en un.
Enregistrez l'action.

ℹ️ REMARQUE : C'est le même mécanisme indiqué par le badge orange (x) sur les cartes de pipeline. Si vous voyez un badge (x) sur une action, cette action lit ou écrit dans une variable.

Utilisation des Variables

Dans les Actions et Scripts

Partout où le rendu de variables est pris en charge, cliquez sur l'icône de variable pour insérer une variable par nom. Vous pouvez également saisir la référence directement en utilisant la syntaxe des doubles accolades :

##{{MyVariable}}

Dans les Conditions d'Action

Les variables peuvent être lues dans les conditions d'action pour contrôler si une étape s'exécute. Par exemple : ne déclenchez une action Créer une alerte que si une variable nommée PatchingStatus est égale à failed.

Consultez Conditions d'Action pour la référence complète sur les types de conditions et les opérateurs.

Mappage aux Variables de Script

Les variables de script sont des emplacements de sortie nommés définis dans l'onglet Variables d'un script. Le script écrit une valeur dans une variable de script lors de l'exécution, et le mappage dans le panneau d'action Exécuter un script détermine quelle variable d'automatisation stocke cette valeur - la rendant disponible pour les actions et conditions suivantes du pipeline.

Les variables de script sont destinées à la capture de sortie, pas à l'approvisionnement en entrée. Pour transmettre des données dans un script (contexte d'appareil, valeurs de champs personnalisés, informations système), utilisez des variables système ou des champs personnalisés via le sélecteur {x} dans l'éditeur de script.

Pour mapper une variable de script à une variable d'automatisation :

Ouvrez l'action Exécuter un script en mode édition.
Dans la section Variables de script, trouvez la variable de script que vous souhaitez capturer.
Ouvrez la liste déroulante Variables d'automatisation sur cette ligne.
Sélectionnez une variable d'automatisation existante ou cliquez sur Créer une nouvelle variable.

Lorsque le script s'exécute, la valeur qu'il écrit dans cette variable de script est stockée dans la variable d'automatisation mappée et transmise dans le pipeline.

ℹ️ REMARQUE : La section Variables de script n'apparaît que lorsque le script sélectionné a au moins une variable définie dans son onglet Variables.

Vous pouvez également définir une variable d'automatisation en ligne à partir d'un script. Utilisez la syntaxe en ligne ##{{variable=value}} lorsque votre script produit d'autres résultats que vous ne voulez pas polluer la variable (journaux, messages de statut, etc.). Utilisez Assigner la sortie de l'action à une variable lorsque la seule sortie du script est la valeur que vous souhaitez capturer.

Incorporez ceci n'importe où dans la sortie de votre script :

##{{variable_name=value}}

L'agent de Level analyse la sortie du script pour ce modèle au fur et à mesure de l'exécution du script. Tous les autres résultats passent sans modification. La variable doit d'abord être créée dans l'onglet Variables du script.

💡 CONSEIL : Ce modèle - capturer la sortie → la vérifier dans une condition - est le moyen standard de construire la gestion des échecs conditionnels dans Level. Consultez Création d'Automatisations pour une procédure complète utilisant ce modèle.

FAQ

Où puis-je voir toutes les variables disponibles dans une automatisation ? Ouvrez l'automatisation et cliquez sur Variables dans la barre latérale gauche. Cela liste toutes les variables d'automatisation définies pour cette automatisation. Les variables système sont toujours disponibles aussi mais n'apparaissent pas ici - consultez Variables Système pour la liste complète.
Puis-je utiliser le même nom de variable dans plusieurs automatisations ? Oui. Les noms de variables sont limités à l'automatisation - PatchingStatus dans une automatisation n'a rien à voir avec PatchingStatus dans une autre.
Quelle valeur a une variable avant qu'une action n'écrive dedans ? Elle utilise la valeur par défaut définie lors de la création de la variable. Si aucune valeur par défaut n'a été définie, elle est vide.
Puis-je lire une variable à partir d'une exécution d'automatisation précédente ? Non. Les variables se réinitialisent au début de chaque exécution. Elles ne persistent pas entre les exécutions.