> 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 informes Los informes le ofrecen una forma estructurada de analizar 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. Utilice los informes cuando necesite una salida fija y exportable, en lugar de un lienzo de panel libre. Los informes 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 combinando, agregando y segmentando datos de múltiples fuentes. * **Precisión y relevancia** se garantizan al trabajar directamente con información de base de datos en bruto y actualizada. * **Visualizaciones interactivas** permiten a los usuarios explorar los datos dinámicamente ajustando ejes, filtros y métricas. Vea este video para familiarizarse con la creación de informes en la interfaz de la app Dashboard Studio: {% embed url="" %} Creación de informes en Dashboard Studio paso a paso {% endembed %} ## Informes frente a paneles Tanto los informes como los paneles ejecutan consultas SQL en 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: | | Informes | Paneles de control | | ------------- | ------------------------------------------------- | --------------------------------------- | | 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 | Solo esquema JSON | | Caso de uso | Análisis exportable de un único conjunto de datos | Supervisión operativa de varios paneles | Utilice los informes cuando un único 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. Utilice los paneles cuando necesite varias visualizaciones independientes en un solo lienzo; por ejemplo: combinar un mosaico de estadísticas de resumen de viaje, 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 paneles, consulte [Creación de paneles de control](/docs/analytics/es/dashboard-studio/creating-dashboards.md). ## Cómo crear un informe {% stepper %} {% step %} #### Paso 1: Abra el editor de informes En la barra lateral izquierda, haga clic en **Herramientas**, luego seleccione **Nuevo informe**. Dashboard Studio le solicita que elija una sección de la estructura de su menú compartido. Seleccione una sección existente o elija Root para colocar el informe en el nivel superior. {% endstep %} {% step %} #### Paso 2: Introduzca 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 introduzca una instrucción SELECT sobre sus tablas de IoT Query. La consulta define los tres componentes (tabla, gráfico y mapa), por lo que incluya cada columna que tenga previsto usar en todas las vistas; por ejemplo: {% code title="Ejemplo de consulta básica de informe" expandable="true" %} ```sql SELECT t.device_id, o.object_label, -- 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 LIMIT 1000 ``` {% endcode %} {% hint style="info" icon="lightbulb-exclamation" %} #### Algunos consejos para construir consultas: * Añada una cláusula LIMIT mientras configura el informe. Reduce el tiempo de ejecución de la consulta y acelera la vista previa de los componentes. Quite o aumente el límite antes de guardar si necesita que el conjunto de datos completo esté disponible para la 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 pestaña **Componentes** . Este paso es opcional. Puede configurar los componentes manualmente, pero ejecutarlo primero simplifica la selección de ejes y campos. * Cualquier consulta SQL utilizada en un panel del tablero es un punto de partida válido para un informe. Copie la consulta de un panel y ajústela para que se adapte al objetivo del informe. Por ejemplo, añadiendo columnas necesarias para el mapa de ubicación o eliminando agregaciones que no se aplican a una vista de tabla. * El Recipe Book de IoT Query contiene ejemplos de consultas generales y específicos de la industria listos para usar como base para informes. Consulte [SQL Recipe Book](/docs/analytics/es/example-queries.md) 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 informe. Puede eliminar 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 a la exportación, que siempre contiene el conjunto de resultados completo. * **Mostrar fila de totales**: añade una fila de resumen en la parte inferior de la tabla cuando está habilitada. {% endtab %} {% tab title="Gráfico" %} Hay dos tipos de gráfico disponibles: * **Serie temporal (línea)**: adecuada para datos representados a lo largo del tiempo. * **Gráfico de barras**: adecuada para comparaciones categóricas (también denominada 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 speed o `fuel_level`. * **Agrupar por**: opcionalmente, divida las series por una columna categórica, como `object_label`, para mostrar una línea o un grupo de barras independiente por dispositivo. {% endtab %} {% tab title="Mapa de ubicación" %} El mapa de ubicación representa los puntos de datos usando coordenadas GPS. Dashboard Studio puede detectar automáticamente columnas de latitud y longitud en el resultado de su consulta. Cuando el interruptor **Detectar automáticamente columnas GPS** está activado, las columnas necesarias para definir la ubicación (normalmente `latitude` y `longitude`) se seleccionan automáticamente si su consulta las devuelve. También puede desactivar la opción **Detección automática** y seleccionar manualmente las columnas necesarias. {% endtab %} {% endtabs %} {% endstep %} {% step %} #### Paso 5: Guarde el informe Haga clic en Guardar. El informe aparece en la sección del menú que seleccionó en el paso 1 y es accesible para todos los usuarios que tengan acceso a esa sección. {% endstep %} {% endstepper %} ## Visualización de un informe Después de crear un informe, se abre inmediatamente. Verá todos los componentes configurados representados con datos en vivo de su base de datos de IoT Query. El encabezado del informe muestra la última marca de tiempo de actualización, el recuento total de filas y el tiempo de ejecución de la consulta. La página del informe también muestra la consulta SQL directamente, por lo que puede actualizarla siempre que 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 **Guardar** para guardar los cambios sin ejecutar. 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 sección mostrando el recuento 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. Utilice el desplegable **Descargar** dentro de la sección para exportar solo los datos de la tabla. La exportación siempre contiene el conjunto completo de resultados devueltos por la consulta, independientemente del límite de visualización en la vista interactiva. Si necesita ubicaciones en lugar de coordenadas en bruto, marque la casilla **Geocodificar a dirección** en la parte superior derecha del encabezado de la **Tabla de datos** . Cuando está habilitada, resuelve las columnas de coordenadas en direcciones postales legibles. {% hint style="warning" %} La resolución de direcciones supone una carga importante para el servidor. Utilice esta opción solo con conjuntos de datos agregados o filtrados. Para datos telemáticos en bruto 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 los ajustes que aplicó en el editor de informes, pero también puede ajustar la configuración de los ejes directamente en la vista: * **Eje X**: seleccione la columna que se representará en el eje horizontal. * **Eje Y**: seleccione la columna que se representará en el eje vertical. * **Agrupar por**: opcionalmente, divida las series por una columna categórica, como `object_label`, para mostrar una línea o un grupo de barras independiente por dispositivo. El gráfico muestra un título generado automáticamente que describe la selección actual de ejes y agrupación; por ejemplo: `speed sobre device_time (agrupado por object_label)`. Cuando modifica la configuración de los ejes sin guardar, aparece un indicador de **Cambios sin guardar** junto al botón **Guardar configuración del gráfico** . Haga clic en él para conservar los cambios de configuración en el informe. ### 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 informe (automáticamente o de forma manual); 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 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: use zoom y desplazamiento 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 %} ## Exportación de un informe Dashboard Studio proporciona dos niveles de exportación. ### Exportación de la tabla de datos Utilice el **Descargar** 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 devueltos por la consulta, independientemente del límite de visualización en la vista interactiva. ### Exportación completa del informe Utilice los botones del encabezado del informe 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 información emergente al pasar el cursor y el mapa de ubicación admite zoom y desplazamiento. {% endhint %} ## Edición y eliminación de un informe Para editar un informe guardado, ya no necesita un cuadro de diálogo de editor independiente. Abra el informe desde el menú y modifique directamente en él la consulta SQL o la configuración de los componentes. La única excepción son las columnas de ubicación; se definen una sola vez al crear el informe. Para eliminar un informe, haga clic en **Herramientas** en la barra lateral izquierda y luego seleccione **Editar menú**. Localice el informe en el árbol del menú y haga clic en el menú de tres puntos junto a su nombre; después, 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: ``` GET https://navixy.com/docs/analytics/es/dashboard-studio/creating-reports.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.