🖥️ Global: Leer Variable Global Interna — Configuración
Objetivo Principal: Permite al usuario buscar y seleccionar una variable global interna del proceso para leer su valor dentro del workflow.
El nodo se añade desde la biblioteca de nodos, en el grupo Globals, con el nombre Leer global. 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 en el lienzo, la ventana de configuración se titula «Leer variable global interna». En ese mismo grupo hay otro nodo de nombre parecido que no hace lo mismo: Leer variable recorre todas las variables activas del catálogo —incluida la telemetría de los equipos—, guarda el valor bajo la clave que se le indique y puede descartarlo si es demasiado antiguo, mientras que este solo ofrece las variables globales internas y entrega su valor tal cual por la salida de datos.
📸 Mapeo de Interfaz
🧩 Despiece de Elementos Funcionales
| # | Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|---|
| 1 | Campo "Buscar por nombre o clave tecnica..." | Campo de búsqueda | Filtra la lista de variables globales disponibles | Localiza una variable escribiendo su nombre visible o su clave técnica; también encuentra por activo, emplazamiento, máquina, zona o planta. Debajo muestra el contador de resultados (por ejemplo «0 variables disponibles»). |
| 2 | Área de resultados | Lista agrupada | Muestra las variables que coinciden con la búsqueda | Presenta las variables agrupadas por el activo al que pertenecen, con una cabecera plegable y el número de variables de cada grupo. De cada variable muestra el nombre visible, la clave técnica, la unidad y el tipo de dato. Mientras se recuperan muestra «Cargando variables...»; si el filtro no encuentra nada, «No se encontraron variables globales». |
| 3 | Bloque de selección activa | Bloque informativo + selector | Refleja la variable elegida y fija su tipo de dato | Mientras no hay selección muestra el texto «Selecciona una variable de la lista». Al elegir una variable muestra su nombre, su clave técnica y su unidad, y añade a la derecha un desplegable con el tipo de dato con el que se leerá: number, boolean o string. La aplicación lo preselecciona según el tipo de la variable, pero puede cambiarse. |
| 4 | Botón "Cancelar" | Botón secundario | Cierra el panel sin guardar cambios | Descarta cualquier modificación realizada y devuelve al estado anterior. |
| 5 | Botón "Guardar" | CTA Principal | Persiste la variable seleccionada en el nodo | Guarda la variable global elegida y cierra el panel. Deshabilitado hasta que se selecciona una variable. 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. |
💡 Guía de Uso
- Abre la configuración del nodo haciendo doble clic sobre él en el lienzo del workflow, o pulsando el botón derecho y eligiendo Configurar.
- Usa el campo de búsqueda para localizar la variable por su nombre o clave técnica.
- Selecciona la variable deseada de la lista de resultados — aparecerá confirmada en el campo de selección activa.
- Pulsa Guardar para confirmar, o Cancelar para descartar.
- Conecta la salida de datos del lado derecho del nodo al nodo que vaya a usar el valor leído (una condición, una fórmula, un Visualizador, etc.).