📊 KPI Calculado · Propiedades del Widget
Objetivo Principal: Permite al usuario configurar el widget KPI Calculado, utilizado para mostrar un indicador obtenido a partir de una fórmula sobre varias variables dentro de dashboards Analytics.
📸 Mapeo de Interfaz
La captura no muestra esto
La imagen corresponde a una versión anterior. En la 0.4.46 la pestaña "Datos" incluye además la sección "Objetivo", y 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".
🧩 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 las variables del cálculo | Permite seleccionar las variables que intervienen en la fórmula y cómo se procesan sus datos. Para utilizarlo, el usuario debe pulsar "Editar" y elegir las variables; el orden en que las selecciona determina la referencia que le corresponde a cada una. |
| 1.2.1 | Botón "Editar" variables | Botón de acción | Abre selector de variables | Permite acceder al selector de variables para asignar las fuentes de datos del widget. Para utilizarlo, el usuario debe pulsar el icono de edición junto al campo de variables. |
| 1.3 | Sección "Rango de Tiempo" | Configuración temporal | Configura periodo de datos | Permite definir el rango temporal utilizado por el widget. Para utilizarlo, el usuario puede usar el filtro global o configurar un rango propio. El texto informativo indica que el widget usará el selector de fechas del dashboard cuando se selecciona "Filtro global". |
| 1.4 | Sección "Cálculo KPI" | Configuración de cálculo | Reúne el cálculo del indicador | Agrupa todo lo que define el valor del widget. El texto de la sección recuerda que el orden de las variables determina las referencias de la fórmula: {0}, {1}, etc. |
| 1.5 | Lista "Mapa variables - referencias" | Lista informativa | Muestra qué referencia usa cada variable | Enumera las variables seleccionadas junto a la referencia que les corresponde, para escribir la fórmula sin equivocarse. Mientras no haya variables, indica que hay que seleccionarlas para habilitar las referencias de fórmula. |
| 1.6 | Campo "Fórmula" | Campo de texto | Introduce la expresión de cálculo | Permite escribir la operación que se quiere calcular, por ejemplo ({0} - {1}) / {1} * 100. Se pueden usar referencias por índice ({0}, {1}) o por identificador de variable. El campo es obligatorio: sin fórmula el widget no se puede guardar. |
| 1.7 | Campos "Formato del resultado", "Sufijo (opcional)" y "Decimales" | Selectores y campo de texto | Da formato al valor calculado | "Formato del resultado" ofrece "Número", "Porcentaje", "Moneda" o "Personalizado"; "Sufijo (opcional)" añade una unidad al valor, por ejemplo kWh, ºC o %; y "Decimales" fija cuántos decimales se muestran, de 0 a 3. |
| 1.8 | Sección "Comparación del KPI" | Configuración de análisis | Compara con el inicio del periodo | Permite comparar el valor calculado actual frente al inicio de la ventana temporal activa. Para utilizarlo, el usuario debe activar la casilla "Mostrar variación del periodo" y elegir después, en el selector "Interpretación del cambio", cómo debe leerse una subida: "General (Verde sube / Rojo baja)", "Económico (Rojo sube / Verde baja)" o "Térmico (Rojo sube / Azul baja)". |
| 1.9 | Sección "Estados Booleanos (Opcional)" | Configuración condicional | Configura la lectura de una variable de dos estados | Permite personalizar cómo se lee un resultado booleano. Mientras no haya una variable booleana seleccionada, la sección avisa con "Selecciona una variable booleana para habilitar esta configuración."; si la variable elegida no es booleana, indica que la sección no aplica. Con una variable booleana, el usuario puede escribir la "Etiqueta ON (true)" y la "Etiqueta OFF (false)" y activar "Diferenciar color por estado". |
| 2 | Pestaña "Apariencia" | Configuración visual | Personaliza el widget | Permite acceder a todas las configuraciones visuales 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. |
| 2.5 | Sección "KPI-first: valor y jerarquía" | Configuración visual | Ajusta la legibilidad del valor | Prioriza la lectura del valor principal en tamaños pequeños. Permite elegir "Familia de fuente" y "Peso visual del valor", ajustar el deslizador "Tamaño del valor principal", elegir el "Color del valor principal" y fijar la "Alineación del KPI" con los botones "Izquierda", "Centro" y "Derecha". |
| 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". |
| — | Selectores "Agregación" e "Intervalo" | Listas desplegables | Definen cómo se agregan los datos | Aparecen dentro de "Configuración general" una vez seleccionadas las variables. "Agregación" fija cómo se resumen los datos de cada variable (Promedio, Suma, Máximo, etc.) e "Intervalo" el paso de agrupación, siendo "Automático" la opción por defecto. |
| — | Botón "Probar fórmula" | Botón de acción | Comprueba el resultado con datos reales | Situado junto al campo "Fórmula", calcula la expresión con los datos del rango y la agregación configurados y muestra los valores usados por cada referencia, la expresión resuelta y el resultado, avisando si alguna variable no ha aportado datos. Permanece desactivado mientras la fórmula esté vacía, no haya variables o existan errores. |
| — | Sección "Objetivo" | Configuración de análisis | Compara el resultado con una meta | Permite fijar una meta para el indicador. Para utilizarlo, el usuario escribe la cifra en "Valor objetivo (vacío = sin objetivo)"; sin un objetivo válido no se muestra desviación ni estado de cumplimiento. |
| — | Casilla "Mostrar desviación y estado vs objetivo" | Casilla de verificación | Muestra la desviación y el cumplimiento | Aparece al informar un valor objetivo y añade la referencia "Objetivo", la desviación con flecha y el estado "Cumple", "Cerca del objetivo" o "No cumple". Al activarla se despliegan "Formato de la desviación" ("Puntos (pp)", "Porcentaje relativo (%)" o "Absoluto"), "Dirección del objetivo" ("Mayor es mejor" o "Menor es mejor") y "Factor de aviso (0–1)", que delimita la zona "Cerca del objetivo" y vale 0,85 por defecto. |
| — | 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 KPI Calculado está diseñado para mostrar un único valor obtenido a partir de una fórmula que combina varias variables, y no la lectura directa de una sola.
Se utiliza principalmente para:
- Calcular rendimientos, ratios y porcentajes a partir de varias variables
- Comparar dos medidas entre sí (diferencia, cociente o desviación)
- Mostrar indicadores que no existen como variable en el sistema
- Comparar el resultado calculado frente al inicio del periodo
- Contrastar el resultado con un valor objetivo
- Presentar el valor con su unidad, formato y decimales
- Destacar el resultado en tamaños de widget reducidos
✅ Cómo configurar correctamente el widget KPI Calculado
- Arrastra el widget al canvas.
- Selecciona el widget dentro del dashboard.
- Desde el panel de propiedades:
- Selecciona las variables que intervienen en el cálculo; su orden fija las referencias.
- Ajusta el intervalo y el rango temporal.
- Escribe la fórmula en "Cálculo KPI" apoyándote en el mapa de variables y referencias.
- Pulsa "Probar fórmula" para comprobar el resultado con datos reales antes de guardar.
- Elige el formato del resultado, el sufijo y los decimales.
- Activa "Mostrar variación del periodo" si quieres comparar con el inicio del periodo.
- Fija un "Valor objetivo" si quieres ver la desviación y el estado de cumplimiento.
- Ajusta la legibilidad del valor en "KPI-first: valor y jerarquía".
- Añade subtítulo y nota al pie si se requiere contexto adicional.
- Guarda los cambios realizados.
El widget no se puede guardar sin variables ni sin fórmula: mientras falte alguna de las dos, el panel avisa con "Revisa fórmula y variables antes de guardar." y el botón de guardar queda bloqueado.