📊 Grupo de KPIs · Propiedades del Widget
Objetivo Principal: Permite al usuario configurar el widget Grupo de KPIs, utilizado para representar múltiples indicadores de rendimiento agrupados visualmente dentro de dashboards Analytics.
📸 Mapeo de Interfaz

La imagen corresponde a una versión anterior. En la 0.4.46 la sección "Contenedor" de un dashboard ya no ofrece el selector "Fondo" ni el deslizador "Transparencia" —siguen estando al configurar el widget desde una vista SCADA— sino las casillas "Ocultar ventana temporal" y "Ocultar conteo de variables", y cada tarjeta ya creada se puede editar con sus propios ajustes.
🧩 Despiece de Elementos Funcionales
Los elementos marcados con — no aparecen señalados en la captura: existen en la versión 0.4.46 pero la imagen no los numera.
| # | Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|---|
| 1 | Pestañas de configuración | Navegación interna | Cambia sección de propiedades | Permite alternar entre las distintas categorías de configuración del widget. Para utilizarlo, el usuario debe pulsar "Datos", "Apariencia" o "Texto" según el tipo de configuración que quiera modificar. |
| 1.1 | Campo "Nombre del widget" | Campo de texto | Renombra el widget | Permite definir el nombre identificativo del widget dentro del dashboard. Para utilizarlo, el usuario debe escribir el nombre que quiera mostrar en la cabecera del widget. |
| 1.2 | Sección "Configuración General" | Configuración de datos | Configura variables y agregación | Permite seleccionar las variables que utilizará el widget y cómo se procesarán los datos. Para utilizarlo, el usuario debe pulsar "Editar", seleccionar variables y configurar agregación e intervalo. |
| 1.3 | Sección "Tarjetas KPI" | Configuración de tarjetas | Gestiona las tarjetas KPI individuales | Permite añadir y configurar cada KPI del grupo. Mientras no se haya añadido ninguna tarjeta, la sección avisa con "Añade al menos dos KPIs desde las variables seleccionadas."; con una sola tarjeta sugiere usar el widget de KPI simple y con más de ocho recomienda usar una tabla. Para utilizarlo, el usuario selecciona primero las variables en "Configuración general" y después pulsa cada variable de la lista "Variables disponibles" para convertirla en tarjeta, siguiendo la indicación "Haz clic en una variable para añadirla como tarjeta KPI.". La cabecera de la sección indica cuántos KPIs hay configurados. |
| 1.4 | Sección "Opciones de Visualización" | Configuración visual | Ajusta la presentación del grupo | Permite configurar el espaciado entre tarjetas y activar modos de visualización especiales. Incluye las siguientes opciones: "Mostrar slider" para mostrar las tarjetas en carrusel, "Modo compacto" para reducir padding y tamaño de fuentes, y "Modo transparente" para eliminar fondo, borde y sombra. Para utilizarlo, el usuario debe introducir el valor de espaciado deseado en píxeles y activar las casillas según necesidad. |
| 1.5 | Sección "Rango de Tiempo" | Configuración temporal | Configura el periodo de datos | Permite definir el rango temporal utilizado por el widget. El usuario puede usar el filtro global, de modo que el widget usará el selector de fechas del dashboard, o configurar un rango propio. |
| 2 | Pestaña "Apariencia" | Configuración visual | Personaliza el widget | Permite acceder a todas las configuraciones visuales del contenedor del widget. |
| 2.1 | Sección "Contenedor" — Estilo de marco | Lista desplegable | Ajusta el estilo del contenedor | Permite seleccionar el estilo visual del marco del widget, como "Tarjeta". Para utilizarlo, el usuario debe seleccionar la opción deseada en el desplegable. |
| 2.2 | Opciones "Ocultar header" y "Ocultar borde" | Casillas de verificación | Controla la visibilidad de elementos | Permite ocultar la cabecera del widget y/o su borde exterior. Para utilizarlo, el usuario debe activar o desactivar cada casilla según el diseño deseado. |
| 2.3 | Selector "Fondo" | Selector de color | Define el color de fondo | Permite elegir el color de fondo del contenedor del widget, #FFFFFF por defecto. Sólo está disponible al configurar el widget desde una vista SCADA: en un dashboard esta opción no se muestra. |
| 2.4 | Deslizador "Transparencia" | Deslizador | Ajusta la opacidad del contenedor | Permite controlar el nivel de transparencia del contenedor, del 0 % al 100 %. Sólo está disponible al configurar el widget desde una vista SCADA: en un dashboard esta opción no se muestra. |
| 3 | Pestaña "Texto" | Configuración textual | Configura textos adicionales | Permite acceder a configuraciones relacionadas con textos auxiliares mostrados en el widget. |
| 3.1 | Campo "Subtítulo" | Campo de texto | Añade un texto secundario | Permite añadir un subtítulo que se muestra bajo el título principal del widget. Para utilizarlo, el usuario debe escribir el texto deseado en el campo "Texto secundario bajo el título". |
| 3.2 | Campo "Nota al pie" | Campo de texto | Añade una nota informativa | Permite añadir un texto pequeño al final del widget a modo de nota o aclaración. Para utilizarlo, el usuario debe escribir el texto deseado en el campo "Texto pequeño al final del widget". |
| — | Ajustes de cada tarjeta KPI | Campos y selectores | Personaliza un KPI del grupo | Cada tarjeta creada se puede editar: escribir su "Título del KPI" y su "Sufijo/Unidad", elegir "Decimales" (de 0 a 3) y el "Layout" ("Estándar", "Compacto" o "Mini"). Los botones de la tarjeta permiten además compactarla, moverla de orden, duplicarla y eliminarla. |
| — | Sección "Filtros de contexto" | Configuración de datos | Elige de qué contexto salen los datos | Aparece en la pestaña "Datos", debajo de "Rango de tiempo", al configurar el widget desde un dashboard. Permite que el widget siga los filtros generales del dashboard o que fije un contexto propio de "Planta", "Zona", "Máquina", "Grupo" y "Turno". Se cambia con los botones "Filtro global" y "Contexto propio", y la cabecera de la sección indica en cuál de los dos modos está. |
| — | Casillas "Ocultar ventana temporal" y "Ocultar conteo de variables" | Casillas de verificación | Limpian la cabecera del widget | En un dashboard, la sección "Contenedor" añade estas dos casillas, que esconden las etiquetas de rango temporal y de número de variables que el widget muestra en su cabecera. |
| — | Casilla "Mostrar al hacer hover" | Casilla de verificación | Recupera la cabecera al pasar el ratón | Aparece al marcar "Ocultar header" y hace que la cabecera vuelva a mostrarse cuando el cursor se sitúa sobre el widget. |
💡 Guía de Uso
El widget Grupo de KPIs está diseñado para agrupar y representar múltiples indicadores de rendimiento en un único contenedor visual.
Se utiliza principalmente para:
- Mostrar varios KPIs relacionados en un mismo espacio
- Comparar indicadores de una misma categoría
- Organizar métricas por área o proceso
- Visualizar datos en modo carrusel para espacios reducidos
- Supervisar múltiples variables simultáneamente
- Monitorizar indicadores en tiempo real
- Presentar dashboards compactos y organizados
✅ Cómo configurar correctamente el widget Grupo de KPIs
- Arrastra el widget al canvas.
- Selecciona el widget dentro del dashboard.
- Desde el panel de propiedades:
- Configura las variables y el método de agregación.
- Añade al menos dos KPIs pulsando las variables de "Variables disponibles".
- Ajusta en cada tarjeta su título, su unidad, sus decimales y su layout.
- Ajusta el espaciado entre tarjetas.
- Activa el modo slider, compacto o transparente si es necesario.
- Configura el rango temporal deseado.
- Personaliza el contenedor: estilo de marco y visibilidad de la cabecera, el borde y las etiquetas.
- Añade subtítulo y nota al pie si se requiere contexto adicional.
- Guarda los cambios realizados.