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:

Creación de informes en Dashboard Studio paso a paso

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.

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 la estructura de su menú compartido. 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 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:

Ejemplo de consulta básica de informe

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

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 la lista completa.

4

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.

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.

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.

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.

5

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.

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.

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.

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.

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.

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

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.

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.