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 empresarial 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 la base de datos sin procesar y actualizada.

• Visualizaciones interactivas permiten a los usuarios explorar los datos dinámicamente modificando ejes, filtros y métricas.

Vea este video para familiarizarse con la creación de informes en la interfaz de la aplicación Dashboard Studio:

Creación de informes en Dashboard Studio paso a paso

Informes vs. paneles

Tanto los informes como los paneles ejecutan consultas SQL contra su base de datos IoT Query y representan los resultados como visualizaciones. La diferencia clave está en cómo se estructuran las consultas y la salida:

	Informes	Paneles
Consultas SQL	Una consulta alimenta todas las vistas	Cada panel 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	Monitoreo operativo con paneles múltiples

Use informes cuando un único conjunto de datos necesite explorarse como tabla, visualizarse como gráfico y mapearse simultáneamente, o cuando la salida deba exportarse y compartirse fuera de Dashboard Studio. Use paneles cuando necesite múltiples visualizaciones independientes en un solo lienzo; por ejemplo: combinar un mosaico de resumen de viaje, un gráfico de consumo de combustible y una tabla de visitas a zonas en una vista.

Para detalles sobre la creación de paneles, consulte Creación de paneles.

Cómo crear un informe

1

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 su estructura de menú compartida. Seleccione una sección existente o elija Root para colocar el informe en el nivel superior.

2

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.

3

Paso 3: Escriba la consulta SQL

1. Haga clic en la Consulta SQL pestaña y introduzca una instrucción SELECT contra sus tablas de IoT Query. La consulta define los tres componentes (tabla, gráfico y mapa), por lo que incluya todas las columnas que pretenda usar en todas las vistas; por ejemplo:

Ejemplo básico de consulta para informe

SELECT
    t.device_id,
    o.object_label,
    -- Convert scaled integer coordinates to decimal degrees
    t.latitude::float / 10000000 AS latitude,
    t.longitude::float / 10000000 AS longitude,
    -- Convert scaled integer speed to 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

Algunos consejos para construir consultas:

• Agregue una cláusula LIMIT al configurar el informe. Reduce el tiempo de ejecución de la consulta y acelera la vista previa de los componentes. Elimine 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 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 de un panel es un punto de partida válido para un informe. Copie la consulta desde un panel y ajústela para que se adapte al objetivo del informe. Por ejemplo, agregando columnas necesarias para el mapa de ubicación o eliminando agregaciones que no se 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 informes. Vea Libro de recetas SQL para la lista completa.

4

Paso 4: Configure los componentes

Haga clic en la Componentes pestaña. Tres componentes están disponibles: Tabla, Gráfico, y Mapa. Cada uno tiene un interruptor para incluirlo o excluirlo del informe. Puede eliminar cualquier componente que no necesite.

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 completo de resultados.

• Mostrar fila de totales: añade una fila de resumen en la parte inferior de la tabla cuando está habilitado.

Gráfico

Mapa de ubicación

5

Paso 5: Guarde el informe

Haga clic en Guardar. El informe aparecerá en la sección del menú que seleccionó en el paso 1 y será accesible para todos los usuarios que tengan acceso a esa sección.

Ver un informe

Después de crear un informe se abre inmediatamente. Verá todos los componentes configurados renderizados con datos en vivo desde su base de datos IoT Query. El encabezado del informe muestra la marca de tiempo de la última actualización, el recuento total de filas y el tiempo de ejecución de la consulta.

La página del informe también expone la consulta SQL directamente, por lo que puede 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 almacenar los cambios sin ejecutar. Deberá hacer clic en Actualizar para volver a ejecutar la consulta y actualizar todas las vistas con datos actuales.

   2. Guardar y ejecutar para aplicar la consulta actualizada de inmediato.

Tabla de datos

La sección Tabla de datos muestra los resultados de la consulta con el encabezado de la sección mostrando el recuento total de filas devuelto 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 completo de resultados como Excel (.xlsx) o CSV (.csv) independientemente de cuántas filas muestre la vista interactiva.

Si necesita ubicaciones en lugar de coordenadas en bruto, marque la casilla Geocodificar a dirección en la esquina superior derecha del Tabla de datos encabezado. Cuando está habilitado, resuelve las columnas de coordenadas en direcciones de calle legibles.

La resolución de direcciones supone una carga significativa para el servidor. Utilice 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 forma numérica.

Gráfico

La sección de Gráfico se renderiza debajo de la tabla de datos. Hereda la configuración que aplicó en el editor de informes, pero también puede ajustar la configuración de ejes directamente en la vista:

• Eje X: seleccione la columna que se trazará en el eje horizontal.

• Eje Y: seleccione la columna que se trazará en el eje vertical.

• Agrupar por: opcionalmente dividir series por una columna categórica, como object_label, para mostrar una línea o grupo de barras por separado por dispositivo.

El gráfico muestra un título auto-generado que describe la selección actual de ejes y agrupación, por ejemplo: speed over device_time (grouped by object_label). Cuando modifica la configuración de los ejes sin guardar, aparece un indicador de Cambios no guardados junto al botón Guardar configuración del gráfico . Haga clic en él para mantener los cambios de configuración en el informe.

Mapa de ubicación

La sección 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ática o manualmente); no es posible editarlas después. Si la consulta no devuelve columnas de coordenadas reconocidas, la sección muestra "No GPS coordinates detected in query results."

Para datos telemáticos con marca temporal, los puntos trazados representan la ruta completa de un objeto durante el período consultado.

El mapa es interactivo: acerque y desplace para inspeccionar puntos individuales. Haga clic en Mostrar todo para alejar y ajustar todos los puntos trazados dentro del área visible del mapa.

Exportar un informe

Dashboard Studio proporciona dos niveles de exportación.

Exportación de la tabla de datos

Use el 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 devueltos por la consulta, independientemente del límite de visualización en la vista interactiva.

Exportación completa del informe

Use los botones en el 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

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.

Editar y eliminar un informe

Para editar un informe guardado, ya no necesita un cuadro de diálogo de edición separado. Abra el informe 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 vez al crear el informe.

Para eliminar un informe, haga clic Herramientas en la barra lateral izquierda, 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, luego confirme la eliminación.