# Enregistrer les données IoT dans un fichier CSV

Dans certains cas, les FST, les intégrateurs et les développeurs ont besoin de voir les données originales, non modifiées, provenant de leurs traceurs GPS. Ces données brutes sont souvent appelées « raw data ». L’examen des raw data leur permet d’approfondir leur compréhension des données collectées et d’obtenir une vision plus claire de leurs caractéristiques.

L’examen des raw data peut aussi réduire le temps nécessaire pour comprendre pourquoi les appareils ne fonctionnent pas correctement. Cela signifie que vous pouvez aider les utilisateurs à résoudre les problèmes plus rapidement, ce qui peut renforcer leur confiance dans votre produit. De plus, cela vous permet de consacrer davantage de temps à la création de nouvelles solutions pour vos clients.

En outre, les récentes avancées technologiques dans l’intelligence artificielle et le machine learning ouvrent de nouvelles façons d’utiliser ces données. Vous pouvez récupérer ces raw data et les utiliser dans d’autres systèmes (c.-à-d. CRM, ERP, etc.) pour effectuer davantage d’analyses ou dans d’autres domaines de votre entreprise. Cette méthode vous permet d’extraire les raw data en une seule étape, au lieu de collecter les données des appareils et des capteurs via différents appels API.

Approfondissons les « raw data ». En nous appuyant sur les précieux retours fournis par nos partenaires, ainsi que sur des expériences menées dans Navixy Lab, nous avons élaboré ci-dessous une définition concise.

{% hint style="info" %}
Les raw data analysées sont le résultat du décodage (parsing) des paquets de données entrants, en tenant compte du protocole et des spécificités du modèle de l’appareil source. Après décodage, le paquet est stocké sous forme de paramètres universels de la plateforme tels que latitude, longitude, can\_fuel\_liters, etc.
{% endhint %}

## Exportation des raw data

Dans le cadre de nos travaux de recherche et développement, nous avons créé un nouvel outil. Cet outil permet aux FST, aux intégrateurs, aux développeurs et même aux utilisateurs avancés d’obtenir les raw data analysées de n’importe lequel de leurs appareils. Ils peuvent collecter des données sur n’importe quels paramètres sur les 30 derniers jours au format CSV. Pour simplifier l’utilisation, nous avons ajouté une section d’exportation des raw data à l’interface utilisateur, sous « Devices and Settings ».

Nous avons choisi le format de fichier CSV pour sa simplicité et son usage courant. Il est facile à convertir en tableaux ou à fournir à des programmes utilisant l’intelligence artificielle ou le machine learning.

<figure><img src="/files/66291747a53185acfb2c9957871e59acce7cb67b" alt=""><figcaption><p>Exportation des raw data</p></figcaption></figure>

### Fonctionnalités de l’exportation des raw data

Examinons les fonctionnalités de ce nouvel outil :

* Il vous permet de télécharger des raw data analysées pour n’importe quel traceur GPS sur notre plateforme.
* Vous pouvez choisir n’importe quels paramètres parmi tous les modèles d’appareil disponibles à inclure dans votre fichier. De plus, vous pouvez sélectionner uniquement les paramètres utiles à votre tâche spécifique. Pour choisir les paramètres, vous pouvez facilement effectuer une recherche dans la liste des options disponibles pour le traceur GPS sélectionné.
* Il n’est pas nécessaire d’activer l’enregistrement des données avant de souhaiter les obtenir. Toutes les données de tous les appareils sont enregistrées automatiquement. Vous pouvez télécharger ces données quand vous le souhaitez.
* Vous pouvez accéder à jusqu’à 30 jours de raw data analysées pour n’importe quel traceur GPS.
* Pour les grands clients opérant dans différents pays et fuseaux horaires, nous avons facilité le travail avec les informations. L’outil peut adapter les horodatages des paquets au fuseau horaire que vous avez sélectionné.

## Cas d’utilisation typiques de l’exportation des raw data

Comme nous l’avons mentionné précédemment, ce nouvel outil est utile à toute personne utilisant des traceurs GPS. Voyons maintenant quelques-unes des façons dont vous pourriez l’utiliser.

### Analyse, machine learning et IA

Vous pouvez utiliser les données entrantes des traceurs GPS dans un format lisible par les machines. Ces données peuvent être transmises à l’intelligence artificielle ou au machine learning pour traitement. Les possibilités d’utilisation sont infinies. Par exemple, l’IA pourrait détecter et signaler lorsque les véhicules, leurs ressources et le carburant sont utilisés de manière incorrecte, ou elle pourrait créer des cartes de chaleur.

### Vérifications de configuration du traceur GPS

Vous pouvez vérifier comment vos traceurs sont configurés en consultant les données des paramètres. Vous pouvez voir si un paramètre est défini pour envoyer des données à la plateforme et si ses données sont reçues dans les paquets de l’appareil. Par exemple, s’il n’y a pas de données, cela signifie que le paramètre n’est pas configuré pour l’envoi ou que le capteur a été déconnecté de l’appareil GPS et envoie un code d’erreur ou aucune information du tout.

### Diagnostic des données des capteurs

Vous pouvez vérifier le fonctionnement du capteur en lisant les informations sans multiplicateurs ni tables d’étalonnage. Par exemple, si les contacts du capteur de carburant se sont oxydés, la plateforme peut recevoir des lectures déformées du niveau de carburant. Il est beaucoup plus difficile de repérer ces changements à l’aide de données étalonnées et de rapports de variation du niveau de carburant qu’avec des raw data. Les données téléchargées seront donc très utiles pour ajuster finement et corriger un fonctionnement incorrect. Elles peuvent également servir à recalibrer le capteur s’il affiche des données incorrectes.

### Diagnostic du déclenchement des règles

Vous pouvez vérifier comment les appareils traitent les événements en suivant les ID d’événement. Vous pouvez essayer de déclencher manuellement un événement et vérifier si la plateforme le déclenche et si l’appareil a envoyé des données à son sujet.

### Diagnostic d’un appareil hors ligne

Vous pouvez déterminer plus précisément pourquoi un appareil est hors ligne. Comme pour les autres cas, il s’agit d’une situation courante. Par exemple, si l’appareil a cessé d’apparaître sur la plateforme, l’exportation des raw data vous permet de voir quelles données relatives à la puissance du signal et au niveau de batterie interne et externe étaient envoyées à la plateforme avant la déconnexion. Il y a peut-être eu des événements de déconnexion, mais aucune règle n’a été créée. Sans cet outil, vous ne pourriez recueillir des informations sur la batterie externe que via un rapport, et pour les événements sans règle, vous devriez contacter le support. Désormais, vous pouvez suivre les relevés historiques de tous les paramètres en même temps afin d’identifier les causes possibles de la déconnexion de l’appareil ou de l’absence de réception des données de celui-ci.

### Solutions personnalisées pour les clients

Vous pouvez créer des solutions personnalisées pour vos clients. Par exemple, un client a souvent besoin de données analytiques sur différents relevés d’appareil dans un seul rapport. Désormais, vous pouvez le faire à l’aide des raw data de l’appareil. Vous pouvez également utiliser ces données dans Grafana ou PowerBi pour créer des analyses avancées.

## Comment utiliser l’exportation des raw data

Tout d’abord, vous devez vous rendre dans la section « devices and settings » et rechercher, dans l’interface utilisateur, l’appareil qui vous intéresse :

<figure><img src="/files/4f222abf69ce4bb9d97ea6b1a6a5d4a59ced126e" alt=""><figcaption><p>Interface utilisateur de l’onglet Devices and settings</p></figcaption></figure>

Ou bien, retrouvez les paramètres du traceur pour un appareil spécifique dans le panneau d’administration :

<figure><img src="/files/69ca7a4d29bf277311d317cff3aed1809056c69e" alt=""><figcaption><p>Paramètres du traceur - panneau d’administration</p></figcaption></figure>

Ensuite, cliquez sur le bouton « Export data » dans le **Raw data** bloc :

<figure><img src="/files/3bb39e338932a4a46d70acbd23e60f99c6406ee5" alt=""><figcaption></figcaption></figure>

Cela ouvrira l’outil « Raw data export ». Ici, vous devez choisir la plage de dates, le fuseau horaire et les paramètres que vous souhaitez inclure dans un fichier csv.

<figure><img src="/files/d4d3f198b5cfc597a1ac36d5980eb62e9c09981a" alt=""><figcaption><p>Fenêtre de l’outil d’exportation des raw data</p></figcaption></figure>

Nous avons veillé à ce que vous ne puissiez pas fermer accidentellement la fenêtre en cliquant en dehors de l’outil « Raw data export ». Vous ne pouvez la fermer qu’en cliquant sur le « X » dans le coin supérieur droit. De plus, si vous n’avez pas choisi un autre appareil ou actualisé la page, l’outil « Raw data export » mémorisera tous les paramètres que vous avez précédemment sélectionnés. Cela facilite la vérification des paramètres de n’importe quel traceur GPS ou capteur, le retour en arrière et la poursuite du travail.

### Choix de la plage de dates

Le processus est le même que lors de la création d’un historique de trajet. Vous pouvez choisir un maximum de 30 derniers jours.

Sélectionnez une plage de dates soit en cliquant sur le calendrier, soit en saisissant les dates manuellement. Vous pouvez également définir une heure précise. Voici quelques options pratiques pour choisir rapidement une période :

* Hier
* La semaine dernière
* Les 30 derniers jours

Lorsque vous cliquez dessus, la plateforme sélectionne automatiquement la plage appropriée.

<figure><img src="/files/23d670348c72c1fd48e9d15b7d509bc782363112" alt=""><figcaption><p>Sélecteur de plage de dates - exportation des raw data</p></figcaption></figure>

Pour vous faciliter la tâche, nous avons ajouté un compteur indiquant le nombre de jours sélectionnés. Si vous essayez de choisir une date remontant à plus de 30 jours, un message s’affichera. Le bouton de sélection ne sera pas disponible.

### Choix du fuseau horaire

Vous pouvez choisir le fuseau horaire dont vous avez besoin. Par exemple, si vous devez fournir des données pour l’IA ou le ML, qui nécessitent un seul et même fuseau horaire pour tous les messages, même si vous fournissez des services dans différents pays et fuseaux horaires.

Voici comment choisir le fuseau horaire souhaité :

* Sélectionnez-en un dans la liste de tous les fuseaux horaires possibles.
* Saisissez le nom du fuseau horaire.
* Saisissez le fuseau horaire, par exemple -8, +2, etc.

<figure><img src="/files/74b5e4d32cf7a367b226c133661bedba62f7ce30" alt=""><figcaption><p>Sélecteur de fuseau horaire - exportation des raw data</p></figcaption></figure>

### Sélection des paramètres

La liste des paramètres parmi lesquels vous pouvez choisir peut varier selon le modèle. Elle comprend tous les paramètres possibles intégrés à la plateforme pour chaque modèle. Vous pouvez sélectionner jusqu’à 1000 paramètres au total.

Voici ce que vous pouvez faire :

* Sélectionnez tous les paramètres en cliquant sur la case à cocher située à gauche de la recherche.
* Sélectionnez uniquement les paramètres dont vous avez besoin en cliquant sur la case à cocher située à gauche de chaque paramètre de la liste.
* Trouvez les paramètres dont vous avez besoin en saisissant leur nom ou une partie de leur nom.

S’il existe plus d’une entrée du même type, elles sont numérotées (2, 3, 4...). Dans ce cas, seule l’entrée ayant l’indice le plus élevé est renvoyée. Par exemple, si des AVL IO de 1 à 100000 sont disponibles pour un appareil, seul avl\_io\_100000 est renvoyé, bien que des AVL IO avec des indices plus faibles existent également.

Une fois que vous avez sélectionné un tel paramètre indice sur la droite, la plateforme vous demandera de préciser quels indices doivent être ajoutés au fichier. Saisissez une liste de nombres séparés par des virgules, ou définissez une plage de nombres à l’aide d’un tiret. Par exemple, 1-2, 4, 7.

Pour tous les paramètres et pour chaque paramètre indice, vous verrez un compteur indiquant combien vous en avez déjà choisis.

Chaque paramètre que vous choisissez ajoutera une colonne supplémentaire au fichier.

<figure><img src="/files/352ea40de69c65556372d1109cff62a4ecd21770" alt=""><figcaption><p>Sélection des paramètres de l’exportation des raw data</p></figcaption></figure>

## Téléchargement du fichier de raw data

Une fois que vous avez choisi tous les paramètres, cliquez sur le bouton « Download CSV » pour lancer le téléchargement. Vous pouvez ouvrir le fichier avec n’importe quel éditeur de texte ou visualiseur de tableaux. Ce fichier CSV utilise une virgule pour séparer les données.

Le nom du fichier comprend l’ID de l’appareil, le libellé du traceur et la plage de dates et d’heures dans le fuseau horaire.

Chaque ligne, à partir de la deuxième, correspond à un message envoyé par l’appareil à la plateforme. La première ligne affiche toujours l’heure du message dans le fuseau horaire sélectionné, et le reste correspond aux paramètres que vous avez sélectionnés.

<figure><img src="/files/a6c983d03ec67e1671f205258be09619af0a63df" alt=""><figcaption><p>Exemple de colonnes de raw data</p></figcaption></figure>

Pour plus d’informations sur la lecture et la compréhension du fichier de raw data [consultez notre prochain article](/docs/expert-center/fr/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file/columns-in-csv-file.md).

Nous espérons que ce nouvel outil s’avérera utile pour votre entreprise et vos clients. Il devrait vous permettre de créer de nombreuses nouvelles solutions à l’aide de fichiers de raw data. N’oubliez pas que même les plus petits détails peuvent mener à de grandes découvertes. Bonne exploration !


---

# 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/expert-center/fr/faq-and-troubleshooting/access-iot-data/save-iot-data-to-csv-file.md?ask=<question>
```

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.
