Introducción
Las variables de automatización permiten que las acciones se pasen datos entre sí dentro de la misma canalización. Una acción escribe un valor en una variable — el código de salida de un script, el valor de un campo personalizado, un resultado de parches — y una acción o condición posterior lo lee.
Las variables tienen un alcance limitado a la automatización en la que se definen. 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 de Variables
Abre una automatización y haz clic en Variables en la barra lateral izquierda.
Haz clic en + Add variable.
Introduce un nombre (sin espacios) y un valor predeterminado opcional.
Haz clic en Save.
Las variables creadas aquí están disponibles de inmediato 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.
Abre una acción en modo de edición y desplázate hasta Additional options.
En el Assign action output to variable campo, introduce un nombre de variable o selecciona uno existente.
Guarda la acción.
ℹ️ NOTA: Este es el mismo mecanismo que muestra el indicador naranja (x) en las tarjetas de canalización. Si ves un (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, haz clic en el icono de variable para insertar una variable por nombre. También puedes escribir la referencia directamente usando la sintaxis de dobles llaves:
{{MyVariable}}En Condiciones de Acción
Las variables se pueden leer en las condiciones de acción para controlar si un paso se ejecuta. Por ejemplo: activar una acción Crear alerta solo si una variable llamada PatchingStatus igual a failed.
Consulta Action Conditions para la referencia completa sobre tipos de condiciones y operadores.
Asignación a Variables de Script
Las variables de script son ranuras de salida con nombre definidas en la pestaña Variables pestaña. El script escribe un valor en una variable de script durante la ejecución, y la asignación en el Run Script panel de acciones determina qué variable de automatización almacena ese valor — poniéndolo a disposición de las acciones y condiciones posteriores en la canalización.
Las variables de script son para capturar salidas, no para suministrar entradas. Para pasar datos hacia un script (contexto del dispositivo, valores de campos personalizados, información del sistema), usa variables del sistema o campos personalizados a través del {x} selector en el editor de scripts.
Para asignar una variable de script a una variable de automatización:
Abre la Run Script acción en modo de edición.
En la Script variables sección, encuentra la variable de script que deseas capturar.
Abre la Automation variables lista desplegable en esa fila.
Selecciona una variable de automatización existente o haz clic en Create new variable.
Cuando el script se ejecuta, el valor que escribe en esa variable de script se almacena en la variable de automatización asignada y se lleva a través de la canalización.
ℹ️ NOTA: La sección de variables de script solo aparece cuando el script seleccionado tiene al menos una variable definida en su pestaña de Variables.
También puedes establecer una variable de automatización de forma directa desde dentro de un script. Usa la sintaxis {{variable=value}} sintaxis cuando tu script produce otra salida que no deseas que contamine la variable (registros, mensajes de estado, etc.). Usa Assign action output to variable cuando la única salida del script es el valor que deseas capturar.
Inserta esto en cualquier parte de la salida de tu script:
{{variable_name=value}}El agente de Level analiza la salida del script en busca de este patrón mientras el script se ejecuta. El resto de la salida pasa sin modificaciones. La variable debe haberse creado previamente en la pestaña de Variables del script.
💡 CONSEJO: Este patrón — capturar salida → verificarla en una condición — es la forma estándar de crear manejo condicional de fallos en Level. Consulta Building Automations para un tutorial completo usando este patrón.
Preguntas Frecuentes
¿Dónde puedo ver todas las variables disponibles en una automatización? Abre la automatización y haz clic en Variables en la barra lateral izquierda. Esto muestra todas las variables de automatización definidas para esa automatización. Las variables del sistema también están siempre disponibles pero no aparecen aquí — consulta System Variables para la lista completa.
¿Puedo usar el mismo nombre de variable en múltiples automatizaciones? Sí. Los nombres de las variables tienen un alcance limitado a la automatización —
PatchingStatusen una automatización no tiene nada que ver conPatchingStatusen otra.¿Qué valor tiene una variable antes de que alguna acción escriba en ella? Usa el valor predeterminado establecido al crear la variable. Si no se estableció ningún valor predeterminado, está vacía.
¿Puedo leer una variable de una ejecución de automatización anterior? No. Las variables se reinician al inicio de cada ejecución. No persisten entre ejecuciones.