🖥️ Señales
Objetivo Principal: Reunir en un único registro todas las señales de la instalación —las que se guardan como histórico y las que llegan en tiempo real— para consultar su estado y ajustar cómo se leen y se muestran en el resto de la plataforma.
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 la pestaña "Señales" de la barra de pestañas de Cuenta. Es una pantalla de configuración con acceso restringido: la pestaña solo aparece —y la pantalla solo se abre— para los perfiles Mantenimiento, Administrador y Admin Global. El perfil Usuario no la ve en ningún momento. Dentro de la ficha de una señal hay un segundo escalón: la pestaña “Configuración” solo permite guardar cambios a los perfiles Administrador y Admin Global; al perfil Mantenimiento se le muestra en modo de solo lectura.
Cada fila del registro es una señal, y cada señal puede venir del almacén de histórico (Influx), del canal en tiempo real (MQTT) o de ambos a la vez, cuando las dos caras corresponden a la misma medida y están vinculadas entre sí. Es la misma materia prima que se consulta desde Variables, vista aquí desde su lado técnico: una señal de este registro pasa a ser una variable de la plataforma cuando se da de alta desde Sincronizar variables.
🧩 Despiece de Elementos Funcionales
Registro de señales
| Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|
| Pestaña "Señales" | Navegación por pestañas | Abrir el registro | Punto de entrada a la pantalla desde la barra de pestañas de Cuenta, que se mantiene visible en la parte superior para volver a cualquier otra sección de la cuenta. Solo se muestra a los perfiles Mantenimiento, Administrador y Admin Global. |
| Cabecera con contadores | Encabezado informativo | — | Recuerda el propósito de la pantalla —“Registro unificado de señales Influx y MQTT. Configura, vincula y monitoriza datos de proceso en tiempo real.”— y muestra cuatro cifras: señales “encontradas”, cuántas hay en “Influx”, cuántas en “MQTT” y cuántas “vinculadas”. Una señal vinculada está presente en las dos fuentes, así que cuenta a la vez en “Influx”, en “MQTT” y en “vinculadas”. |
| Campo "Nombre o ID de señal..." | Campo de búsqueda | Filtrar el listado | Busca sobre el listado ya cargado y deja solo las señales cuyo nombre, identificador técnico, descripción o categoría contengan lo escrito. Funciona a medida que se teclea. |
| Desplegable "Fuente" | Filtro | Acotar por procedencia | Opciones: “Todas”, “Influx”, “MQTT”, “Ambas”, “Vinculadas” y “Sin vincular”. “Ambas” deja únicamente las señales que existen en las dos fuentes. |
| Desplegable "Tipo" | Filtro | Acotar por naturaleza del dato | Opciones: “Todos”, “Analógica”, “Booleana” y “Evento”. |
| Desplegable "Modo" | Filtro | Acotar por forma de uso | Opciones: “Todos”, “Solo lectura”, “Lectura/escritura”, “Alarma” y “Evento”. |
| Pie de la tarjeta de filtros | Indicador con acción | Deshacer el filtrado | Indica cuántas señales coinciden con los filtros y, cuando hay alguno activo, muestra el botón “Limpiar filtros”, que devuelve el registro completo. |
| Tarjeta "Listado de señales" | Tabla | Consultar el registro | Encabezada por el rótulo “Listado de señales” y el recuento “N visibles”. Sus columnas son “Nombre”, “ID Técnico”, “Fuente”, “Unidad”, “Categoría”, “Modo”, “Valor” y “Estado”. |
| Columna "Fuente" | Indicador | — | Muestra una letra por cada procedencia de la señal: “I” para el histórico (Influx) y “M” para el tiempo real (MQTT). Una señal vinculada muestra las dos. |
| Columna "Modo" | Indicador | — | Resume cómo puede usarse la señal: “RO” en las de solo lectura, “RW” en las de lectura y escritura, y el modo en mayúsculas en las de alarma, evento o solo escritura. |
| Columna "Valor" | Indicador | — | Último valor recibido, con sus decimales y su unidad. Las señales booleanas se muestran como “ON” u “OFF”. Las señales que solo tienen histórico, sin canal en tiempo real, muestran un guion. |
| Columna "Estado" | Indicador | — | Salud de la señal: “OK” cuando el último dato es reciente y de calidad buena, “Stale” cuando el dato está caducado o su calidad es dudosa —también en las señales de histórico que la plataforma ha descubierto pero aún no ha dado por activas— y “Offline” cuando no llega nada o la señal figura como inactiva. |
| Casillas de selección | Casilla de verificación | Marcar señales | Cada fila tiene su casilla, y la de la cabecera marca o desmarca de una vez todas las filas visibles. Hoy la selección solo sirve para señalar visualmente un grupo de filas: la pantalla no ofrece todavía ninguna acción en bloque sobre lo seleccionado. |
| Fila de señal | Fila pulsable | Abrir la ficha de la señal | Al pulsar la fila, o el botón con la flecha del extremo derecho (“Ver detalles”), se abre la ficha de esa señal sobre la pantalla. |
| Estado de carga | Indicador de progreso | — | Mientras se consulta el registro se muestra “Cargando señales...”. |
| Estado sin resultados | Estado vacío | — | Cuando ninguna señal coincide con los filtros aparece “No se encontraron señales” y el texto “Prueba a ajustar los filtros para ver más resultados.”. |
| Estado de error | Aviso de error con acción | Repetir la consulta | Si el registro no puede cargarse se muestra el motivo del fallo junto al botón “Reintentar”. |
Ficha de una señal
| Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|
| Cabecera de la ficha | Encabezado informativo | — | Muestra el nombre de la señal, su estado —“OK” o “STALE” en las señales de tiempo real, y “ACTIVE”, “DISCOVERED” o “INACTIVE” en las de histórico—, la marca “Actualizado:” con la fecha y hora del último dato, el identificador de la señal y, según el caso, su nombre técnico en el almacén de histórico o sus fuentes (“INFLUX + MQTT (vinculadas)” en las señales que tienen las dos). |
| Pestañas de la ficha | Navegación por pestañas | Cambiar de sección | Hasta cuatro pestañas: “Resumen”, “Realtime (MQTT)”, “Histórico” y “Configuración”. Las dos intermedias dependen de la procedencia: “Realtime (MQTT)” solo aparece si la señal llega por el canal en tiempo real, e “Histórico” solo si está en el almacén de histórico. Se abre siempre en “Resumen”. |
| Pestaña "Resumen" | Panel de contenido | — | Reúne la información de la señal en bloques: “Identificación” (nombre, identificador técnico, descripción y categoría), “Fuentes” (los canales de los que procede y, si está vinculada, la señal con la que lo está), “Tipo y Modo” (tipo de dato, modo de acceso, unidad y decimales), “Estado Actual” (valor, fecha del dato y salud, o el estado y las fechas de alta y actualización en las señales de histórico), “Rangos y Validación” —“Mínimo”, “Máximo”, “Escala” y “Offset”, y solo si alguno de ellos se ha definido— y “Tags”. Si no hay nada que mostrar en el estado, se lee “Sin información de estado”. |
| Pestaña "Realtime (MQTT)" | Panel de contenido | Vigilar la señal en directo | Encabezada por dos indicadores de conexión, “WebSocket” y “MQTT”, cada uno como “Conectado” o “Desconectado”. Debajo, el bloque “Topic MQTT”, que muestra la dirección de “Telemetría” por la que llega el dato y, si la señal las tiene, las de “Comando” y “ACK” que se usan para escribir sobre ella y confirmar la escritura. |
| Bloque "Suscripción" | Botón de acción | Empezar o dejar de recibir valores | Botón “Suscribir” —que pasa a “Desuscribir” una vez activo— junto al indicador “Suscrito” / “No suscrito”. Permanece desactivado mientras no haya conexión. Sin suscripción se lee “Suscríbete para ver valores en tiempo real”. |
| Bloque "Valor Actual (VTQ)" | Panel de datos en vivo | — | Con la señal suscrita, muestra el valor con su unidad, la fecha y hora del dato y su calidad (“GOOD” o “STALE”). Hasta que llega el primer dato se lee “Esperando datos...” con la aclaración “La señal está suscrita, esperando el primer valor del broker MQTT”. |
| Pestaña "Histórico" | Panel de contenido | — | Todavía no muestra datos: anuncia “Histórico pendiente” y explica que mostrará una vista previa del histórico con un mini-gráfico. Para consultar la serie histórica de una señal hay que usar los paneles y los gráficos del resto de la plataforma. |
| Pestaña "Configuración" | Formulario | Ajustar cómo se lee y se muestra la señal | Se divide en “Tipo y Modo”, “Formato” y “Rangos y Validación”. Al perfil Mantenimiento se le muestra con todos los campos bloqueados y el aviso “Solo lectura — Tu rol no permite modificar la configuración de señales. Contacta con un administrador del tenant.”. |
| Campo "Modo de acceso" | Selector | Definir cómo se interactúa con la señal | Opciones: “Read (Solo lectura)”, “Write (Solo escritura)”, “Read/Write (Lectura y escritura)”, “Alarm (Alarma)” y “Event (Evento)”. Es el valor que determina, entre otras cosas, si la señal admite escritura desde la plataforma. |
| Campo "Tipo de dato" | Dato informativo | — | Muestra el tipo de dato de la señal y no es editable: “El tipo de dato no se puede cambiar”. |
| Campos "Unidad" y "Decimales" | Campos de texto y numérico | Fijar cómo se presenta el valor | La unidad es opcional y es la que acompaña al valor en tablas y paneles (marcador de posición “Ej: °C, bar, kW”). Los decimales admiten de 0 a 6. |
| Campos "Valor mínimo" y "Valor máximo" | Campos numéricos | Acotar el rango admisible | Ambos opcionales. Delimitan el rango válido de la señal para su validación y su presentación. |
| Botón "Guardar Configuración" | Botón de acción | Guardar los cambios | Permanece desactivado mientras no haya ninguna modificación; con cambios pendientes aparece junto a él el aviso “Hay cambios sin guardar”. Al guardar muestra “Guardando...” y termina con “Configuración guardada correctamente”; si falla, muestra el motivo del error. Solo aparece a los perfiles Administrador y Admin Global. |
| Nota sobre configuración | Aviso informativo | — | Recuerda al pie que los cambios afectan a cómo se muestra y se valida la señal en dashboards, informes y automatizaciones, y que las configuraciones avanzadas —escalado, vinculación y permisos— se tramitan con el administrador del sistema. |
| Botón "Cerrar" | Botón de acción | Cerrar la ficha | Cierra la ficha y devuelve el foco al listado. |
En la versión 0.4.46 no todos los filtros de la cabecera funcionan:
- El desplegable "Tipo" no altera el listado: la opción elegida no queda reflejada en el desplegable y las señales mostradas siguen siendo las mismas.
- El desplegable "Modo" y las opciones "Vinculadas" y "Sin vincular" del filtro “Fuente” dejan el listado vacío, con el mensaje “No se encontraron señales”.
Para acotar el registro con garantías, usa el buscador y las opciones “Influx”, “MQTT” y “Ambas” del filtro “Fuente”. Si el listado se queda vacío sin motivo aparente, pulsa “Limpiar filtros” para recuperarlo entero.
💡 Guía de Uso
Entra en Cuenta y abre la pestaña “Señales”. Lo primero que conviene mirar son los cuatro contadores de la cabecera: cuántas señales hay en total, cuántas proceden del almacén de histórico, cuántas del canal en tiempo real y cuántas están vinculadas. Esa última cifra es la que mide la salud del registro: una señal vinculada es la misma medida vista por sus dos caras —el dato que llega ahora y la serie que queda guardada—, y es lo que permite pasar del valor instantáneo al histórico sin cambiar de nombre.
Para localizar una señal, escribe en “Nombre o ID de señal...”: el filtro busca en el nombre, en el identificador técnico, en la descripción y en la categoría, así que sirve tanto si conoces el nombre funcional como si solo tienes el identificador. Para recorrer el registro por bloques, usa el desplegable “Fuente” con las opciones “Influx”, “MQTT” o “Ambas”. Si el listado se queda en “No se encontraron señales”, pulsa “Limpiar filtros” antes de dar por hecho que la señal no existe.
En la tabla, tres columnas cuentan casi todo. “Fuente” dice de dónde viene la señal —“I”, “M” o las dos—; “Modo” dice qué se puede hacer con ella, y ahí “RW” significa que la plataforma puede escribir sobre la instalación a través de esa señal; y “Estado” dice si el dato es de fiar. Una señal en “Stale” está entregando un valor caducado, y una en “Offline” no está entregando nada: en ambos casos, cualquier panel o alarma que dependa de ella estará trabajando con información vieja.
Pulsa una fila para abrir su ficha. “Resumen” es la lectura rápida: de dónde viene, qué tipo de dato es, en qué unidad, con cuántos decimales, entre qué valores y con qué etiquetas. Si la señal llega en tiempo real, la pestaña “Realtime (MQTT)” permite comprobarla en directo: revisa primero que los indicadores de conexión estén en “Conectado”, pulsa “Suscribir” y observa el bloque “Valor Actual (VTQ)”. Es la forma más directa de distinguir un problema de la señal de un problema de la conexión: sin conexión el botón ni siquiera se activa; con conexión y sin datos, el problema está aguas arriba. La pestaña “Histórico” todavía no muestra la serie de datos, así que para eso hay que recurrir a los paneles y los gráficos.
Los ajustes se hacen en “Configuración”, y solo los guardan los perfiles Administrador y Admin Global. Lo habitual es corregir la unidad y los decimales —que son los que dan formato al valor allí donde se muestre— y fijar el mínimo y el máximo admisibles. Cambia lo que necesites, comprueba que aparece el aviso “Hay cambios sin guardar” y pulsa “Guardar Configuración”; sabrás que ha funcionado porque aparece “Configuración guardada correctamente” y la ficha vuelve a cargarse con los valores nuevos. Ten presente que esos cambios se notan en el resto de la plataforma: en cómo se pinta la señal en dashboards e informes y en cómo se valida en las automatizaciones.
Dos cosas que esta pantalla no hace, y conviene saberlo antes de buscarlas: no se dan de alta ni se borran señales desde aquí —el registro se construye con lo que la instalación va publicando— y tampoco se vinculan a mano las dos caras de una misma medida. Para eso, y para el escalado y los permisos, la propia ficha remite al administrador del sistema. El catálogo de activos al que pertenecen estas señales está en Equipos.