> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/es/dashboard-studio/creating-dashboards.md). # 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. {% hint style="info" %} **¿Prefiere describir el tablero en lugar de construirlo?** Vea [Creación de tableros con IA](/docs/analytics/es/dashboard-studio/creating-dashboards/ai-dashboards.md): 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. {% endhint %} 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: {% embed url="" %} Interfaz de la aplicación Dashboard Studio, plantillas integradas de tableros, creación de tableros personalizados. {% endembed %} ## ¿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. {% hint style="info" %} #### 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 . {% endhint %} ### 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](/docs/analytics/es/dashboard-studio/creating-reports.md). ## ¿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.](/docs/analytics/es/dashboard-studio/writing-sql-queries.md#how-to-write-sql-for-visualizations) ## 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 {% stepper %} {% step %} **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. {% endstep %} {% step %} **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. {% endstep %} {% step %} **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. {% endstep %} {% endstepper %} ### 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](/docs/analytics/es/dashboard-studio/writing-sql-queries.md). ### 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. {% hint style="info" %} 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. {% endhint %} ### 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. {% hint style="warning" %} 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. {% endhint %} ### 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. {% columns %} {% column width="41.66666666666667%" %} 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. {% endcolumn %} {% column width="58.33333333333333%" %}
{% endcolumn %} {% endcolumns %} ### 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. {% hint style="info" %} 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. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://navixy.com/docs/analytics/es/dashboard-studio/creating-dashboards.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.