Las variables de automatización permiten que las acciones se transmitan datos entre sí dentro del mismo pipeline. Una acción escribe un valor en una variable - el código de salida de un script, un valor de campo personalizado, un resultado de parche - y una acción o condición posterior lo lee.
Las variables se limitan a la automatización en la que están definidas. No se transfieren entre automatizaciones.
Creación de Variables de Automatización
Hay dos formas de crear una variable de automatización.
Desde la Pestaña Variables
Abra una automatización y haga clic en Variables en la barra lateral izquierda.
Haga clic en + Añadir variable.
Ingrese un nombre (sin espacios) y un valor predeterminado opcional.
Haga clic en Guardar.
Las variables creadas aquí están disponibles inmediatamente en todas las acciones y condiciones de la automatización.
Desde la Salida de una Acción
Cualquier acción puede escribir su salida en una variable en tiempo de ejecución.
Abra una acción en modo de edición y desplácese hacia Opciones adicionales.
En el campo Asignar salida de acción a variable, ingrese un nombre de variable o seleccione uno existente.
Guarde la acción.
ℹ️ NOTA: Este es el mismo mecanismo indicado por el distintivo naranja (x) en las tarjetas de pipeline. Si ve un distintivo (x) en una acción, esa acción está leyendo o escribiendo en una variable.
Uso de Variables
En Acciones y Scripts
En cualquier lugar donde se admita la representación de variables, haga clic en el icono de variable para insertar una variable por nombre. También puede escribir la referencia directamente utilizando la sintaxis de dobles llaves:
##{{MyVariable}}En Condiciones de Acción
Las variables pueden leerse en condiciones de acción para controlar si un paso se ejecuta. Por ejemplo: desencadene una acción Crear alerta solo si una variable llamada PatchingStatus es igual a failed.
Consulte Condiciones de Acción para la referencia completa sobre tipos de condiciones y operadores.
Mapeo a Variables de Script
Las variables de script son espacios de salida nombrados definidos en la pestaña Variables de un script. El script escribe un valor en una variable de script durante la ejecución, y la asignación en el panel de acción Ejecutar script determina qué variable de automatización almacena ese valor - haciéndola disponible para acciones y condiciones posteriores en el pipeline.
Las variables de script se utilizan para capturar salida, no para proporcionar entrada. Para pasar datos en un script (contexto de dispositivo, valores de campos personalizados, información del sistema), utilice variables del sistema o campos personalizados mediante el selector {x} en el editor de scripts.
Para mapear una variable de script a una variable de automatización:
Abra la acción Ejecutar script en modo de edición.
En la sección Variables de script, encuentre la variable de script que desea capturar.
Abra la lista desplegable Variables de automatización en esa fila.
Seleccione una variable de automatización existente o haga clic en Crear nueva variable.
Cuando se ejecuta el script, el valor que escribe en esa variable de script se almacena en la variable de automatización asignada y se transmite a través del pipeline.
ℹ️ NOTA: La sección Variables de script solo aparece cuando el script seleccionado tiene al menos una variable definida en su pestaña Variables.
También puede establecer una variable de automatización en línea desde dentro de un script. Utilice la sintaxis en línea ##{{variable=value}} cuando su script produzca otra salida que no desea que contaminen la variable (registros, mensajes de estado, etc.). Utilice Asignar salida de acción a variable cuando la única salida del script es el valor que desea capturar.
Incruste esto en cualquier lugar de la salida de su script:
##{{variable_name=value}}El agente de Level analiza la salida del script en busca de este patrón mientras se ejecuta el script. Todos los demás resultados se transmiten sin cambios. La variable aún debe crearse primero en la pestaña Variables del script.
💡 CONSEJO: Este patrón - capturar salida → verificarla en una condición - es la forma estándar de construir el manejo de fallas condicionales en Level. Consulte Creación de Automatizaciones para un tutorial completo utilizando este patrón.
FAQ
¿Dónde puedo ver todas las variables disponibles en una automatización? Abra la automatización y haga clic en Variables en la barra lateral izquierda. Esto enumera todas las variables de automatización definidas para esa automatización. Las variables del sistema siempre están disponibles también pero no aparecen aquí - consulte Variables del Sistema para la lista completa.
¿Puedo usar el mismo nombre de variable en múltiples automatizaciones? Sí. Los nombres de variables se limitan a la automatización -
PatchingStatusen una automatización no tiene nada que ver conPatchingStatusen otra.¿Qué valor tiene una variable antes de que una acción escriba en ella? Utiliza el valor predeterminado establecido cuando se creó la variable. Si no se estableció ningún valor predeterminado, está vacío.
¿Puedo leer una variable de una ejecución de automatización anterior? No. Las variables se reinician al comienzo de cada ejecución. No persisten entre ejecuciones.