📊 Tabla por Asset - AG Grid · Propiedades del Widget
Objetivo Principal: Comparar el promedio de varias variables entre varios activos en una rejilla que el usuario puede ordenar, filtrar y redimensionar dentro de la propia vista, sin volver al panel de propiedades.
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 "Tabla por Asset - AG Grid" —que en la paleta lleva el texto de apoyo "Resumen interactivo por asset y variable con AG Grid Community"— y selecciónalo para abrir la ventana "Configuración del widget". Crear y editar dashboards está reservado a los perfiles Administrador y Admin Global; los demás perfiles ven los dashboards ya publicados pero no entran en el editor.
Este widget convive con la Tabla por Asset clásica: son dos elementos distintos de la paleta, comparten la misma matriz de activos y variables y los mismos datos, pero se dibujan de forma diferente. Elige la clásica cuando quieras una tabla fija y ligera, y esta cuando quien mire el dashboard vaya a necesitar reordenar, filtrar o ensanchar columnas.
🧩 Despiece de Elementos Funcionales
| Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|
| Elemento "Tabla por Asset - AG Grid" | Elemento de la paleta | Inserta el widget en la vista | Se añade arrastrándolo al canvas o haciendo clic sobre él. Al soltarlo ocupa un bloque ancho y ya trae un decimal por defecto y ningún activo seleccionado, de modo que empieza mostrando su mensaje de configuración pendiente. |
| Ventana "Configuración del widget" | Ventana de propiedades | Configura el widget | Se abre al seleccionar el widget en el canvas. Bajo el título repite el nombre del widget y organiza todo en tres pestañas: "Datos", "Apariencia" y "Texto". Se cierra con "Cancelar" o con "Guardar"; mientras se guarda, el botón muestra "Guardando...". |
| Sección "Configuración general" | Configuración de datos | Elige las variables (columnas) | Campo "Variables" con un botón "Editar" que abre el selector de variables. Cada variable elegida se convierte en una columna de la rejilla. El selector admite un máximo de 10 variables. A diferencia de otros widgets, esta tabla no muestra los desplegables "Agregación" e "Intervalo": siempre calcula el promedio de cada variable en el periodo activo. |
| Sección "Rango de tiempo" | Configuración temporal | Define el periodo de cálculo | Permite usar el filtro global del dashboard o fijar un rango propio para este widget. La cabecera de la sección indica cuál está en uso ("Usa filtro global" o el rango propio elegido). |
| Sección "Filtros de contexto" | Configuración de datos | — | Aparece cuando el widget está en un dashboard, pero esta tabla no aplica filtros de contexto: sus filas son siempre los activos elegidos más abajo. |
| Sección "Estilos de encabezados" | Configuración visual | Da formato a la fila de cabecera | Reúne "Tamaño de fuente (px)" (por defecto 11), "Peso de fuente" (por defecto "Negrita"), "Color de texto" y "Color de fondo". |
| Sección "Estilos de celdas" | Configuración visual | Da formato a las celdas | Reúne "Tamaño de fuente (px)" (por defecto 13), "Peso de fuente" (por defecto "Normal"), "Color de texto", "Color de fondo de celdas" y "Color de banda de título". Atención: en este widget "Color de banda de título" no pinta ninguna banda de título, sino la barra interna de utilidad que hay sobre la rejilla. |
| Sección "Configuración tabla por asset" | Configuración estructural | Define decimales y filas | Aparece desplegada. Contiene el desplegable "Decimales" (0, 1, 2 o 3; por defecto 1) y toda la gestión de activos. |
| Campo "Asset IDs (N seleccionados)" | Selector múltiple con búsqueda | Elige las filas de la tabla | El propio campo recuerda que "Cada fila de la tabla corresponde a un asset. Selecciona de la lista o añade manualmente." Incluye el buscador "Buscar asset...", la fila "Seleccionar todos" —que pasa a "Deseleccionar todos" cuando ya lo están, con el número de coincidencias entre paréntesis— y una casilla por activo. Si el buscador no encuentra nada muestra "Sin coincidencias". Mientras la lista se carga aparece "Cargando assets disponibles..." y, si no hay ninguno, "No se encontraron asset_id en las variables activas.". |
| Campo "Añadir asset manual..." | Campo de texto con botón "+" | Añade un activo escribiéndolo | Permite incorporar un activo que no esté en la lista, escribiendo su identificador y pulsando Intro o el botón "+". Los añadidos así se agrupan bajo la etiqueta "Manuales:" y se quitan con la "x" de su etiqueta. |
| Sección "Nombres de columnas" | Configuración de encabezados | Renombra las columnas | Aparece en cuanto hay variables seleccionadas. Explica que sirve para "Personaliza los nombres que se muestran en los encabezados de las columnas." y ofrece un campo por variable; bajo cada campo se indica el "Nombre por defecto" que se usará si se deja vacío. |
| Sección "Rangos de color por variable" | Configuración condicional | Colorea las celdas por valor | Aparece en cuanto hay variables seleccionadas. Permite definir tramos de valor con color para cada columna; el aviso de la sección recuerda que "El primer rango que coincida se aplica a la celda.". |
| Pestaña "Apariencia" · sección "Contenedor" | Configuración visual | Ajusta el marco del widget | Ofrece el estilo de marco, la casilla "Ocultar header" —que al marcarse muestra además "Mostrar al hacer hover"— y "Ocultar borde". En un dashboard aparecen también "Ocultar ventana temporal" y "Ocultar conteo de variables", que retiran esas dos etiquetas de la cabecera. Los controles "Fondo" y "Transparencia" solo están disponibles cuando el widget se coloca en una pantalla SCADA. |
| Pestaña "Texto" | Configuración textual | Añade textos auxiliares | Permite escribir un subtítulo bajo el título del widget y una nota al pie. |
| Columna "Asset" | Columna de la rejilla | Identifica cada fila | Primera columna, fijada al borde izquierdo: al desplazar la rejilla horizontalmente permanece visible, y no puede desanclarse. Muestra el nombre del activo y, si no lo tiene, su identificador. Su filtro es de texto. |
| Columnas de variable | Columnas de la rejilla | Muestran el promedio del periodo | Una por variable seleccionada, en el orden que devuelve la plataforma. Muestran el valor con los decimales configurados y la unidad, si la variable la tiene. Cuando no hay dato la celda muestra "--"; el cero es un valor válido y se muestra como tal. |
| Cabeceras de columna | Control de ordenación y reordenación | Ordena y recoloca columnas | Un clic en la cabecera ordena por esa columna, y sucesivos clics invierten y retiran la ordenación. La ordenación se aplica sobre los datos ya descargados, sin volver a pedirlos. Arrastrando la cabecera se cambia el orden de las columnas. |
| Menú de filtro de columna | Menú emergente | Filtra las filas | Cada columna ofrece su propio filtro, en español: de texto en "Asset" (con condiciones del tipo "Contiene") y numérico en las columnas de variable (con condiciones del tipo "Igual a"), combinables con "Y" y "O". Al filtrar se ocultan filas de la rejilla sin volver a consultar los datos. |
| Borde derecho de una columna | Control de redimensionado | Ajusta el ancho de la columna | Se arrastra para ensanchar o estrechar la columna. En modo edición —tanto en un dashboard como en una pantalla SCADA— el ancho se conserva: en el dashboard al pulsar "Guardar" y en SCADA por guardado automático. En los modos de solo lectura la columna se puede redimensionar, pero el ancho vuelve al original en la siguiente visita. Al abrir el widget por primera vez cada columna se ajusta al ancho de su contenido. |
| Barra de utilidad | Franja sobre la rejilla | Informa de la actualización | Franja de altura fija encima de la rejilla. Toma su color de "Color de banda de título" y muestra el aviso "Actualizando..." mientras se refrescan los datos. No lleva contador de activos: el número de filas se ve en la propia rejilla y al filtrar un contador se contradiría con lo mostrado. |
| Mensaje "Configura al menos una variable y un asset en las opciones del widget." | Mensaje de estado | — | Es lo que muestra el widget mientras falte por elegir alguna variable o algún activo. |
| Mensaje "Cargando resumen..." | Mensaje de estado | — | Aparece durante la primera carga, cuando todavía no hay datos anteriores que mostrar. |
| Mensaje "Error al cargar datos" | Mensaje de estado | — | Se muestra con un icono de aviso cuando la consulta falla. |
| Mensaje "Sin datos para los assets seleccionados" | Mensaje de estado | — | Se muestra cuando la consulta responde correctamente pero no devuelve ninguna fila para el periodo y los activos elegidos. |
💡 Guía de Uso
Este widget resuelve el mismo problema que la Tabla por Asset clásica —comparar el promedio de unas variables entre varios activos— pero pensado para quien va a trabajar sobre la tabla, no solo mirarla. La diferencia está en la rejilla: aquí se ordena por cualquier columna, se filtra columna a columna, se cambia el orden de las columnas arrastrando su cabecera y se ajusta el ancho de cada una arrastrando su borde, con la columna "Asset" siempre pegada al borde izquierdo como referencia. Todo eso ocurre sobre los datos ya descargados, así que la tabla responde al instante y no vuelve a consultar la plataforma.
Los dos widgets conviven a propósito y ninguno sustituye al otro: los dashboards creados con la tabla clásica siguen funcionando igual. La elección conviene hacerla al insertar el widget, porque el panel de propiedades no ofrece ninguna opción para convertir uno en el otro: para cambiar hay que borrar el widget y añadir el del otro tipo.
Elige Tabla por Asset - AG Grid cuando:
- La lista de activos es larga y quien consulte el dashboard necesitará buscar dentro de ella.
- Hay muchas variables y conviene poder reordenarlas o ensancharlas según lo que se esté mirando.
- Quieres ordenar por una variable concreta para ver de un vistazo qué activos están arriba y cuáles abajo.
- Los nombres de columna son largos y necesitas ajustar su ancho y que ese ajuste se conserve.
Elige la Tabla por Asset clásica cuando la tabla es pequeña, no hace falta interactuar con ella y prefieres el aspecto más compacto.
✅ Cómo configurar correctamente el widget
- Arrastra el elemento "Tabla por Asset - AG Grid" al canvas.
- Selecciónalo para abrir la ventana "Configuración del widget".
- En la pestaña "Datos":
- Pulsa "Editar" en "Variables" y elige las variables que serán columnas.
- Ajusta el "Rango de tiempo": la tabla mostrará el promedio de ese periodo.
- En "Configuración tabla por asset", fija los "Decimales" y selecciona los activos con el buscador, con "Seleccionar todos" o escribiéndolos en "Añadir asset manual...".
- Renombra las columnas en "Nombres de columnas" y, si lo necesitas, define tramos de color en "Rangos de color por variable".
- Da formato en "Estilos de encabezados" y "Estilos de celdas". Recuerda que "Color de banda de título" pinta aquí la barra de utilidad.
- En "Apariencia", ajusta el marco, la cabecera y el borde.
- En "Texto", añade subtítulo y nota al pie si aportan contexto.
- Pulsa "Guardar".
- Con el dashboard en edición, ajusta el ancho de las columnas arrastrando sus bordes y vuelve a guardar para conservarlo.