🖥️ Ficha de una variable
Objetivo Principal: Consultar y corregir en un solo sitio todo lo que la plataforma sabe de una variable —cómo se llama, dónde está, qué límites tiene, qué valor está dando ahora mismo y quién la ha tocado— sin salir del listado.
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.
Se llega desde el listado de Variables: al pulsar sobre la fila de cualquier variable se abre esta ventana sobre el listado. No tiene aspa de cierre en la esquina, así que se sale con los botones del pie, con la tecla Esc o pulsando fuera de la ventana.
🧩 Despiece de Elementos Funcionales
| Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|
| Título de la ficha | Indicador informativo | — | Encabeza la ventana con el nombre visible de la variable. Si la variable no tiene nombre visible, el título es simplemente "Variable". |
| Distintivo de estado | Indicador de estado | — | Junto al título, indica en qué punto del ciclo de vida está la variable: "Activa" (en uso, con datos en directo), "Inactiva" (registrada pero apagada) o "Descubierta" (incorporada pero todavía sin activar). |
| Indicador "Actualizado" | Indicador informativo | — | Fecha y hora del último cambio guardado en la ficha, con el mes abreviado. Muestra una raya cuando la variable no tiene esa fecha. |
| Identificadores "ID" y "Técnico" | Indicadores informativos | — | Segunda línea de la cabecera. "ID" es el identificador de la variable dentro de la plataforma y "Técnico" el nombre con el que llega desde la instalación. Al pasar el ratón por encima se muestra el valor completo, útil cuando el texto se corta. Ninguno de los dos se puede editar. |
| Pestaña "Metadatos" | Navegación por pestañas | Abrir el formulario de edición | Pestaña abierta por defecto. Reúne todo lo editable de la variable: identidad, escritura, ubicación y límites. Cada vez que se abre la ficha se vuelve a esta pestaña. |
| Pestaña "Técnico" | Navegación por pestañas | Consultar la información técnica | Solo consulta: desde aquí no se edita nada. Reúne los identificadores largos de la variable y su origen de datos. |
| Pestaña "Realtime" | Navegación por pestañas | Ver el valor en directo | Permite suscribirse a la variable y ver el valor que va llegando sin salir de la ficha. |
| Pestaña "Historial" | Navegación por pestañas | Revisar los cambios | Lista los cambios guardados en la ficha. La lista se pide al entrar en la pestaña, no antes. |
| Bloque "Valor actual" | Bloque de edición | Escribir el valor de una variable global | Solo aparece en las variables globales —las creadas dentro de la plataforma— y lleva la etiqueta "Global". Si la variable ya tiene valor, se muestra la línea "Valor almacenado" con el valor y la fecha en que se fijó. |
| Campo "Nuevo valor" | Campo adaptable al tipo de dato | Fijar el valor | Dentro del bloque anterior. El control cambia seg ún el tipo de dato de la variable: campo numérico para decimales y enteros, campo de texto para el resto, y un desplegable con "Seleccionar...", "Verdadero" y "Falso" para las booleanas. |
| Botón "Guardar valor" | Botón de acción | Guardar el valor de la variable global | Escribe el valor introducido y recarga la ficha. Permanece deshabilitado mientras el campo esté vacío y pasa a "Guardando..." durante la operación. Si el valor no encaja con el tipo de dato, la ficha avisa con "Introduce un numero valido", "El valor debe ser un numero entero" o "Selecciona un valor booleano valido" y no guarda nada. |
| Bloque "General" | Bloque de campos | Editar la identidad de la variable | Primera columna de la pestaña "Metadatos". Contiene "Nombre visible" —el nombre con el que la variable aparece en el resto de la plataforma—, "Descripción", "Tipo", "Unidad" y "Categoría". |
| Desplegable "Tipo" | Selector desplegable | — | Muestra la naturaleza de la señal con las tres opciones que ofrece la plataforma, escritas tal cual: "ANALOG", "DIGITAL" y "STATE". El botón "Guardar cambios" no envía este campo, así que lo que se elija aquí se pierde al cerrar y volver a abrir la ficha. |
| Desplegable "Categoría" | Selector desplegable | Clasificar la variable | Empieza por "Seleccionar categoría..." y ofrece las categorías funcionales de la plataforma: "Ambiental", "Ocupación", "Climatización", "Eléctrico", "Exterior", "Entradas Digitales", "Condición Máquina", "Contexto", "Calidad Dato", "Energía", "Temperatura", "Presión", "Producción", "Alarma", "Estado", "Proceso", "Equipo", "Mantenimiento" y "Otro". Es la categoría por la que filtra el listado. |
| Bloque "Escritura (Actuador)" | Bloque de campos | Declarar la variable como escribible | Contiene la casilla "Variable de escritura (actuador/setpoint)". Marcarla es lo que convierte la variable en escribible desde consignas, SCADA y automatizaciones, y despliega dos campos más. |
| Campos "Topic de comando (cmd)" y "Topic de ACK" | Campos de texto | Indicar los canales de escritura | Solo visibles con la casilla anterior marcada. Señalan por dónde sale la orden hacia el equipo y por dónde vuelve su confirmación. Son datos de la instalación: cambiarlos a mano hace que la orden acabe en otro sitio. |
| Bloque "Ubicación (Tags)" | Bloque de campos | Situar la variable en la planta | Segunda columna de la pestaña "Metadatos", con los campos "Fábrica", "Zona", "Máquina" y "Área de proceso". Es lo que alimenta los filtros de ubicación del listado y su agrupación por equipo. Cuando la variable no los tiene sueltos, la ficha los rellena con los datos que trae la señal de la instalación. |
| Bloque "Límites operativos" | Bloque de campos | Acotar el rango esperado | Campos "Mínimo" y "Máximo". Definen el rango de trabajo de la variable, que aprovechan después los widgets con escala y las reglas de alarma. |
| Bloque "Metadata técnica" | Bloque informativo | Consultar y copiar los identificadores | Contenido de la pestaña "Técnico", desplegado de entrada y plegable desde su cabecera. Agrupa los identificadores largos de la variable —cada uno con un botón "Copiar" que pasa a "Copiado" durante unos segundos—, el bloque "Path en cascada", el bloque "Comunicación" con los canales de datos, comando y confirmación, el bloque "InfluxDB" con el origen del histórico y la fecha del "Último dato", y el bloque "Características" con "Tipo dato", "Sensor", "Actuador" y "Rango". En las variables antiguas, que no tienen nada de esto, la pestaña muestra "Sin metadata técnica disponible (variable legacy)". |
| Indicador "Adapter" | Indicador de estado | — | Primera línea de la pestaña "Realtime". Marca "Adapter: Conectado" cuando el flujo de datos de la instalación está llegando y "Adapter: Desconectado" cuando no. Con la conexión caída, el botón de suscripción queda deshabilitado. |
| Botón "Suscribir" / "Desuscribir" | Botón de acción | Seguir el valor en directo | Bloque "Suscripción" de la pestaña "Realtime", con la leyenda "Suscrito" o "No suscrito" al lado. Las variables activas se suscriben solas al entrar en la pestaña; las inactivas y las descubiertas hay que suscribirlas a mano. |
| Bloque "Valor Actual (VTQ)" | Bloque informativo | — | Aparece una vez suscrita la variable. Muestra "Valor:" con la lectura redondeada a dos decimales y su unidad, "Timestamp" con la hora del dato y "Quality" con el distintivo "GOOD" si el valor está al día o "STALE" si viene marcado como caducado. Mientras no llega ninguna lectura se lee "Esperando datos...". Sin suscripción, el mensaje es "Suscríbete para ver valores en tiempo real". |
| Lista del historial | Lista de registros | — | Contenido de la pestaña "Historial". Cada entrada indica la fecha y hora del cambio, "Por:" con el usuario que lo hizo y, debajo, campo a campo, el valor anterior y el nuevo separados por una flecha. Si una entrada no detalla nada, se lee "Sin cambios registrados". Mientras carga se muestra "Cargando historial..." y, si no hay nada, "Sin historial de cambios" con la aclaración "Los cambios realizados a esta variable aparecerán aquí." |
| Botón "Eliminar" | Botón de acción destructiva | Borrar la variable | Pie de la ventana, a la izquierda. Pide confirmación con el aviso "Esta accion eliminara la variable y su historial. ¿Deseas continuar?" antes de borrar nada. Mientras borra pasa a "Eliminando...". Si el borrado falla, la ficha muestra el motivo sobre el formulario. |
| Botón "Cancelar" | Botón secundario | Cerrar sin guardar | Cierra la ficha y descarta lo escrito. Los cambios sin guardar no se avisan: se pierden sin más. |
| Botón "Guardar cambios" | CTA Principal | Guardar la ficha | Guarda el nombre visible, la descripción, la unidad, la categoría, la configuración de escritura, los tags de ubicación y los límites; después cierra la ficha y refresca el listado. Si el guardado falla, aparece un aviso con el motivo y la ficha se queda abierta. |
| Botón "Cerrar" | Botón secundario | Cerrar la ficha | Sustituye a los tres botones anteriores cuando la sesión no tiene permiso de edición. En ese modo todos los campos aparecen bloqueados y la ficha solo sirve para consultar. |
💡 Guía de Uso
La ficha es la vista de detalle de una variable y se abre pulsando su fila en el listado de Variables. Está organizada en cuatro pestañas que responden a cuatro preguntas distintas: "Metadatos" es lo que se edita, "Técnico" es de dónde sale el dato, "Realtime" es cuánto está valiendo ahora y "Historial" es quién lo ha cambiado y cuándo.
Quién puede hacer qué. El listado, y por tanto la ficha, solo lo abren los perfiles Administrador, Admin Global y Mantenimiento; el perfil Usuario no ve la sección. Ahora bien, guardar, eliminar y escribir el valor de una variable global son operaciones reservadas a los perfiles Administrador y Admin Global: con el perfil Mantenimiento la ficha se abre igualmente con los campos editables y con los tres botones del pie, pero al pulsar "Guardar cambios" o "Eliminar" la plataforma rechaza la operación y muestra un aviso de error sin cambiar nada. La variante de la ficha con un único botón "Cerrar" y los campos bloqueados corresponde a las sesiones sin ningún permiso de edición.
Editar los metadatos. Lo habitual es corregir el nombre visible para que la variable se entienda en dashboards e informes, asignarle una categoría —que es por lo que filtra el listado— y completar la unidad y los límites, porque de ellos dependen las escalas de los widgets y las reglas de alarma. Los campos de "Ubicación (Tags)" son los que agrupan el listado por equipo y alimentan sus filtros de fábrica y zona. Ten en cuenta que el desplegable "Tipo" es el único control del bloque que no llega a guardarse: si lo cambias, al reabrir la ficha volverá a mostrar el valor de partida.
Variables globales. En las variables creadas dentro de la plataforma —las que no proceden de una señal de planta, descritas en Crear variable global— aparece arriba el bloque "Valor actual", con la etiqueta "Global". Ahí se fija el valor a mano: escribe el nuevo valor y pulsa "Guardar valor". La plataforma comprueba que encaje con el tipo de dato antes de aceptarlo y, tras guardar, informa de si el valor ha salido además hacia la instalación o si esa propagación está desactivada en tu entorno. Este bloque no existe en las variables físicas: su valor lo pone la planta, no el usuario.
Declarar una variable de escritura. La casilla "Variable de escritura (actuador/setpoint)" del bloque "Escritura (Actuador)" es la que permite que una variable reciba órdenes desde consignas, SCADA y automatizaciones. Al marcarla hay que indicar los dos canales, el de comando y el de confirmación, que son datos de la instalación: consúltalos antes de escribirlos, porque un canal equivocado envía la orden a otro punto de la planta. El resultado se comprueba después en la pestaña "Comandos" de Variables en tiempo real.
Comprobar el dato y el rastro. La pestaña "Realtime" sirve para confirmar sobre el terreno que una variable está dando valor: si el indicador marca "Adapter: Conectado" y aun así el valor no llega o aparece como "STALE", el problema está en la señal, no en la ficha. La pestaña "Historial" deja ver, cambio a cambio, qué se modificó y quién lo hizo, lo que resulta útil antes de deshacer algo que configuró otra persona.
Eliminar. "Eliminar" borra la variable y todo su historial de cambios, y pide confirmación antes de hacerlo. Es una acción sin vuelta atrás: si lo que quieres es solo sacarla de circulación, desactívala desde la barra de acciones en bloque del listado.