# Création de rapports Les rapports vous offrent un moyen structuré d’analyser les données de IoT Query à travers trois vues coordonnées issues d’une seule requête SQL : un tableau de données paginé, un graphique et une carte interactive. Utilisez les rapports lorsque vous avez besoin d’un résultat fixe, exportable, plutôt que d’un canevas 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** permet de gagner du temps en réutilisant des requêtes et en s’intégrant à des outils BI pour des mises à jour rapides. * **L’analyse approfondie** est possible en combinant, agrégant et segmentant des données provenant de plusieurs sources. * **Précision et pertinence** sont garanties 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 : {% embed url="" %} Création de rapports dans Dashboard Studio, étape par étape {% endembed %} ## Rapports vs tableaux de bord Les rapports et les tableaux de bord exécutent tous deux des requêtes SQL sur votre base de données IoT Query et affichent les résultats sous forme de visualisations. La différence essentielle 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 a sa propre requête | | Disposition | Fixe : tableau de données, graphique, carte de localisation | Zone de travail par glisser-déposer | | Exporter | 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 les rapports lorsqu’un seul jeu de données doit être exploré sous forme de tableau, visualisé comme un graphique et cartographié simultanément, ou lorsque le résultat doit être exporté et partagé en dehors de Dashboard Studio. Utilisez les tableaux de bord lorsque vous avez besoin de plusieurs visualisations indépendantes sur un même canevas, par exemple : combiner une tuile de statistique récapitulative de trajet, un graphique de consommation de carburant et un tableau des visites de zones dans une seule vue. Pour plus de détails sur la création de tableaux de bord, consultez [Création de tableaux de bord](/docs/analytics/fr/dashboard-studio/creating-dashboards.md). ## Comment créer un rapport {% stepper %} {% step %} #### Étape 1 : Ouvrez 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 de la structure de menu partagée. Sélectionnez une section existante ou choisissez Root pour placer le rapport au niveau supérieur. {% endstep %} {% step %} #### Étape 2 : Saisissez 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’export. * **Description** (facultatif) : un contexte supplémentaire visible dans l’éditeur. {% endstep %} {% step %} #### Étape 3 : Rédigez la requête SQL 1. Cliquez sur l’onglet **Requête SQL** et saisissez une instruction SELECT sur vos tables IoT Query. La requête définit les trois composants (tableau, graphique et carte) ; incluez donc chaque colonne que vous prévoyez d’utiliser dans toutes les vues, par exemple : {% code title="Exemple de requête de rapport de base" expandable="true" %} ```sql SELECT t.device_id, o.object_label, -- Convertir des coordonnées entières mises à l’échelle en degrés décimaux t.latitude::float / 10000000 AS latitude, t.longitude::float / 10000000 AS longitude, -- Convertir une vitesse entière mise à l’échelle en 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" %} #### Quelques conseils pour la construction de requêtes : * Ajoutez une clause LIMIT pendant la configuration du rapport. Cela réduit le temps d’exécution de la requête et accélère l’aperçu des composants. Supprimez ou augmentez la limite avant d’enregistrer si vous avez besoin que l’ensemble complet des données soit disponible au téléchargement. * Après avoir rédigé la requête, vous pouvez cliquer sur **Détecter les colonnes** pour vérifier quelles colonnes sont réellement récupérées avec cette requête. Cela aide à configurer les sélecteurs de colonnes dans l’onglet **Composants** . Cette étape est facultative. 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 constitue un point de départ valide pour un rapport. Copiez la requête d’un panneau et adaptez-la à l’objectif du rapport. Par exemple, en ajoutant les colonnes nécessaires à la carte de localisation, ou en supprimant les agrégations qui ne s’appliquent pas à une vue tabulaire. * Le Recipe Book de IoT Query contient des exemples de requêtes généraux et spécifiques à l’industrie, prêts à être utilisés comme base pour les rapports. Consultez [SQL Recipe Book](/docs/analytics/fr/example-queries.md) pour la liste complète. {% endhint %} {% endstep %} {% step %} #### Étape 4 : Configurez les composants Cliquez sur l’onglet **Composants** onglet. Trois composants sont disponibles : **Tableau**, **Graphique**, et le **Carte**. Chacun dispose d’un interrupteur permettant de l’inclure ou de l’exclure du rapport. Vous pouvez supprimer tout composant dont vous n’avez pas besoin. {% tabs %} {% tab title="Tableau de données" %} Le tableau de données affiche les résultats de la requête sous forme de 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’export, qui contient toujours l’ensemble complet des résultats. * **Afficher la ligne des totaux**: ajoute une ligne de résumé en bas du tableau lorsqu’elle est activée. {% endtab %} {% tab title="Graphique" %} Deux types de graphiques sont disponibles : * **Série temporelle (ligne)**: adaptée aux données tracées dans le temps. * **Histogramme**: adaptée aux comparaisons catégorielles (également appelée graphique en colonnes). Configurez les axes : * **Colonne de l’axe X**: généralement une colonne temporelle telle que `device_time`. * **Colonnes de l’axe Y**: une ou plusieurs colonnes numériques, telles que la vitesse ou `fuel_level`. * **Grouper par**: vous pouvez éventuellement répartir les séries selon une colonne catégorielle, telle que `object_label`, afin d’afficher une ligne ou un groupe de barres distinct par appareil. {% endtab %} {% tab title="Carte de localisation" %} La carte de localisation trace les points de données à l’aide de coordonnées GPS. Dashboard Studio peut détecter automatiquement les colonnes de latitude et de longitude à partir du résultat de votre requête. Lorsque l’option **Détection automatique des colonnes GPS** est activée, les colonnes nécessaires pour définir la localisation (généralement `latitude` et `longitude`) sont sélectionnées automatiquement si votre requête les renvoie. Vous pouvez également désactiver l’option **Détection automatique** et sélectionner manuellement les colonnes nécessaires. {% endtab %} {% endtabs %} {% endstep %} {% step %} #### Étape 5 : Enregistrez 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. {% endstep %} {% endstepper %} ## Affichage d’un rapport Après avoir créé un rapport, il s’ouvre immédiatement. Vous verrez tous les composants configurés rendus avec les données en direct de votre base de données 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 directement la requête SQL, afin que vous puissiez la mettre à jour à tout moment. 1. Développez la **Requête SQL** section pour afficher ou modifier l’instruction en ligne. 2. Appliquez les modifications : 1. Cliquez **Enregistrer** pour stocker les modifications sans exécuter. Vous devrez cliquer sur **Actualiser** pour réexécuter la requête et mettre à jour toutes les vues avec les données actuelles. 2. **Enregistrer et exécuter** pour appliquer immédiatement la requête mise à jour. ### Tableau de données La **Section Tableau de données** affiche les résultats de la requête, l’en-tête de section montrant 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 **Télécharger** pour exporter l’ensemble complet des résultats au format Excel (.xlsx) ou CSV (.csv), quel que soit le nombre de lignes affichées dans la vue interactive. Si vous avez besoin d’emplacements au lieu de coordonnées brutes, cochez la case **Géocoder en adresse** dans le coin supérieur droit de l’en-tête **Section Tableau de données** . Lorsqu’elle est activée, elle convertit les colonnes de coordonnées en adresses postales lisibles. {% hint style="warning" %} La résolution des adresses impose une charge importante sur le serveur. Utilisez cette option uniquement avec des jeux de données agrégés ou filtrés. Pour les données télématiques brutes comportant des dizaines de milliers de lignes, conservez les coordonnées sous forme numérique. {% endhint %} ### Graphique La section Graphique s’affiche sous le tableau de données. Elle hérite des paramètres appliqués dans l’éditeur de rapport, mais vous pouvez également 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. * **Grouper par**: vous pouvez éventuellement répartir les séries selon une colonne catégorielle, telle que `object_label`, afin d’afficher une ligne ou un groupe de barres distinct par appareil. Le graphique affiche un titre généré automatiquement décrivant l’axe actuel et la sélection de regroupement, par exemple : `speed over device_time (grouped by object_label)`. Lorsque vous modifiez les paramètres des axes sans enregistrer, un indicateur **Modifications non enregistrées** apparaît à côté du bouton **Enregistrer les paramètres du graphique** . Cliquez dessus pour conserver les modifications de configuration dans le rapport. ### Carte de localisation La **Section Carte de localisation** affiche chaque ligne de requête sous forme de 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 ensuite. Si la requête ne renvoie aucune colonne de coordonnées reconnue, la section affiche « Aucune coordonnée GPS détectée dans les résultats de la requête. » Pour les données télématiques horodatées, les points tracés représentent l’intégralité du trajet d’un objet sur la période requise. {% hint style="info" %} La carte est interactive : zoomez et déplacez-vous pour inspecter les points individuels. Cliquez sur **Tout afficher** pour dézoomer et faire tenir tous les points tracés dans la zone visible de la carte. {% endhint %} ## Exportation d’un rapport Dashboard Studio fournit deux niveaux d’exportation. ### Exportation du tableau de données Utilisez le menu déroulant **Télécharger** dans la section **Section Tableau de données** pour exporter uniquement les données du tableau. L’export contient toujours l’ensemble complet des résultats renvoyés par la requête, quel que soit le nombre de lignes affichées dans la vue interactive. ### Exportation du rapport complet Utilisez les boutons de l’en-tête du rapport pour exporter tous les composants ensemble. | Bouton | Sortie | | --------------------- | --------------------------------------------------------------------------------------- | | Excel → Excel (.xlsx) | Feuille de calcul avec le tableau de données complet | | Excel → CSV (.csv) | Fichier de valeurs séparées par des virgules avec le tableau de données complet | | HTML | Fichier interactif avec le tableau de données, le graphique et la carte de localisation | | PDF | Document statique avec le tableau de données, le graphique et la carte de localisation | {% hint style="info" %} Le fichier HTML exporté conserve l’interactivité : le graphique prend en charge les info-bulles au survol et la carte de localisation prend en charge le zoom et le déplacement. {% endhint %} ## Modifier et supprimer un rapport Pour modifier un rapport enregistré, vous n’avez plus besoin d’une boîte de dialogue d’édition séparée. Ouvrez le rapport depuis le menu et modifiez directement la requête SQL ou les paramètres des composants. La seule exception concerne les colonnes de localisation : elles sont définies une seule fois lors de la création du rapport. Pour supprimer un rapport, cliquez sur **Outils** dans la barre latérale gauche, puis sélectionnez **Modifier le menu**. Repérez le rapport dans l’arborescence du menu et cliquez sur le menu à trois points à côté de son nom, puis confirmez la suppression. --- # Agent Instructions: 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/fr/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.