🖥️ Globals: Leer Variable — Configuración
Objetivo Principal: Permite al usuario leer el último valor registrado de una variable del catálogo y dejarlo disponible, bajo la clave que elija, para el resto de los nodos del workflow.
Esta página describe una pantalla que aún no está fotografiada en el manual, así que el despiece no numera los elementos sobre una imagen. Lo que se cuenta aquí está contrastado con la versión 0.4.46 de la aplicación.
El nodo se añade desde la biblioteca de nodos del editor de workflows, en el grupo Globals, con el nombre Leer variable. Ese grupo solo está disponible en los workflows de tipo orquestador: en los de tipo bloque de función o función no aparece. Una vez colocado en el lienzo, su ventana de configuración se abre con doble clic sobre el nodo, o con el botón derecho y la opción Configurar.
🧩 Despiece de Elementos Funcionales
| Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|
| Campo "Nombre del nodo" | Campo de texto | Cambia el nombre del nodo dentro del workflow | Nombre identificativo del nodo: es lo que titula esta ventana y lo que usan los paneles del editor para referirse a él. Al añadirlo llega con el valor «Leer variable». |
| Campo "Descripción (opcional)" | Área de texto | Almacena una descripción libre del nodo | Campo opcional de dos líneas para documentar el propósito del nodo. Llega relleno con el texto que la biblioteca de nodos muestra bajo «Leer variable», y se puede sustituir por completo. |
| Selector "Variable a leer" | Desplegable con buscador | Elige del catálogo la variable cuyo valor se leerá | Mientras no hay selección muestra «Selecciona una variable...». Al abrirlo aparece el campo «Buscar variable...» y la lista de variables activas; cuando los resultados abarcan más de un activo, se agrupan por activo con una cabecera y el número de variables de cada grupo. De cada variable muestra el nombre visible, la clave técnica y la unidad. Estados posibles: «Cargando...» mientras se recuperan y «No se encontraron variables» cuando la búsqueda no da resultados; si quedan más por cargar, ofrece el botón «Cargar más» con el recuento de las ya cargadas sobre el total. Es obligatorio: si se guarda sin elegir ninguna, el campo se marca en rojo con el mensaje «Selecciona una variable». |
| Campo "Guardar valor en contexto como" | Campo de texto | Nombra la clave con la que el valor queda disponible para los nodos siguientes | Por defecto vale value. Debajo, la aplicación recuerda que «El valor quedará disponible como esta clave para condiciones y formulas posteriores.». Conviene darle un nombre propio cuando el workflow tiene varias lecturas, para distinguirlas al construir una condición o una fórmula. |
| Campo "Frescura maxima del dato (minutos)" | Campo numérico | Descarta una lectura demasiado antigua | Número entero de minutos, a partir de 1. Si se deja vacío —muestra «Sin limite»— se acepta el último dato registrado sea cual sea su antigüedad. Debajo, la aplicación explica que «Si el ultimo dato es mas antiguo que este valor, se considera no disponible. Recomendado: 5 para sensores que reportan cada 60 s.». |
| Botón "Cancelar" | Botón secundario | Cierra el panel sin guardar cambios | Descarta cualquier modificación realizada y devuelve al estado anterior. |
| Botón "Guardar cambios" | CTA Principal | Persiste la configuración del nodo | Guarda la variable elegida, la clave de salida y la frescura máxima, y cierra el panel. Editar y guardar automatizaciones exige rol de administrador de empresa. Con el perfil Mantenimiento el editor se abre en modo solo lectura —lo advierte la franja «Modo solo lectura — los cambios requieren rol de administrador de empresa»—, así que este panel no llega a poder modificarse; el perfil Usuario no accede al módulo. El servidor repite la comprobación y rechaza con «Acceso denegado» cualquier guardado que llegue por otra vía. |
| Aviso de campos incorrectos | Mensaje de error | Señala que la ventana tiene campos sin completar | Cuando algún campo obligatorio falla, aparece al pie el mensaje «Revisa los campos marcados en rojo». |
💡 Guía de Uso
- Abre el grupo Globals en la biblioteca de nodos y haz clic sobre Leer variable, o arrástrala hasta el lienzo.
- Haz doble clic sobre el nodo para abrir su configuración.
- Despliega Variable a leer y localiza la variable por su nombre visible o por su clave técnica.
- Cambia la clave de Guardar valor en contexto como si el workflow va a hacer más de una lectura, para poder distinguirlas después.
- Rellena la frescura máxima si la decisión que vas a tomar no debe apoyarse en un dato viejo; déjala vacía si te vale el último registrado.
- Pulsa Guardar cambios para confirmar, o Cancelar para descartar.
- De vuelta en el lienzo, conecta la salida del lado derecho del nodo con el nodo que vaya a usar el valor: una Condición, una Fórmula, un Visualizador o un nodo de escritura.
En el lienzo, el nodo se dibuja como una etiqueta compacta marcada READ con la variable elegida, y una única salida de datos a la derecha. No tiene patillas de habilitación: no se encadena con el resto por orden, sino que lee justo antes de que el nodo que consume su valor lo necesite. Puede quedarse sin conectar sin invalidar el diseño ni impedir que el workflow se active.
La lectura se queda sin valor —y quien la consuma lo verá vacío— cuando la variable ya no existe en el catálogo, cuando el último dato supera la frescura máxima configurada o cuando el valor registrado no encaja con el tipo de dato declarado para esa variable. Además, si la variable recoge la telemetría de un equipo, se busca su último dato dentro de los treinta días anteriores: un sensor que lleve más tiempo callado se lee como si no tuviera dato. Si es una variable global interna, basta con que nunca se le haya asignado un valor.