🔥 Mapa de calor temporal · Propiedades del Widget
Objetivo Principal: Localizar de un vistazo en qué horas o en qué días cada variable se sale de los tramos que has definido, cruzando variables en las filas y franjas de tiempo en las columnas.
Todavía sin captura
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 sección Datos de la paleta de widgets: arrastra al canvas el elemento "Mapa de calor temporal" —descrito en la paleta como "Variables x franjas: color por tramos y resumen por fila"— y selecciónalo para abrir la ventana "Configuración del widget". A diferencia de los widgets por turnos, este no depende de los turnos: sus columnas son horas o días. Crear y editar dashboards está reservado a los perfiles Administrador y Admin Global.
🧩 Despiece de Elementos Funcionales
| Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|
| Elemento "Mapa de calor temporal" | Elemento de la paleta | Inserta el widget en la vista | Se añade arrastrándolo al canvas o haciendo clic sobre él. Es el widget más ancho de la sección y arranca con granularidad automática, resumen por fila y leyenda activados, sin valores dentro de las celdas, con 0 decimales y la unidad "%". |
| Ventana "Configuración del widget" | Ventana de propiedades | Configura el widget | Al seleccionar el widget se abre esta ventana con un panel propio: no tiene las pestañas "Datos", "Apariencia" y "Texto" de los demás widgets de tabla. Arriba está el campo "Nombre del widget" y abajo los botones "Cancelar" y "Guardar cambios". |
| Sección "Filas (máquinas / variables)" | Lista de variables | Define las filas de la matriz | Cada variable añadida es una fila. Mientras no haya ninguna muestra "Aún no hay variables seleccionadas.". |
| Desplegable "Añadir variable (N/10)" | Lista desplegable | Añade una fila | El título lleva el recuento y el tope: como máximo 10 filas. Empieza en "Selecciona una variable…" y lista las variables activas, con su unidad entre paréntesis, que aún no se han usado. Cuando se alcanzan las 10, el desplegable desaparece. |
| Campo "Etiqueta de fila" | Campo de texto | Renombra la fila | Uno por variable; el propio título del campo recuerda entre paréntesis el identificador de la variable. Si se deja vacío se usa ese identificador. |
| Botón de papelera de la fila | Botón | Quita la fila | Elimina la variable de la matriz. |
| Desplegable "Valor agregado por franja" | Lista desplegable | Elige qué se calcula en cada celda | Dos opciones: "Media de valores", que es la de partida, y "Disponibilidad (% de tiempo activo)". La segunda convierte señales de marcha y paro en el porcentaje de tiempo que la señal estuvo activa dentro de la franja; para variables que ya vienen expresadas en porcentaje, usa "Media de valores". |
| Desplegable "Granularidad" | Lista desplegable | Decide el ancho de las columnas | Tres opciones: "Automático (≤48h horas, si no días)", "Franjas horarias" y "Días". |
| Campos "Hora inicio (0–23)" y "Hora fin (1–24)" | Campos numéricos | Acotan la ventana horaria visible | Solo tienen efecto con columnas horarias. Dejarlos vacíos muestra el día completo. No admiten cruzar la medianoche: si la hora de inicio no es anterior a la de fin, el panel avisa de que se usará el día completo. |
| Sección "Escala de color (tramos)" | Lista de tramos | Define qué color toma cada valor | De 1 a 7 tramos. Cada uno tiene un mínimo, un máximo, un color y una "Etiqueta" —que es el texto que después aparece en la leyenda—, más una papelera que se desactiva cuando solo queda un tramo. De partida vienen tres tramos: "0-59" en rojo, "60-84" en ámbar y "85+" en verde. |
| Botones "Añadir tramo" y "Restaurar default" | Botones | Gestionan la escala | "Añadir tramo" añade un tramo nuevo que arranca donde acaba el anterior, y se desactiva al llegar a siete. "Restaurar default" devuelve los tres tramos iniciales. |
| Aviso de la escala de color | Texto de ayuda | Explica y valida los tramos | Recuerda que "Se aplica el primer tramo que coincide (min y max inclusive).". Si un tramo tiene el mínimo por encima del máximo, o si dos tramos se solapan, lo advierte nombrando los tramos afectados. El aviso no bloquea: el widget sigue funcionando aplicando el primer tramo que encaje. |
| Casilla "Mostrar columna «Media del período»" | Casilla de verificación | Añade la columna de resumen | Activada por defecto. Añade al final de cada fila la media de las franjas que sí tienen dato. |
| Campo "Objetivo (vacío = sin objetivo)" | Campo numérico | Fija la meta de la fila | Solo visible con el resumen por fila activado. Sin objetivo, la columna de resumen muestra la media pero ningún estado de cumplimiento: el widget no lo inventa. |
| Desplegable "Dirección del objetivo" | Lista desplegable | Indica si conviene subir o bajar | Solo visible con el resumen por fila activado. Dos opciones: "Mayor es mejor" y "Menor es mejor". |
| Campo "Factor de aviso (0–1)" | Campo numérico | Fija la zona de aviso | Solo visible con el resumen por fila activado. Por defecto 0,85, ajustable de 0,1 a 1 en pasos de 0,05. Es la proporción del objetivo a partir de la cual la fila deja de estar en "No cumple" y pasa a "Cerca del objetivo". |
| Casilla "Mostrar leyenda de tramos" | Casilla de verificación | Muestra u oculta la leyenda | Activada por defecto. |
| Casilla "Mostrar valores dentro de las celdas" | Casilla de verificación | Escribe el número dentro de cada celda | Desactivada por defecto: de fábrica la matriz comunica solo con color, y el valor aparece al pasar el ratón. Márcala si necesitas leer las cifras sin señalar celda a celda. |
| Campo "Decimales (0–2)" | Campo numérico | Precisión de los valores | Por defecto 0. |
| Campo "Unidad" | Campo de texto | Sufijo de los valores | Por defecto "%". Se escribe pegado al número, tanto en las celdas como en la columna de resumen y en los avisos emergentes. |
| Columna de cabecera de fila | Primera columna de la matriz | Identifica cada fila | Se titula "Máquina / variable" y muestra la etiqueta de cada fila. |
| Cabeceras de franja | Fila de encabezados | Sitúan cada columna en el tiempo | Una por hora o por día, según la granularidad. Al pasar el ratón indican el instante exacto en que empieza la franja. |
| Celda de la matriz | Celda coloreada | Muestra el valor de una variable en una franja | Se pinta con el color del primer tramo en el que encaja el valor. Al pasar el ratón muestra la fila, la franja y el valor con su unidad. Si el valor queda fuera de todos los tramos, la celda se distingue sin color de escala. |
| Celda sin datos | Celda vacía | — | Cuando la franja no tiene ningún dato, la celda queda sin color de escala y su aviso emergente termina en "Sin datos". Una franja sin datos nunca se dibuja como un cero. |
| Columna "Media del período" | Columna de resumen | Cierra cada fila | Muestra la media de las franjas con dato o, si no hay ninguna, "Sin datos". Con objetivo configurado añade un icono de estado: "Cumple", "Cerca del objetivo", "No cumple" o "Sin datos". Al pasar el ratón indica además cuántas franjas de las totales tenían dato. |
| Leyenda de tramos | Franja al pie | Traduce los colores | Muestra cada tramo con su color y su etiqueta —o su intervalo si no la tiene— en orden ascendente, y cierra con la entrada "Sin datos". |
| Indicador "Última actualización" | Texto al pie | Sitúa la última lectura | Muestra la hora en que se recibieron los datos que están en pantalla. |
| Aviso "No actualizado desde" | Franja superior | Avisa de datos antiguos | Aparece sobre la matriz, con la hora del último dato válido, cuando lo que se muestra ya no está fresco. |
| Mensaje "Añade al menos una variable en la configuración del widget." | Mensaje de estado | — | Encabezado por el título "Mapa de calor temporal", es lo que muestra el widget mientras no haya ninguna fila. |
| Mensaje "Rango demasiado amplio" | Mensaje de estado | — | Acompañado de "Reduce el período (máx. 90 días / 96 franjas) para ver la matriz.". Aparece antes de consultar nada: con un periodo así de ancho el widget ni siquiera pide los datos. |
| Mensaje "Error al cargar datos" | Mensaje de estado | — | Se muestra con un icono de aviso y un botón "Reintentar" cuando la consulta falla y no hay datos anteriores. |
| Mensaje "Sin datos en este período" | Mensaje de estado | — | Aparece cuando la consulta responde correctamente pero ninguna franja de ninguna fila tiene dato. |
💡 Guía de Uso
El Mapa de calor temporal responde a una pregunta distinta de la de los widgets por turnos: no qué turno lo hace mejor, sino cuándo se degrada cada variable. Sus filas son las variables o máquinas que elijas —hasta diez— y sus columnas, franjas de tiempo: horas o días. Cada celda se pinta con el color del tramo en el que cae su valor, de modo que un patrón se ve antes de leer una sola cifra: una columna entera en rojo señala una franja horaria mala para toda la planta; una fila entera en rojo, una máquina con problema propio.
Se utiliza principalmente para:
- Detectar franjas horarias en las que el rendimiento cae de forma sistemática.
- Comparar varios equipos sobre la misma escala de color y el mismo eje de tiempo.
- Ver el reparto de un indicador a lo largo de varios días con la granularidad "Días".
- Aislar el horario relevante con la ventana horaria y dejar fuera el resto del día.
- Cerrar cada fila con su media del periodo y su estado frente al objetivo.
Tres cosas conviene tener claras al configurarlo. La primera: el color lo decides tú, en "Escala de color (tramos)". Los tres tramos de partida están pensados para porcentajes, así que si la variable se mide en otra escala hay que rehacerlos o el mapa entero saldrá de un solo color. La segunda: la ausencia de dato no es un cero; las franjas sin lectura se dejan sin color de escala y aparecen como "Sin datos", nunca en el tramo bajo. Y la tercera: el widget tiene un tope de tamaño —90 días o 96 franjas—; al superarlo avisa y no consulta los datos, así que el periodo del dashboard hay que ajustarlo a lo que la matriz puede representar.
✅ Cómo configurar correctamente el widget
- Arrastra el elemento "Mapa de calor temporal" al canvas y selecciónalo.
- Escribe el "Nombre del widget".
- En "Filas (máquinas / variables)", añade hasta diez variables y ponles una etiqueta legible.
- Elige el "Valor agregado por franja": "Media de valores" para variables ya expresadas en porcentaje, "Disponibilidad (% de tiempo activo)" para señales de marcha y paro.
- Ajusta la "Granularidad" y, si solo te interesa una parte del día, la ventana de "Hora inicio" y "Hora fin".
- Rehaz la "Escala de color (tramos)" para que se corresponda con la escala real de tus variables, y pon a cada tramo una etiqueta que sea la que quieres leer en la leyenda.
- Decide si quieres la columna "Media del período" y, en tal caso, escribe el "Objetivo" y ajusta la "Dirección del objetivo" y el "Factor de aviso (0–1)".
- En "Presentación", ajusta la leyenda, los valores dentro de las celdas, los decimales y la unidad.
- Pulsa "Guardar cambios" y comprueba que el rango de tiempo del dashboard cabe en el tope de 90 días o 96 franjas.