> 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/fr/dashboard-studio/creating-reports.md). # Création de Rapports Générez des rapports exportables avec des tableaux de données, des graphiques et des cartes de localisation coordonnés à partir d'une seule requête SQL. Exportez au format HTML, Excel ou PDF Les Rapports vous offrent une façon structurée d’analyser les données IoT Query à travers trois vues coordonnées à partir 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 et exportable plutôt que d’un canevas de tableau de bord libre. Les rapports SQL personnalisés s’adaptent instantanément à n’importe quelle question métier en ajustant les requêtes et les paramètres : * **Automatisation** fait gagner du temps en réutilisant des requêtes et en s’intégrant à des outils BI pour des mises à jour rapides. * **Analyse approfondie** est possible en combinant, agrégeant et segmentant des données provenant de plusieurs sources. * **Exactitude 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 mesures. Regardez cette vidéo pour vous familiariser avec la création de rapports dans l’interface de l’application Dashboard Studio : {% embed url="" %} Créer des 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 clé réside dans la structure des requêtes et de la sortie : | | 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 | Canevas par glisser-déposer | | Exporter | HTML, Excel, PDF | Schéma JSON, PDF | | Cas d’usage | 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é sous forme de 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 seul canevas, par exemple : combiner une tuile de statistiques de résumé de voyage, un graphique de Consommation de carburant et un tableau des visites de zone dans une seule vue. Pour plus de détails sur la création de tableaux de bord, voir [Création de tableaux de bord](/docs/analytics/fr/dashboard-studio/creating-dashboards.md). ## Comment créer un rapport {% stepper %} {% step %} #### Étape 1 : Ouvrir l’éditeur de rapports Dans la barre latérale gauche, cliquez sur **Outils**, puis sélectionnez **Nouveau rapport**. Dashboard Studio vous invite à choisir une section dans 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 : Saisir les informations de base L’éditeur s’ouvre avec deux champs en haut : * **Titre** (obligatoire) : le nom affiché dans le menu et les en-têtes d’export. * **Description** (facultatif) : contexte supplémentaire visible dans l’éditeur. {% endstep %} {% step %} #### Étape 3 : Rédiger la requête SQL 1. Cliquez sur le **Requête SQL** onglet et saisissez une instruction SELECT sur vos tables IoT Query. La requête définit les trois composants (tableau, graphique et carte), alors incluez 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 Sélectionner t.device_id, o.traceur_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 la vitesse entière mise à l’échelle en km/h t.speed::float / 100 AS speed, t.device_time FROM raw_telematics_data.Suivi_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 des 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 l’enregistrement si vous avez besoin de l’ensemble complet des données à télécharger. * 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’ **Composants** onglet. 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 Livre de recettes d’IoT Query contient des exemples de requêtes généraux et sectoriels prêts à l’emploi comme base pour les rapports. Voir [Livre de recettes SQL](/docs/analytics/fr/example-queries.md) pour la liste complète. {% endhint %} {% endstep %} {% step %} #### Étape 4 : Configurer les composants Cliquez sur le **Composants** onglet. Trois composants sont disponibles : **Table**, **Graphique**, et **Carte**. Chacun dispose d’un bouton permettant de l’inclure ou de l’exclure du rapport. Vous pouvez supprimer tout composant dont vous n’avez pas besoin. {% tabs %} {% tab title="Table 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’exportation, qui contient toujours l’ensemble complet des résultats. * **Afficher la ligne des totaux**: ajoute une ligne de synthèse en bas du tableau lorsqu’elle est activée. {% endtab %} {% tab title="Graphique" %} Deux types de graphiques sont disponibles : * **Série temporelle (courbe)**: adapté aux données représentées dans le temps. * **Graphique à barres**: adapté aux comparaisons catégorielles (également appelé 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 `niveau_de_Carburant`. * **Grouper par**: répartissez éventuellement les séries par une colonne catégorielle, telle que `traceur_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 **Détection automatique des colonnes GPS** si l'option est activée, les colonnes nécessaires pour définir l'emplacement (généralement `latitude` et `longitude`) sont sélectionnées automatiquement si votre requête les renvoie. Vous pouvez également désactiver la **Détection automatique** option et sélectionner manuellement les colonnes nécessaires. {% endtab %} {% endtabs %} {% endstep %} {% step %} #### Étape 5 : Enregistrer le rapport Cliquez sur Enregistrer. Le rapport apparaît dans la section du menu que vous avez sélectionnée à l'étape 1 et est accessible à tous les utilisateurs ayant 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 des données en direct provenant 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 chaque fois que vous en avez besoin. 1. Développez le **Requête SQL** section pour afficher ou modifier l'instruction en ligne. 2. Appliquez les modifications : 1. Cliquez **Enregistrer** pour enregistrer les modifications sans exécuter. Vous devrez cliquer sur **Rafraîchir** 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. ### Table de données Le **Table de données** section affiche les résultats de la requête, l'en-tête de section indiquant 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 **Télécharger** menu déroulant pour exporter l’ensemble du jeu de résultats au format Excel (.xlsx) ou CSV (.csv), quel que soit le nombre de lignes affichées par la vue interactive. Si vous avez besoin de lieux au lieu de coordonnées brutes, cochez la **Géocoder en adresse** case en haut à droite de l’ **Table de données** en-tête. 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 que vous avez appliqués dans l’éditeur de rapport, mais vous pouvez également ajuster directement la configuration des axes 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**: répartissez éventuellement les séries par une colonne catégorielle, telle que `traceur_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 et la sélection de regroupement actuels, par exemple : `vitesse selon device_time (regroupé par Traceur_label)`. Lorsque vous modifiez les paramètres de l’axe sans enregistrer, un **modifications non enregistrées** indicateur apparaît à côté du **Enregistrer les paramètres du graphique** bouton. Cliquez dessus pour conserver les modifications de configuration dans le rapport. ### Carte de localisation Le **Carte de localisation** La section affiche chaque ligne de requête sous forme d'un point à ses coordonnées GPS. L'en-tête de la section affiche 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'itinéraire complet d'un objet sur la période interrogée. {% hint style="info" %} La carte est interactive : zoomez et déplacez-vous pour inspecter des points individuels. Cliquez **Afficher tout** pour dézoomer et adapter tous les points tracés à la zone visible de la carte. {% endhint %} ## Exportation d'un rapport Dashboard Studio fournit deux niveaux d'export. ### Exportation du tableau de données Utilisez le **Télécharger** menu déroulant dans le **Table de données** section permettant d'exporter uniquement les données du tableau. L'export contient toujours l'ensemble complet des résultats renvoyés par la requête, quelle que soit la limite d'affichage dans la vue interactive. ### Export du rapport complet Utilisez les boutons dans 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 du composant. 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 **menu Édition**. 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 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, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/analytics/fr/dashboard-studio/creating-reports.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.