> 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éer des 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 en HTML, Excel ou PDF Les rapports vous offrent une manière structurée d'analyser les données 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'une sortie fixe, exportable, plutôt que d'une toile 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** fait gagner du temps en réutilisant les requêtes et en s'intégrant à des outils BI pour des mises à jour rapides. * **Analyse approfondie** est possible en combinant, en agrégeant et en 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 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éer des rapports dans Dashboard Studio pas à pas {% endembed %} ## Rapports vs. tableaux de bord Les rapports et les tableaux de bord exécutent 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 façon 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 | Toile en glisser-déposer | | Export | HTML, Excel, PDF | Schéma JSON, PDF | | Cas d'utilisation | Analyse exportable sur un seul jeu de données | Surveillance opérationnelle multipanneau | 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 la sortie doit être exportée et partagée hors de Dashboard Studio. Utilisez les tableaux de bord lorsque vous avez besoin de plusieurs visualisations indépendantes sur une seule toile, par exemple : en combinant une tuile de statistiques récapitulatives du trajet, 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, consultez [Créer des tableaux de bord](/docs/analytics/fr/dashboard-studio/creating-dashboards.md). ## 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 Racine 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** (facultative) : contexte supplémentaire visible dans l'éditeur. {% endstep %} {% step %} #### Étape 3 : Rédiger 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), donc incluez toutes les colonnes que vous comptez 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.traceur_label, -- Convertir les 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.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 créer des 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 du composant. Supprimez ou augmentez la limite avant d'enregistrer si vous avez besoin de l'ensemble de données complet disponible au téléchargement. * Après avoir écrit la requête, vous pouvez cliquer **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. L'é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 pour qu'elle corresponde à 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 tableau. * Le livre de recettes d'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. 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 l'onglet **Composants** onglet. Trois composants sont disponibles : **Tableau**, **Graphique**, et **Carte**. Chacun d'eux dispose d'un bouton de bascule pour l'inclure ou 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 requête dans des lignes paginées. * **Taille de page**: définit le nombre de lignes affichées par page dans l’affichage interactif. Cela n’affecte pas l’export, qui contient toujours l’ensemble complet des résultats. * **Afficher la ligne des totaux**: ajoute une ligne récapitulative en bas du tableau lorsqu’elle est activée. {% endtab %} {% tab title="Graphique" %} Deux types de graphiques sont disponibles : * **Série chronologique (ligne)**: 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, comme la vitesse ou `niveau_de_carburant`. * **Groupe par** : diviser éventuellement les séries selon une colonne catégorielle, par exemple `libellé du Traceur`, pour 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 des 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** le bouton bascule est activé, 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 de détection automatique** 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 qui ont accès à cette section. {% endstep %} {% endstepper %} ## Consulter 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 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 affiche également directement la requête SQL, afin que vous puissiez la mettre à jour dès que nécessaire. 1. Développez la **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 **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 Le **Tableau de données** la section affiche les résultats de la requête, 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 **Télécharger** menu déroulant pour exporter l’ensemble des 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 d’emplacements au lieu de coordonnées brutes, cochez la **Géocoder en adresse** case située en haut à droite de l’ **Tableau de données** en-tête. Lorsqu’elle est activée, elle convertit les colonnes de coordonnées en adresses de rue lisibles. {% hint style="warning" %} La résolution des adresses impose une charge importante au serveur. N’utilisez cette option qu’avec des jeux 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. {% 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 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. * **Groupe par** : diviser éventuellement les séries selon une colonne catégorielle, par exemple `libellé du Traceur`, pour 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 le regroupement actuellement sélectionnés, par exemple: `vitesse sur device_time (regroupée par object_label)`. Lorsque vous modifiez les paramètres de l'axe sans enregistrer, un **Modifications non enregistrées** l’indicateur apparaît à côté du **Enregistrer les paramètres du graphique** Bouton. Cliquez dessus pour conserver les modifications de configuration dans le rapport. Quand **Groupe par** divise le graphique en groupes, le graphique trace les 10 premiers groupes. Pour choisir d'autres groupes, cliquez **Groupes**, qui indique combien de groupes sont tracés sur le total. Dans la liste, cliquez sur un groupe pour le tracer ou le retirer du graphique. Pour trouver un groupe, recherchez-le par son nom. Les lignes sans valeur dans la **Groupe par** colonne n'appartiennent à aucun groupe, et le graphique les exclut. **Tout sélectionner** et **Effacer** s'appliquent aux groupes qui correspondent à la recherche. **Tout sélectionner** n'est pas disponible lorsqu'il faudrait tracer plus de 1,000 groupes au total. La liste affiche jusqu'à 100 groupes qui ne sont pas tracés, alors recherchez les autres. Pour revenir aux 10 premiers groupes, cliquez sur **Réinitialiser par défaut**. Dashboard Studio n'enregistre pas la sélection des groupes. La sélection est réinitialisée lorsque vous ouvrez à nouveau le rapport ou sélectionnez une autre **Groupe par** colonne. ### Carte de localisation Le **Carte de localisation** La section affiche chaque ligne de requête sous forme de point à ses coordonnées GPS. L'en-tête de la 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 le parcours complet d'un objet sur la période requêtée. {% hint style="info" %} La carte est interactive : zoomez et faites un panoramique 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 %} ## Exporter un rapport Dashboard Studio propose deux niveaux d'export. ### Export du tableau de données Utilisez la **Télécharger** liste déroulante dans la **Tableau de données** section pour 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 de la vue interactive. ### Export complet 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 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 | Le graphique dans un fichier HTML ou PDF trace les mêmes groupes que le graphique à l'écran. Lorsque le graphique ne trace qu'une partie des groupes, le fichier indique le nombre de groupes tracés et le nombre total de groupes. {% 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 panoramique. {% 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-y 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 à la création du rapport. Pour supprimer un rapport, cliquez **Outils** dans la barre latérale gauche, puis sélectionnez **le menu d'édition**. Localisez 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.