> 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). # Crear reportes Genere reportes exportables con tablas de datos, gráficas y mapas de ubicación coordinados a partir de una sola consulta SQL. Exporte a HTML, Excel o PDF Los reportes le ofrecen una forma estructurada de analizar los datos de IoT Query a través de tres vistas coordinadas a partir de una sola consulta SQL: una tabla de datos paginada, una gráfica y un mapa interactivo. Use los reportes cuando necesite un resultado fijo y exportable en lugar de un lienzo de panel libre. Los reportes SQL personalizados se adaptan al instante a cualquier pregunta de negocio ajustando consultas y 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 bruta 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. paneles Tanto los reportes como los paneles ejecutan consultas SQL contra su base de datos de IoT Query y muestran los resultados como visualizaciones. La diferencia clave está en cómo se estructuran las consultas y la salida: | | Reportes | Paneles | | ------------- | ------------------------------------------------ | ---------------------------------------- | | Consultas SQL | Una sola consulta alimenta todas las vistas | Cada tarjeta tiene su propia consulta | | Diseño | Fijo: tabla de datos, gráfica, mapa de ubicación | Lienzo de arrastrar y soltar | | Exportación | 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áfica y mostrarse en un mapa simultáneamente, o cuando la salida deba exportarse y compartirse fuera de Dashboard Studio. Use los paneles cuando necesite múltiples visualizaciones independientes en un solo lienzo, por ejemplo: combinar una tarjeta de estadísticas del resumen de un Recorrido, una gráfica de Consumo de combustible y una tabla de visitas a zonas en una sola vista. Para obtener más detalles sobre la creación de paneles, consulte [Creación de paneles](/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 pedirá que elija una sección de la estructura compartida de su menú. 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: * **Título** (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 en sus tablas de IoT Query. La consulta define los tres componentes (tabla, gráfica y mapa), así que incluya todas las columnas que planea usar en todas las vistas; por ejemplo: {% code title="Ejemplo básico de consulta de reporte" expandable="true" %} ```sql SELECT t.device_id, o.etiqueta_del_objeto, -- Convertir coordenadas enteras escaladas a grados decimales t.latitude::float / 10000000 AS latitude, t.longitude::float / 10000000 AS longitude, -- Convertir la velocidad entera escalada a km/h t.speed::float / 100 AS speed, t.device_time FROM raw_telematics_data.tracking_data_core t JOIN raw_business_data.objects o ON t.device_id = o.device_id LÍMITE 1000 ``` {% endcode %} {% hint style="info" icon="lightbulb-exclamation" %} #### Algunos consejos para la creación de consultas: * Agregue una cláusula LIMIT mientras configura el reporte. Reduce el tiempo de ejecución de la consulta y acelera la vista previa del componente. Quite o aumente el límite antes de guardar si necesita que el conjunto de datos completo esté disponible para 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 eliminando agregaciones que no aplican a una vista de tabla. * El libro de recetas de IoT Query contiene ejemplos de consultas generales y específicos de la industria listos para usar 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: Configurar 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**: establece 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á activado. {% endtab %} {% tab title="Gráfico" %} Hay dos tipos de gráficos disponibles: * **Serie temporal (línea)**: apta para datos graficados a lo largo del tiempo. * **Gráfico de barras**: apto para comparaciones categóricas (también conocido como gráfico de columnas). Configure los ejes: * **Columna del eje X**: por lo general, 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 una línea o un grupo de barras separado por dispositivo. {% endtab %} {% tab title="Mapa de ubicación" %} El mapa de ubicación traza 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 **Detectar automáticamente columnas GPS** el interruptor está activado, se seleccionan automáticamente las columnas necesarias para definir la ubicación (por lo general `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 del menú que seleccionó en el paso 1 y está disponible para todos los usuarios que tienen acceso a esa sección. {% endstep %} {% endstepper %} ## Ver un reporte Después de crear un reporte, 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 número 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 instrucción en línea. 2. Aplique los cambios: 1. Haga clic en **Guardar** para guardar los cambios sin ejecutarlos. Deberá hacer clic en **Actualizar** 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 La **tabla de datos** La sección muestra los resultados de la consulta, con el encabezado de la sección mostrando el 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 el **menú desplegable Descargar** para exportar el conjunto de resultados completo como Excel (.xlsx) o CSV (.csv), independientemente de cuántas filas muestre la vista interactiva. Si necesita ubicaciones en lugar de coordenadas sin procesar, marque la **casilla «Geocodificar a dirección»** en la esquina superior derecha del **tabla de datos** encabezado. Cuando está activada, resuelve las columnas de coordenadas en direcciones de calles legibles. {% hint style="warning" %} La resolución de direcciones impone una carga significativa en 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áfico se muestra debajo de la tabla de datos. Hereda la configuración que aplicó en el editor de reportes, pero también puede ajustar la configuración de los ejes directamente en la vista: * **Eje X**: seleccione la columna para graficar en el eje horizontal. * **Eje Y**: seleccione la columna para representar en el eje vertical. * **Agrupar por**: opcionalmente divida las series por una columna categórica, como `etiqueta de objeto`, para mostrar una línea o un grupo de barras separado por dispositivo. El gráfico muestra un título generado automáticamente que describe el eje actual y la selección de agrupación, por ejemplo: `velocidad en función de device_time (agrupada por object_label)`. Cuando modifica la configuración del eje sin guardar, un **Cambios no guardados** el indicador aparece junto a la **Guardar configuración del gráfico** botón. Haga clic en él para guardar los cambios de configuración en el reporte. Cuando **Agrupar por** divide el gráfico en grupos, el gráfico traza los primeros 10 grupos. Para elegir otros grupos, haga clic en **Grupos**, que muestra cuántos grupos se trazan del total. En la lista, haga clic en un grupo para trazarlo o quitarlo del gráfico. Para encontrar un grupo, búsquelo por nombre. Las filas sin valor en la **Agrupar por** columna no pertenecen a ningún grupo, y el gráfico las excluye. **Seleccionar todo** y **Limpiar** se aplican a los grupos que coinciden con la búsqueda. **Seleccionar todo** no está disponible cuando trazaría más de 1,000 grupos en total. La lista muestra hasta 100 grupos que no están trazados, así que búsquelos para encontrar los demás. Para volver a los primeros 10 grupos, haga clic en **Restablecer valores predeterminados**. Dashboard Studio no guarda la selección de grupos. La selección se restablece cuando abre el reporte de nuevo o selecciona otra **Agrupar por** columna. ### Mapa de ubicación La **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 el número de puntos trazados. Las columnas GPS se definen al crear el reporte (automáticamente o manualmente); después no es posible editarlas. 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 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: haga zoom y desplácese para inspeccionar puntos individuales. Haga clic en **Mostrar todo** para alejarse y ajustar todos los puntos trazados dentro del área visible del mapa. {% endhint %} ## Exportar un reporte Dashboard Studio ofrece dos niveles de exportación. ### Exportar la tabla de datos Use el **menú desplegable Descargar** menú desplegable dentro de la **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. ### Exportar el reporte completo Use los botones del 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 | El gráfico de un archivo HTML o PDF traza los mismos grupos que el gráfico en pantalla. Cuando el gráfico traza solo algunos de los grupos, el archivo muestra el número de grupos trazados y el número total de grupos. {% hint style="info" %} El archivo HTML exportado conserva la interactividad: el gráfico admite información sobre herramientas 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 aparte. Abra el reporte desde el menú y modifique la consulta SQL o la configuración de los componentes directamente allí. 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 del menú 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 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-reports.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 `automate deployments from our CI pipeline` 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.