Introduction
Les variables d'automatisation permettent aux actions de se transmettre des données au sein d'un même pipeline. Une action écrit une valeur dans une variable — le code de sortie d'un script, la valeur d'un champ personnalisé, un résultat de mise à jour — et une action ou condition ultérieure la lit.
Les variables ont une portée limitée à l'automatisation dans laquelle elles sont définies. Elles ne se transmettent pas d'une automatisation à l'autre.
Créer des variables d'automatisation
Il existe deux façons de créer une variable d'automatisation.
Depuis l'onglet Variables
Ouvrez une automatisation et cliquez sur Variables dans la barre latérale gauche.
Cliquez sur + Ajouter une variable.
Saisissez 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.
Depuis 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 saisissez un nom de variable ou sélectionnez-en une existante.
Enregistrez l'action.
ℹ️ REMARQUE : C'est le même mécanisme indiqué par le badge orange (x) sur les cartes du pipeline. Si vous voyez un badge (x) sur une action, cette action lit ou écrit dans une variable.
Utiliser les variables
Dans les actions et les scripts
Partout où le rendu de variables est pris en charge, cliquez sur l'icône de variable pour insérer une variable par son nom. Vous pouvez également saisir la référence directement en utilisant la syntaxe à 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éclencher une action Créer une alerte que si une variable nommée PatchingStatus est égal à failed.
Consultez Conditions d'action pour la référence complète sur les types de conditions et les opérateurs.
Correspondance avec les variables de script
Les variables de script sont des emplacements de sortie nommés définis dans l'onglet Variables Le script écrit une valeur dans une variable de script lors de l'exécution, et la correspondance dans le panneau d'action Exécuter le script détermine quelle variable d'automatisation stocke cette valeur — la rendant disponible pour les actions et conditions suivantes dans le pipeline.
Les variables de script servent à capturer des sorties, pas à fournir des entrées. Pour transmettre des données vers un script (contexte de l'appareil, valeurs de champs personnalisés, informations système), utilisez les variables système ou les champs personnalisés via le sélecteur {x} dans l'éditeur de script.
Pour associer une variable de script à une variable d'automatisation :
Ouvrez l'action Exécuter le script en mode édition.
Dans la section Variables de script , trouvez la variable de script que vous souhaitez capturer.
Ouvrez le menu déroulant 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 associée et propagée dans le pipeline.
ℹ️ REMARQUE : La section Variables de script n'apparaît que lorsque le script sélectionné possède au moins une variable définie dans son onglet Variables.
Vous pouvez également définir une variable d'automatisation en ligne depuis un script. Utilisez la syntaxe {{variable=value}} lorsque votre script produit d'autres sorties que vous ne souhaitez pas polluer la variable (journaux, messages d'état, etc.). Utilisez la syntaxe Assigner la sortie de l'action à une variable lorsque la seule sortie du script est la valeur que vous souhaitez capturer.
Intégrez ceci n'importe où dans la sortie de votre script :
{{variable_name=value}}L'agent de Level analyse la sortie du script à la recherche de ce motif au fur et à mesure de l'exécution du script. Toutes les autres sorties passent sans modification. La variable doit toujours être créée au préalable dans l'onglet Variables du script.
💡 CONSEIL : Ce motif — capturer la sortie → la vérifier dans une condition — est la méthode standard pour mettre en place une gestion conditionnelle des échecs dans Level. Consultez Créer des automatisations pour une présentation complète utilisant ce motif.
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. Cette liste répertorie toutes les variables d'automatisation définies pour cette automatisation. Les variables système sont toujours disponibles 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 —
PatchingStatusdans une automatisation n'a rien à voir avecPatchingStatusdans une autre.Quelle valeur a une variable avant qu'une action y écrive ? La valeur par défaut définie lors de la création de la variable est utilisée. Si aucune valeur par défaut n'a été définie, elle est vide.
Puis-je lire une variable d'une exécution d'automatisation précédente ? Non. Les variables sont réinitialisées au début de chaque exécution. Elles ne persistent pas entre les exécutions.