> 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-reports.md). # Creación de reportes Genere reportes exportables con tablas de datos, gráficos y mapas de ubicación coordinados a partir de una sola consulta SQL. Exporte a HTML, Excel o PDF Los reportes le brindan una forma estructurada de analizar los datos de IoT Query mediante tres vistas coordinadas a partir de una sola consulta SQL: una tabla de datos paginada, un gráfico y un mapa interactivo. Use los reportes cuando necesite un resultado fijo y exportable, en lugar de un lienzo de panel de formato libre. Los reportes SQL personalizados se adaptan al instante a cualquier necesidad del negocio ajustando las consultas y los parámetros: * **Automatización** ahorra tiempo al reutilizar consultas e integrarse con herramientas de BI para actualizaciones rápidas. * **Análisis profundo** es posible al combinar, agregar y segmentar datos de múltiples fuentes. * **Precisión y relevancia** se garantizan al trabajar directamente con información sin procesar y actualizada de la base de datos. * **Visualizaciones interactivas** permiten a los usuarios explorar los datos de forma dinámica ajustando ejes, filtros y métricas. Vea este video para familiarizarse con la creación de reportes en la interfaz de la aplicación Dashboard Studio: {% embed url="" %} Creación de reportes en Dashboard Studio paso a paso {% endembed %} ## Reportes vs. tableros Tanto los reportes como los tableros ejecutan consultas SQL sobre su base de datos de IoT Query y representan los resultados como visualizaciones. La diferencia clave está en cómo se estructuran las consultas y la salida: | | Reportes | Tableros | | ------------- | ------------------------------------------------ | ---------------------------------------- | | Consultas SQL | Una sola consulta alimenta todas las vistas | Cada mosaico tiene su propia consulta | | Diseño | Fijo: tabla de datos, gráfico, mapa de ubicación | Lienzo de arrastrar y soltar | | Exportar | HTML, Excel, PDF | Esquema JSON, PDF | | Caso de uso | Análisis exportable de un solo conjunto de datos | Monitoreo operativo de múltiples paneles | Use los reportes cuando un solo conjunto de datos deba explorarse como tabla, visualizarse como gráfico y mapearse simultáneamente, o cuando la salida deba exportarse y compartirse fuera de Dashboard Studio. Use los tableros cuando necesite varias visualizaciones independientes en un solo lienzo, por ejemplo: combinar un mosaico de estadística de resumen de recorridos, un gráfico de consumo de combustible y una tabla de visitas a zonas en una sola vista. Para obtener detalles sobre la creación de tableros, consulte [Crear tableros](/docs/analytics/es/dashboard-studio/creating-dashboards.md). ## Cómo crear un reporte {% stepper %} {% step %} #### Paso 1: Abra el editor de reportes En la barra lateral izquierda, haga clic en **Herramientas**, luego seleccione **Nuevo reporte**. Dashboard Studio le pide que elija una sección de la estructura de su menú compartido. Seleccione una sección existente o elija Raíz para colocar el reporte en el nivel superior. {% endstep %} {% step %} #### Paso 2: Ingrese la información básica El editor se abre con dos campos en la parte superior: * **Title** (obligatorio): el nombre que se muestra en el menú y en los encabezados de exportación. * **Descripción** (opcional): contexto adicional visible en el editor. {% endstep %} {% step %} #### Paso 3: Escriba la consulta SQL 1. Haga clic en la **Consulta SQL** pestaña e ingrese una instrucción SELECT sobre sus tablas de IoT Query. La consulta define los tres componentes (tabla, gráfico y mapa), así que incluya cada columna que tenga intención de usar en todas las vistas, por ejemplo: {% code title="Ejemplo básico de consulta del reporte" expandable="true" %} ```sql SELECT t.device_id, o.object_label, -- Convierte coordenadas enteras escaladas a grados decimales t.latitude::float / 10000000 AS latitude, t.longitude::float / 10000000 AS longitud, -- Convierte la velocidad entera escalada a km/h t.speed::float / 100 AS speed, t.device_time DESDE raw_telematics_data.seguimiento_data_core t JOIN raw_business_data.objects o ON t.device_id = o.device_id LIMIT 1000 ``` {% endcode %} {% hint style="info" icon="lightbulb-exclamation" %} #### Algunos consejos para construir la consulta: * Agregue una cláusula LIMIT mientras configura el reporte. Reduce el tiempo de ejecución de la consulta y acelera la vista previa de los componentes. Quite o incremente el límite antes de guardar si necesita que el conjunto de datos completo esté disponible para su descarga. * Después de escribir la consulta, puede hacer clic en **Detectar columnas** para comprobar qué columnas se recuperan realmente con esta consulta. Esto ayuda a configurar los selectores de columnas en la **Componentes** pestaña. El paso es opcional. Puede configurar los componentes manualmente, pero ejecutarlo primero simplifica la selección de ejes y campos. * Cualquier consulta SQL usada en un panel de un tablero es un punto de partida válido para un reporte. Copie la consulta de un panel y ajústela para que se adapte al objetivo del reporte. Por ejemplo, agregando columnas necesarias para el mapa de ubicación o quitando agregaciones que no se apliquen a una vista de tabla. * El recetario de IoT Query contiene ejemplos de consultas generales y específicos de la industria, listos para usarse como base para los reportes. Consulte [Libro de recetas SQL](/docs/analytics/es/example-queries.md) para la lista completa. {% endhint %} {% endstep %} {% step %} #### Paso 4: Configure los componentes Haga clic en la **Componentes** pestaña. Hay tres componentes disponibles: **Tabla**, **Gráfico**, y **Mapa**. Cada uno tiene un interruptor para incluirlo o excluirlo del reporte. Puede quitar cualquier componente que no necesite. {% tabs %} {% tab title="Tabla de datos" %} La tabla de datos muestra los resultados de la consulta en filas paginadas. * **Tamaño de página**: define cuántas filas aparecen por página en la vista interactiva. Esto no afecta la exportación, que siempre contiene el conjunto completo de resultados. * **Mostrar fila de totales**: agrega una fila de resumen en la parte inferior de la tabla cuando está habilitado. {% endtab %} {% tab title="Gráfico" %} Hay dos tipos de gráficos disponibles: * **Serie temporal (línea)**: adecuado para datos representados a lo largo del tiempo. * **Gráfico de barras**: adecuado para comparaciones categóricas (también denominado gráfico de columnas). Configure los ejes: * **columna del eje X**: normalmente una columna de tiempo, como `device_time`. * **Columnas del eje Y**: una o más columnas numéricas, como la velocidad o `nivel_de_combustible`. * **Agrupar por**: opcionalmente divida las series por una columna categórica, como `etiqueta de objeto`, para mostrar un grupo de líneas o barras separado por dispositivo. {% endtab %} {% tab title="Mapa de ubicación" %} El mapa de ubicación representa puntos de datos usando coordenadas GPS. Dashboard Studio puede detectar automáticamente las columnas de latitud y longitud a partir del resultado de su consulta. Cuando **Detección automática de columnas GPS** si el interruptor está activado, las columnas necesarias para definir la ubicación (normalmente `latitud` y `longitud`) se seleccionan automáticamente si su consulta las devuelve. También puede desactivar la **Detección automática** opción y seleccionar manualmente las columnas necesarias. {% endtab %} {% endtabs %} {% endstep %} {% step %} #### Paso 5: Guardar el reporte Haga clic en Guardar. El reporte aparece en la sección de menú que seleccionó en el paso 1 y está accesible para todos los usuarios que tienen acceso a esa sección. {% endstep %} {% endstepper %} ## Ver un reporte Después de crear un reporte, este se abre inmediatamente. Verá todos los componentes configurados representados con datos en vivo de su base de datos de IoT Query. El encabezado del reporte muestra la marca de tiempo de la última actualización, el total de filas y el tiempo de ejecución de la consulta. La página del reporte también expone la consulta SQL directamente, para que pueda actualizarla cuando lo necesite. 1. Expanda la **Consulta SQL** sección para ver o editar la sentencia en línea. 2. Aplique los cambios: 1. Haga clic en **Guardar** para guardar los cambios sin ejecutar. Tendrá que hacer clic en **Refresh** para volver a ejecutar la consulta y actualizar todas las vistas con los datos actuales. 2. **Guardar y ejecutar** para aplicar la consulta actualizada de inmediato. ### Tabla de datos El **Tabla de datos** la sección muestra los resultados de la consulta con el encabezado de la sección mostrando el número total de filas devueltas por la consulta. La vista interactiva muestra solo un número limitado de filas, el pie de página confirma el número exacto. Use la **Descargar** menú desplegable para exportar el conjunto completo de resultados como Excel (.xlsx) o CSV (.csv), independientemente de cuántas filas muestre la vista interactiva. Si necesita lugares en lugar de coordenadas sin procesar, marque la **Geocodificar a dirección** casilla en la parte superior derecha del **Tabla de datos** encabezado. Cuando está habilitado, convierte las columnas de coordenadas en direcciones legibles. {% hint style="warning" %} La resolución de direcciones carga significativamente el servidor. Use esta opción solo con conjuntos de datos agregados o filtrados. Para datos telemáticos sin procesar con decenas de miles de filas, mantenga las coordenadas en formato numérico. {% endhint %} ### Gráfico La sección de gráficos se muestra debajo de la tabla de datos. Hereda la configuración que aplicó en el editor de reportes, pero también puede ajustar directamente la configuración del eje en la vista: * **Eje X**: seleccione la columna que se graficará en el eje horizontal. * **Eje Y**: seleccione la columna para graficar en el eje vertical. * **Agrupar por**: opcionalmente divida las series por una columna categórica, como `etiqueta de objeto`, para mostrar un grupo de líneas o barras separado por dispositivo. El gráfico muestra un título generado automáticamente que describe la selección actual de eje y agrupación, por ejemplo: `exceso de velocidad sobre device_time (agrupado por object_label)`. Cuando modifica la configuración de los ejes sin guardar, un **Cambios no guardados** el indicador aparece junto a **Guardar configuración del gráfico** botón. Haga clic en él para guardar los cambios de configuración en el reporte. ### Mapa de ubicación El **Mapa de ubicación** la sección muestra cada fila de la consulta como un punto en sus coordenadas GPS. El encabezado de la sección muestra la cantidad de puntos trazados. Las columnas GPS se definen al crear el reporte (automática o manualmente), y no es posible editarlas después. Si la consulta no devuelve columnas de coordenadas reconocidas, la sección muestra «No se detectaron coordenadas GPS en los resultados de la consulta.» Para los datos telemáticos con marca de tiempo, los puntos trazados representan la ruta completa de un objeto durante el período consultado. {% hint style="info" %} El mapa es interactivo: acerque y desplace el mapa para inspeccionar puntos individuales. Haga clic en **Mostrar todo** para alejar la vista y ajustar todos los puntos trazados dentro del área visible del mapa. {% endhint %} ## Exportar un reporte Dashboard Studio ofrece dos niveles de exportación. ### Exportación de la tabla de datos Use el **Descargar** menú desplegable dentro del **Tabla de datos** Sección para exportar solo los datos de la tabla. La exportación siempre contiene el conjunto completo de resultados devuelto por la consulta, independientemente del límite de visualización en la vista interactiva. ### Exportación completa del reporte Use los botones en el encabezado del reporte para exportar todos los componentes juntos. | Botón | Salida | | --------------------- | ---------------------------------------------------------------------------- | | Excel → Excel (.xlsx) | Hoja de cálculo con la tabla de datos completa | | Excel → CSV (.csv) | Archivo de valores separados por comas con la tabla de datos completa | | HTML | Archivo interactivo con la tabla de datos, el gráfico y el mapa de ubicación | | PDF | Documento estático con la tabla de datos, el gráfico y el mapa de ubicación | {% hint style="info" %} El archivo HTML exportado conserva la interactividad: el gráfico admite tooltips al pasar el cursor y el mapa de ubicación admite zoom y desplazamiento. {% endhint %} ## Editar y eliminar un reporte Para editar un reporte guardado, ya no necesita un cuadro de diálogo de editor separado. Abra el reporte desde el menú y modifique la consulta SQL o la configuración de los componentes directamente en él. La única excepción son las columnas de ubicación; se definen una sola vez al crear el reporte. Para eliminar un reporte, haga clic en **Herramientas** en la barra lateral izquierda, luego seleccione **menú de edición**. Ubique el reporte en el árbol de menús y haga clic en el menú de tres puntos junto a su nombre, luego confirme la eliminación. --- # 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 current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/analytics/es/dashboard-studio/creating-reports.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.