Création de rapports

Les rapports vous offrent un moyen structuré d'analyser les données IoT Query via trois vues coordonnées à partir d'une seule requête SQL : un tableau de données paginé, un graphique et une carte interactive. Utilisez des rapports lorsque vous avez besoin d'une sortie fixe et exportable plutôt que d'une surface de tableau de bord libre.

Les rapports SQL personnalisés s'adaptent instantanément à toute question métier en ajustant les requêtes et les paramètres :

• Automatisation gagne du temps en réutilisant les requêtes et en s'intégrant aux outils BI pour des mises à jour rapides.

• Analyse approfondie est possible en combinant, agrégant et segmentant des données provenant de multiples sources.

• Précision et pertinence sont assurées en travaillant directement avec des informations brutes et à jour de la base de données.

• Visualisations interactives permettent aux utilisateurs d'explorer les données de manière dynamique en ajustant les axes, les filtres et les métriques.

Regardez cette vidéo pour vous familiariser avec la création de rapports dans l'interface de l'application Dashboard Studio :

Création de rapports dans Dashboard Studio étape par étape

Rapports vs. tableaux de bord

Les rapports et les tableaux de bord exécutent tous deux des requêtes SQL contre votre base IoT Query et rendent les résultats sous forme de visualisations. La différence clé réside dans la manière dont les requêtes et la sortie sont structurées :

	Rapports	Tableaux de bord
Requêtes SQL	Une seule requête alimente toutes les vues	Chaque tuile possède sa propre requête
Mise en page	Fixe : tableau de données, graphique, carte de localisation	Zone de travail glisser-déposer
Export	HTML, Excel, PDF	Schéma JSON uniquement
Cas d'utilisation	Analyse exportable sur un seul jeu de données	Surveillance opérationnelle multi-panneaux

Utilisez des rapports lorsque un seul jeu de données doit être exploré sous forme de tableau, visualisé sous forme de graphique et cartographié simultanément, ou lorsque la sortie doit être exportée et partagée en dehors de Dashboard Studio. Utilisez des tableaux de bord lorsque vous avez besoin de plusieurs visualisations indépendantes sur une seule surface, par exemple : combiner une tuile de résumé de trajet, un graphique de consommation de carburant et un tableau de visites de zones dans une même vue.

Pour des détails sur la création de tableaux de bord, voir Création de tableaux de bord.

Comment créer un rapport

1

Étape 1 : Ouvrir l'éditeur de rapport

Dans la barre latérale gauche, cliquez sur Outils, puis sélectionnez Nouveau rapport.

Dashboard Studio vous invite à choisir une section dans votre structure de menu partagée. Sélectionnez une section existante ou choisissez Root pour placer le rapport au niveau supérieur.

2

Étape 2 : Saisir les informations de base

L'éditeur s'ouvre avec deux champs en haut :

• Titre (obligatoire) : le nom affiché dans le menu et dans les en-têtes d'exportation.

• Description (optionnelle) : contexte supplémentaire visible dans l'éditeur.

3

Étape 3 : Rédiger la requête SQL

1. Cliquez sur l'onglet SQL Query et saisissez une instruction SELECT contre vos tables IoT Query. La requête définit les trois composants (table, graphique et carte), donc incluez chaque colonne que vous avez l'intention d'utiliser dans toutes les vues, par exemple :

Exemple de requête de rapport de base

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

Quelques conseils pour la construction de requêtes :

• Ajoutez une clause LIMIT lors de la configuration du rapport. Elle réduit le temps d'exécution de la requête et accélère l'aperçu des composants. Supprimez-la ou augmentez-la avant d'enregistrer si vous avez besoin que l'ensemble complet des données soit disponible en téléchargement.

• Après avoir rédigé la requête, vous pouvez cliquer sur Detect Columns pour vérifier quelles colonnes sont réellement récupérées par cette requête. Cela aide à configurer les sélecteurs de colonnes dans l'onglet Components . Cette étape est optionnelle. Vous pouvez configurer les composants manuellement, mais l'exécuter d'abord simplifie la sélection des axes et des champs.

• Toute requête SQL utilisée dans un panneau de tableau de bord est un point de départ valide pour un rapport. Copiez la requête depuis un panneau et ajustez-la pour qu'elle corresponde à l'objectif du rapport. Par exemple, ajoutez des colonnes nécessaires pour la carte de localisation, ou supprimez des agrégations qui ne s'appliquent pas à une vue en tableau.

• Le Recipe Book d'IoT Query contient des exemples de requêtes génériques et spécifiques à l'industrie prêts à être utilisés comme base pour des rapports. Voir SQL Recipe Book pour la liste complète.

4

Étape 4 : Configurer les composants

Cliquez sur l'onglet Components onglet. Trois composants sont disponibles : Table, Chart, et Map. Chacun dispose d'un interrupteur pour l'inclure ou l'exclure du rapport. Vous pouvez supprimer tout composant dont vous n'avez pas besoin.

Tableau de données

Le tableau de données affiche les résultats de la requête en lignes paginées.

• Taille de page : définit le nombre de lignes affichées par page dans la vue interactive. Cela n'affecte pas l'exportation, qui contient toujours l'ensemble complet des résultats.

• Afficher la ligne Totaux : ajoute une ligne récapitulative en bas du tableau lorsqu'elle est activée.

Chart

Carte de localisation

5

Étape 5 : Enregistrer le rapport

Cliquez sur Enregistrer. Le rapport apparaît dans la section de menu que vous avez sélectionnée à l'étape 1 et est accessible à tous les utilisateurs qui ont accès à cette section.

Consultation d'un rapport

Après avoir créé un rapport, il s'ouvre immédiatement. Vous verrez tous les composants configurés rendus avec des données en direct de votre base IoT Query. L'en-tête du rapport affiche l'horodatage de la dernière mise à jour, le nombre total de lignes et le temps d'exécution de la requête.

La page du rapport expose également la requête SQL directement, afin que vous puissiez la mettre à jour quand vous en avez besoin.

1. Développez la section SQL Query pour afficher ou modifier la requête en ligne.

2. Appliquer les modifications :

   1. Cliquez sur Save pour enregistrer les modifications sans exécution. Vous devrez cliquer sur Refresh pour réexécuter la requête et mettre à jour toutes les vues avec les données actuelles.

   2. Save & Run pour appliquer la requête mise à jour immédiatement.

Tableau de données

La section Data Table affiche les résultats de la requête avec l'en-tête de section affichant le nombre total de lignes renvoyées par la requête. La vue interactive n'affiche qu'un nombre limité de lignes, le pied de page confirme le nombre exact. Utilisez le menu déroulant Download pour exporter l'ensemble complet des résultats sous forme d'Excel (.xlsx) ou CSV (.csv) indépendamment du nombre de lignes affichées dans la vue interactive.

Si vous avez besoin d'adresses plutôt que de coordonnées brutes, cochez la case Geocode to address dans le coin supérieur droit de l'en-tête. Data Table Lorsqu'elle est activée, elle résout les colonnes de coordonnées en adresses de rue lisibles.

La résolution d'adresses impose une charge significative sur le serveur. Utilisez cette option uniquement avec des ensembles de données agrégés ou filtrés. Pour des données télématiques brutes comportant des dizaines de milliers de lignes, conservez les coordonnées sous forme numérique.

Chart

La section Graphique s'affiche sous le tableau de données. Elle hérite des paramètres que vous avez appliqués dans l'éditeur de rapport, mais vous pouvez aussi ajuster la configuration des axes directement dans la vue :

• Axe X : sélectionnez la colonne à tracer sur l'axe horizontal.

• Axe Y : sélectionnez la colonne à tracer sur l'axe vertical.

• Regrouper par : divisez éventuellement les séries par une colonne catégorielle, telle que object_label, pour afficher une ligne ou un groupe de barres distinct par appareil.

Le graphique affiche un titre généré automatiquement décrivant la sélection actuelle des axes et du regroupement, par exemple : vitesse sur device_time (groupé par object_label). Lorsque vous modifiez les paramètres d'axe sans enregistrer, un indicateur Unsaved changes apparaît à côté du bouton Save Chart Settings . Cliquez dessus pour conserver les modifications de configuration dans le rapport.

Carte de localisation

La section La section Location Map

affiche chaque ligne de la requête comme un point à ses coordonnées GPS. L'en-tête de section indique le nombre de points tracés. Les colonnes GPS sont définies lors de la création du rapport (automatiquement ou manuellement), il n'est pas possible de les modifier par la suite. Si la requête ne renvoie aucune colonne de coordonnées reconnue, la section affiche "No GPS coordinates detected in query results."

Pour les données télématiques horodatées, les points tracés représentent le trajet complet d'un objet sur la période interrogée. La carte est interactive : effectuez un zoom et un panoramique pour inspecter les points individuels. Cliquez sur Show all

pour dézoomer et adapter tous les points tracés dans la zone visible de la carte.

Exportation d'un rapport

Dashboard Studio propose deux niveaux d'exportation.

Exportation du tableau de données Download Utilisez le menu déroulant à l'intérieur de la section Data Table pour exporter uniquement les données du tableau. L'exportation contient toujours l'ensemble complet des résultats renvoyés par la requête, indépendamment de la limite d'affichage dans la vue interactive.

Exportation complète du rapport

Utilisez les boutons dans l'en-tête du rapport pour exporter tous les composants ensemble.

Bouton	Sortie
Excel → Excel (.xlsx)	Feuille de calcul contenant le tableau de données complet
Excel → CSV (.csv)	Fichier de valeurs séparées par des virgules contenant le tableau de données complet
HTML	Fichier interactif contenant le tableau de données, le graphique et la carte de localisation
PDF	Document statique contenant le tableau de données, le graphique et la carte de localisation

Le fichier HTML exporté préserve l'interactivité : le graphique prend en charge les info-bulles au survol et la carte de localisation prend en charge le zoom et le panoramique.

Modifier et supprimer un rapport

Pour modifier un rapport enregistré, vous n'avez plus besoin d'une boîte de dialogue d'éditeur séparée. Ouvrez le rapport depuis le menu et modifiez la requête SQL ou les paramètres des composants directement dedans. La seule exception concerne les colonnes de localisation, elles sont définies une fois lors de la création du rapport.

Pour supprimer un rapport, cliquez sur Outils dans la barre latérale gauche, puis sélectionnez Edit menu. Localisez le rapport dans l'arborescence du menu et cliquez sur le menu à trois points à côté de son nom, puis confirmez la suppression.