Crear paneles

Agregue paneles de visualización a un lienzo, configure consultas SQL y organice diseños para el monitoreo en tiempo real de la flota y la toma de decisiones operativas

Dashboard Studio transforma los datos de IoT Query en reportes visuales interactivos. Usted crea reportes agregando paneles a un lienzo, escribiendo consultas SQL y organizando los resultados en una estructura de menú navegable.

¿Prefiere describir el tablero en lugar de construirlo? Vea Creación de tableros con IA: el Asistente de IA genera los paneles y la consulta SQL a partir de una descripción en lenguaje natural, y el resultado se ejecuta en un lienzo antes de que lo guarde.

Los tableros personalizados proporcionan visibilidad operativa en tiempo real al consolidar métricas clave, KPI y flujos de datos en tiempo real en un único espacio de trabajo unificado.

• Conciencia situacional instantánea se logra mediante widgets en tiempo real que se actualizan automáticamente, lo que ayuda a los equipos a monitorear el rendimiento de la flota, los activos y las operaciones sin ejecutar reportes manuales.

• Toma de decisiones orientada a la acción se apoya en filtros interactivos, capacidades de desglose y componentes dinámicos que permiten a los usuarios identificar rápidamente tendencias, anomalías y cuellos de botella.

• Configuración personalizada del espacio de trabajo permite a los equipos adaptar diseños, widgets y métricas a roles, departamentos u objetivos de negocio específicos.

• Seguimiento continuo del rendimiento garantiza que las partes interesadas siempre tengan información actualizada, convirtiendo los datos en una herramienta de gestión proactiva en lugar de un análisis retrospectivo.

Mire este video para familiarizarse con la interfaz de la aplicación Dashboard Studio y aprender a crear su propio tablero personalizado de flota:

Interfaz de la aplicación Dashboard Studio, plantillas integradas de tableros, creación de tableros personalizados.

¿Qué son los tableros?

Los tableros contienen paneles que muestran visualizaciones de datos. Cada panel ejecuta una consulta SQL contra su base de datos de IoT Query, las mismas capas de datos brutos, transformación e insight a las que accede mediante clientes SQL. Usted organiza los paneles en un lienzo, configura su apariencia y guarda el reporte completo en su menú. Dashboard Studio actualiza los paneles de forma continua para reflejar los datos actuales de IoT Query.

Antes de empezar

Dashboard Studio requiere acceso a IoT Query para funcionar. Active IoT Query antes de crear reportes. Si aún no tiene acceso, contáctenos para solicitar la activación a [e-mail].

Tableros vs. reportes

Dashboard Studio ofrece dos formas de crear análisis a partir de datos de IoT Query. Elegir la adecuada depende de cómo estén estructurados los resultados de su consulta y de cómo pretenda compartir la salida.

	Tableros	Reportes
Consultas SQL	Cada panel tiene su propia consulta	Una sola consulta alimenta todas las vistas
Diseño	Lienzo de arrastrar y soltar	Fijo: tabla de datos, gráfico, mapa de ubicación
Exportación	Esquema JSON, PDF	HTML, Excel, PDF
Caso de uso	Monitoreo operativo de múltiples paneles	Análisis exportable de un solo conjunto de datos

Use tableros cuando necesite varias visualizaciones independientes en un solo lienzo, por ejemplo: combinar una tarjeta estadística de resumen de recorridos, una gráfica de consumo de combustible y una tabla de visitas a zonas en una sola vista. Use reportes cuando un solo conjunto de datos necesite explorarse como una tabla, visualizarse como una gráfica y mostrarse en un mapa simultáneamente, o cuando la salida deba exportarse y compartirse fuera de Dashboard Studio.

Para obtener más detalles sobre cómo configurar reportes, vea Creación de reportes.

¿Qué puede crear?

Dashboard Studio ofrece seis tipos de visualización. Cada uno funciona mejor para preguntas analíticas específicas.

• Tarjetas de estadística muestran métricas clave individuales como la distancia total o el número de vehículos. Úselas para resaltar cifras críticas en la parte superior de su reporte.

• Gráficas de barras comparan valores entre categorías o muestran tendencias a lo largo del tiempo. Funcionan bien para comparar la utilización de la flota entre regiones o dar seguimiento a recorridos por día.

• Gráficas de pastel muestran cómo un total se divide en partes. Úselas para mostrar el consumo de combustible por tipo de vehículo o la distribución de alertas por severidad.

• Tablas presentan registros detallados con múltiples atributos. Son adecuadas para escenarios en los que los usuarios necesitan ver registros individuales, como alertas recientes con marcas de tiempo, ID de vehículo y mensajes.

• Paneles de texto agregan contenido explicativo sin consultar datos. Úselos para instrucciones, encabezados de sección o contexto mediante formato Markdown, HTML o texto sin formato.

• Mapas muestran datos de ubicación como puntos en un mapa interactivo. Úselos para mostrar las posiciones actuales de los vehículos o la actividad de la zona.

Cada tipo de visualización cumple propósitos analíticos específicos. Las tarjetas de estadística funcionan bien para KPIs como el tamaño total de la flota o la utilización promedio. Los gráficos de barras le ayudan a comparar el rendimiento entre regiones o a hacer seguimiento de métricas a lo largo del tiempo. Los gráficos de pastel muestran cómo se dividen los totales en categorías, como el consumo de combustible por tipo de vehículo. Las tablas presentan registros detallados cuando los usuarios necesitan ver varios atributos juntos. Los paneles de texto agregan contexto, instrucciones o encabezados de sección a sus reportes. Los mapas muestran dónde está su flota o dónde ocurrieron eventos.

Los tableros importados también pueden contener tipos de panel adicionales, como gráficos de series temporales, que se muestran correctamente pero no se pueden agregar desde la galería de paneles.

Los requisitos de consulta varían según el tipo de visualización. Las tarjetas de estadística necesitan un valor numérico. Los gráficos de barras y de pastel requieren exactamente dos columnas: categorías y valores. Las tablas aceptan cualquier cantidad de columnas. Los paneles de texto no consultan datos en absoluto. Los mapas necesitan columnas de latitud y longitud. Para ver los requisitos completos de las consultas y ejemplos, consulte Escritura de consultas SQL.

Creación de tableros

Le mostraremos los pasos desde un lienzo vacío hasta un tablero estructurado e informativo.

Cómo crear su primer tablero

1

Crear un tablero nuevo

• Haga clic en la esquina inferior izquierda de la aplicación y seleccione Nuevo tablero.

• Agregar Título.

• Haga clic Crear tablero, un Comenzar aparece un mensaje.

• Seleccione Comience con un tablero en blanco para abrir un lienzo vacío en modo de edición.

2

Agregar un panel

Ahora puede agregar su primer panel al seleccionar un tipo de visualización.

1. Seleccione en la barra de herramientas de edición.

2. Elija Tipo de panel y haga clic en Agregar panel. El nuevo panel aparece en el lienzo.

3

Configurar la visualización

Ahora es el momento de agregar la configuración de la visualización:

1. Pase el mouse sobre la tarjeta y haga clic en .

2. Dashboard Studio abre un editor de paneles con tres pestañas:

   1. Propiedades del panel controla el título y el tipo

   2. Consulta SQL define qué datos mostrar

   3. Configuración de la visualización ajusta cómo se muestran esos datos

3. Asigne un nombre a su panel en Propiedades del panel.

4. Escriba una consulta SQL que recupere datos de las tablas de IoT Query y pruébela para verificar los resultados.

5. Ajuste la Configuración de la visualización.

6. Cuando esté satisfecho, guarde el panel para agregarlo a su lienzo.

Cómo escribir consultas SQL eficaces

Ahora que comprende el flujo de trabajo básico, exploremos las consultas SQL en detalle. Escriba consultas PostgreSQL que hagan referencia a tablas de IoT Query en la pestaña Consulta SQL. Todas las tablas de las capas de datos brutos, transformación e insights están disponibles. Pruebe las consultas antes de aplicarlas para verificar que los resultados coincidan con los requisitos de su visualización.

Los resultados de la consulta deben coincidir con los requisitos de la visualización. La pestaña SQL Query incluye una sección «Requisitos del conjunto de datos» que explica lo que espera la visualización que usted eligió. Use expresiones comunes de tabla (CTE) para definir parámetros al inicio de la consulta y ganar flexibilidad. Este enfoque mantiene sus consultas fáciles de mantener y le permite ajustar parámetros sin reescribir lógica compleja.

Para conocer patrones de consulta detallados, ejemplos y prácticas recomendadas, consulte Escribir consultas SQL.

Cómo organizar paneles en el lienzo

Arrastre los paneles para reubicarlos en el lienzo. Los paneles se ajustan a una cuadrícula que mantiene todo alineado. Cambie el tamaño de los paneles arrastrando sus esquinas. El lienzo usa una cuadrícula de 24 columnas, por lo que los paneles pueden ocupar de 1 a 24 columnas de ancho.

Grupo de paneles relacionados en filas para organizarlos. Arrastre un panel hasta el borde del lienzo hasta que aparezca una línea azul y luego suéltelo para crear una nueva fila. Agregue más paneles a la fila arrastrándolos junto a los existentes. Contraiga las filas usando el ícono de flecha en el borde izquierdo de la fila.

Cómo deshacer cambios de disposición

En el modo de edición, la barra de herramientas de edición en el borde derecho de la pantalla cuenta con Deshacer y Rehacer botones, justo debajo de Salir del modo de edición. Deshacer revierte su último cambio de la disposición, y Rehacer restaura un cambio que usted deshizo. Un botón aparece atenuado cuando no hay nada que deshacer o rehacer.

También puede usar atajos de teclado:

Acción	Windows y Linux	macOS
Deshacer	Ctrl+Z	⌘Z
Rehacer	Ctrl+Shift+Z o Ctrl+Y	⇧⌘Z

Los atajos no funcionan mientras un cuadro de diálogo está abierto o mientras escribe en un campo de texto o en el editor SQL.

Deshacer cubre los cambios que usted realiza en el lienzo:

• En movimiento y redimensionamiento de paneles y filas

• Agregar paneles y filas, incluidas gráficas de la Biblioteca de gráficas

• Duplicar y eliminar paneles

• Renombrar, compactar y eliminar filas

• Ordenar la disposición

Deshacer No cubre los cambios que usted guarda en un cuadro de diálogo: la configuración del panel en el editor de paneles, Filtros del dashboard, y el título del dashboard. Guardar el editor del panel o los filtros del dashboard también borra el historial de deshacer. Después de ese guardado, no puede deshacer los cambios de disposición que hizo antes de él.

Dashboard Studio recuerda hasta 50 cambios. El historial se borra cuando sale del modo de edición o recarga la página.

Dashboard Studio guarda cada cambio de disposición en cuanto usted lo realiza, incluidas cada acción de deshacer y rehacer. La disposición no tiene un botón independiente de Guardar o Cancelar botón, así que use Deshacer para volver atrás antes de salir del modo de edición.

Cómo personalizar la apariencia de la visualización

Configure las opciones específicas de la visualización en la Configuración de la visualización pestaña:

• Gráficas de barras: orientación horizontal o vertical

• Gráficas de pastel: modos estándar o de dona

• Tablas: columnas ordenables, paginación, resaltado de filas, columnas visibles

Estas configuraciones controlan cómo se muestran visualmente los datos, pero no cambian qué datos se muestran. Las opciones disponibles dependen del tipo de panel.

Ejemplo de configuración de visualización de tabla

Para ocultar una columna de la tabla, desmarque su casilla en Columnas visibles, en la Configuración de la tabla sección. Para mostrar la columna de nuevo, seleccione la casilla. Una columna oculta permanece en la consulta, por lo que los filtros del panel aún pueden usarla. Los usuarios no ven la columna en la tabla, y los archivos de Exportar CSV, Exportar Excel, y Exportar como PDF no lo incluya. Al menos una columna permanece visible.

Columnas visibles enumera las columnas del último resultado del panel. Para un panel nuevo, o después de cambiar la consulta, haga clic en Probar consulta en la consulta SQL pestaña primero.

Cómo agregar filtros al panel

Un filtro del panel permite a quienes ven el panel acotar los paneles sin editar el panel. Un filtro de fecha selecciona un período; por ejemplo, los últimos 7 días. Un filtro de valor selecciona valores en una columna; por ejemplo, unas cuantas Gestión de vehículos. Quienes ven el panel encuentran los filtros en Parámetros, los cambian y hacen clic en Aplicar.

Usted agrega, cambia y elimina filtros en la Filtros del dashboard ventana. Ábrala desde la barra de herramientas de edición en modo de edición.

Un filtro de fecha cambia solo los paneles que lo usan. Un filtro con el nombre de variable period les da dos parámetros a las consultas del panel: ${period_from} y ${period_to}.

Para agregar un filtro de fecha, siga estos pasos:

1. En la barra de herramientas de edición, haga clic en Filtros del dashboard.

2. Haga clic Agregar filtro de fecha.

3. Ingrese una Etiqueta y un Nombre de variable.

4. En Rango predeterminado, seleccione el período con el que se abre el panel. Las opciones son Hoy, Ayer, Últimos 7 días, Últimos 30 días, Últimos 90 días, y Este mes.

5. Haga clic Agregar filtro.

6. Haga clic Guardar cambios.

Para que un panel use un filtro de fecha, haga una de las siguientes acciones:

• Escriba los parámetros del filtro en la consulta del panel, por ejemplo, WHERE trip_start_time BETWEEN ${period_from} AND ${period_to}.

• Abra el editor del panel, vaya a la Filtros pestaña, active el filtro y seleccione la columna de resultados que filtra.

El nombre de variable empieza con una letra y solo contiene letras, dígitos y guiones bajos. Cada filtro necesita su propio nombre de variable. La etiqueta puede tener hasta 120 caracteres, y el nombre de variable puede tener hasta 63 caracteres.

Un filtro de valores se aplica a los paneles cuyo resultado contiene la columna del filtro cuando agrega el filtro. Los paneles que muestran un número no reciben filtros de valores. Los visualizadores seleccionan uno o más de los valores que devuelven los paneles cuando se abre el dashboard. Todos, el valor predeterminado, muestra todas las filas.

Para agregar un filtro de valores, siga estos pasos:

1. En la barra de herramientas de edición, haga clic en Filtros del dashboard.

2. Haga clic Agregar filtro de valores.

3. En Columna, seleccione la columna sobre la que filtran los visualizadores. Dashboard Studio completa Etiqueta y Nombre de variable a partir del nombre de la columna. Puede cambiarlos.

4. Haga clic Agregar filtro.

5. Haga clic Guardar cambios.

Para impedir que un panel use un filtro de valores, abra el editor del panel, vaya a la Filtros pestaña y desactive el filtro.

Un panel que agrega más tarde no usa un filtro de valores existente. Para incluir el panel, abra el filtro con el icono de edición en Filtros del dashboard, haga clic en Actualizar filtro, y haga clic en Guardar cambios. Cuando actualiza un filtro de valores de esta manera o cambia su columna, el filtro vuelve a aplicarse a todos los paneles que tienen la columna, incluidos los paneles donde lo desactivó.

Cómo cambiar o eliminar un filtro del dashboard

Para cambiar un filtro, siga estos pasos:

1. En la barra de herramientas de edición, haga clic en Filtros del dashboard.

2. Haga clic en el icono de edición junto al filtro.

3. Haga el cambio y haga clic en Actualizar filtro.

4. Haga clic Guardar cambios.

Para eliminar un filtro, haga clic en el icono de eliminar junto a él. Luego, la fila indica que el filtro fue eliminado y muestra Deshacer, lo que devuelve el filtro a su lugar. El estado de la fila Deshacer permanece hasta que guarde o cierre la ventana.

Los cambios en la Filtros del dashboard ventana llegan al dashboard solo cuando hace clic en Guardar cambios. Dashboard Studio los guarda de inmediato, y Deshacer en la barra de herramientas de edición no puede revertirlos. Para salir sin guardar, haga clic en Cancelar y confirme con Descartar. Descartar elimina todos los cambios que hizo en la ventana desde el último guardado. Los filtros que eliminó vuelven a aparecer.

Cuando elimina un filtro, los paneles dejan de usarlo. Dashboard Studio no advierte sobre una consulta del panel que todavía contiene los parámetros del filtro eliminado, como ${period_from}. Entonces, los visualizadores ven ese parámetro en Parámetros como un campo de texto, y el panel muestra un error hasta que alguien ingresa un valor. Quite el parámetro de cada consulta que lo contenga.

Cómo organizar dashboards en secciones

Dashboard Studio usa un menú jerárquico en la barra lateral izquierda. Cree secciones para agrupar dashboards/reportes relacionados. Por ejemplo, cree una sección «Gestión de flotas» que contenga reportes de estado del vehículo, utilización y mantenimiento.

Use el modo de edición del menú para crear secciones, arrastrar reportes entre ellas y reordenar elementos. Las secciones no se pueden anidar. Tiene un nivel organizativo: las secciones contienen reportes, los reportes contienen paneles.

Cómo encontrar un dashboard

El cuadro de búsqueda en la parte superior de Dashboard Studio encuentra dashboards y reportes por su contenido, no solo por sus nombres. Escriba una o más palabras, y la lista muestra hasta ocho dashboards y reportes que las contienen todas.

La búsqueda examina:

• Nombres de dashboards y reportes

• Descripciones de dashboards

• Títulos de paneles

• Las consultas SQL de paneles y filtros, si tiene el papel de administrador o editor

La búsqueda no distingue mayúsculas y minúsculas, y cada palabra puede coincidir en un lugar diferente del mismo dashboard. Por ejemplo, combustible también encuentra un dashboard que tiene un panel titulado «Consumo de combustible por vehículo». Cada resultado muestra su sección y qué coincidió: los títulos de paneles o una parte de la consulta SQL.

La búsqueda solo cubre sus propios dashboards y reportes, y omite los que están en la papelera. Tampoco busca los nombres de las tablas y columnas de IoT Query.

Use las teclas de flecha para moverse por los resultados, presione Enter para abrir uno y presione Esc para cerrar la lista.

Para filtrar el menú lateral en su lugar, escriba en el Buscar… cuadro encima del menú. Solo coincide con los nombres de dashboards y secciones.

Cómo guardar y compartir dashboards

Dashboard Studio agrega un dashboard a su menú tan pronto como lo crea, con el título y la sección que elija. Después de eso, los cambios de diseño se guardan automáticamente a medida que los realiza. Los cambios en el editor de paneles, los filtros del dashboard, el título del dashboard y la ventana Esquema completo surten efecto cuando los guarda en esa ventana. Los reportes se guardan automáticamente mientras trabaja.

Dashboard Studio ofrece dos formas de exportar un dashboard.

Exportar el esquema JSON para compartirlo con otros usuarios o crear una copia de seguridad:

1. Haga clic para entrar en modo de edición.

2. Haga clic para abrir la ventana Esquema completo.

3. Seleccione Exportación.

Dashboard Studio descarga un archivo JSON que contiene la estructura del dashboard, incluidos los paneles, las consultas y la configuración de visualización. También puede importar un esquema existente.

Exportar un PDF para compartir una captura estática fuera de Dashboard Studio:

1. Salga del modo de edición si está en él.

2. Espere a que el dashboard termine de cargarse, luego haga clic en Exportar PDF en la barra de herramientas.

Dashboard Studio convierte el diseño actual de los paneles en un documento PDF paginado.

Cómo funciona la actualización de datos

Los dashboards muestran datos actuales de IoT Query. Dashboard Studio consulta la base de datos cada vez que abre un reporte. La actualidad de los datos coincide con sus actualizaciones de IoT Query, que ocurren continuamente a medida que los dispositivos envían lecturas.

Puede actualizar los datos manualmente con el Actualizar botón de la barra de herramientas superior.

Los resultados del panel pueden permanecer en caché hasta cinco minutos, por lo que los valores pueden retrasarse brevemente con respecto a los datos subyacentes. Las consultas fallidas nunca se almacenan en caché, así que un panel que no logra cargarse siempre vuelve a ejecutarse.