Pour toutes les versions de l’extension 4.x.x.

Avril 2024

Sommaire

Introduction

L’extension d’importation des transactions de carburant permet aux utilisateurs d’importer dans une base de données MyGeotab les transactions de pleins d’essence provenant d’un fournisseur de cartes de carburant.

Références

1. Le dépôt Git du fichier de configuration est fourni comme référence pour le fichier de configuration. Le dépôt doit fournir toutes les informations nécessaires pour configurer et faire fonctionner un nouveau fichier de configuration.

1. L’entité des transactions de carburant (SDK) fournit la structure d’objet back-end qui est appelée afin d’ajouter les données des transactions de carburant. Cela s’adresse aux utilisateurs qui ont un intérêt technique plus important pour les fondements de cet utilitaire.

Installation de l’extension

Pour installer l’extension d’importation des transactions de carburant, accédez à MyGeotab, puis suivez les étapes ci-dessous :

1. Allez à Administration > Système… > Paramètres du système.
2. Sur la page Paramètres du système, sélectionnez l’onglet Extensions, puis cliquez sur Nouvelle extension.
3. Dans la fenêtre contextuelle Extension, ajoutez la configuration suivante :

{  "url": "https://app.geotab.com/addins/geotab/addin-fuel-transaction-import/Manifest.json" }

Pour accéder à l’extension, sélectionnez Moteur & entretien > Fuel Transaction Import (Importation des transactions de carburant) dans le menu principal MyGeotab.

Comprendre le fichier de configuration

Le fichier de configuration représente le mappage de colonnes et les informations de configuration nécessaires pour exécuter avec succès une opération d’importation de transactions de carburant.

Consultez le dépôt du fichier de configuration GitHub pour comprendre la structure du fichier de configuration, ses propriétés et la façon de procéder à sa compilation correcte afin d’importer correctement les données des transactions de carburant dans le système de base de données MyGeotab.

Le fichier de configuration doit contenir le mappage de colonnes et la configuration attendus dans le processus d’importation. Il décrit le fichier d’importation Excel.

Un exemple de fichier de configuration et certaines instructions de formatage se trouvent dans le dépôt Git, par exemple, source.json.

L’objet JSON de data du fichier de configuration contient les champs de propriété de l’entité des transactions de carburant à importer et les références de colonnes.

Comprendre le fichier d’importation Excel

Le fichier d’importation Excel est une feuille de calcul Excel (XLS, XLSX) fournie par un fournisseur de cartes de carburant (ou un fichier personnalisé produit par un autre mécanisme) contenant les données de transaction des pleins d’essence à importer.

Le contexte du fichier d’importation Excel comprend :

1. Une ligne d’en-tête est attendue.

✱ REMARQUE : la première ligne est ignorée, car elle est supposée être une ligne d’en-tête.

2. Il doit y avoir au moins un champ d’identification du boîtier qui est une plaque d’immatriculation (licensePlate), le numéro VIN (vehicleIdentificationNumber) ou le numéro de série Geotab (serialNumber). Les champs Commentaires et Description seront également consultés pour les détails d’identification du boîtier si les options mentionnées précédemment ne permettent pas d’identifier un boîtier.

✱ REMARQUE : le nombre maximum de transactions qui seront importées par fichier d’importation est de 5 000. Par conséquent, raccourcissez vos fichiers d’importation si nécessaire pour qu’ils soient inférieurs à ce seuil.

Conditions préalables à l’importation de transactions de carburant

Il existe certaines conditions préalables à l’importation de transactions de carburant, notamment :

1. Un fichier de configuration correctement structuré.
2. Un fichier Excel contenant les transactions à importer.
3. Chaque transaction doit au moins identifier un boîtier en indiquant un numéro de série, un VIN (numéro d’identification des véhicules) ou une référence de plaque d’immatriculation afin d’identifier correctement le boîtier.

✱ REMARQUE : si un boîtier ne possède aucune des références d’identification, l’enregistrement sera tout de même importé, mais il sera orphelin et n’aura pas la possibilité de correspondre à un événement de plein d’essence réel.

Importation des fichiers de transactions de carburant

Procédez comme suit pour importer les fichiers de transactions de carburant (reportez-vous à l’image ci-dessous).

1. Pour sélectionner le fichier de configuration (JSON), cliquez sur Choose file (Choisir un fichier). (1)
2. Sélectionnez le fournisseur de carburant dans la liste déroulante Choisir un fournisseur. (2)
3. Pour choisir le fichier d’importation approprié (XLS ou XLSX), cliquez sur Choose file (Choisir un fichier). (3)
4. Si la feuille n’est pas la première dans le classeur, modifiez le Numéro de feuille. (4)
5. Sélectionnez le fuseau horaire concerné dans le menu déroulant Fuseau horaire de référence. Par défaut, il s’agit du fuseau horaire de votre profil utilisateur défini dans les options de MyGeotab. (5)
6. Cliquez sur Importer une fois les critères d’entrée remplis pour lancer le processus. (6)
7. Pour réinitialiser tous les champs d’entrée, cliquez sur Réinitialiser. (7)



8. La page affiche la progression du chargement lors de l’importation. Une fois cette opération terminée, la section Résumé de l’importation affiche un résumé des données importées, ignorées et des erreurs.

✱ REMARQUE : les transactions importées ne seront pas immédiatement répercutées dans le rapport de la page des pleins d’essence. Une mesure de post-traitement est requise pour faire correspondre ces transactions aux pleins d’essence à un stade ultérieur. En général, les transactions correspondantes s’affichent le jour suivant.

Questions fréquentes

Q : Combien de temps faut-il pour qu'une transaction soit associée à un événement de plein d’essence ?

Les transactions de carburant importées sont traitées à la fin de chaque journée et ne sont pas immédiatement reflétées dans la base de données. Il est possible de constater un décalage pouvant aller jusqu'à 24 heures.

Q : Quel est l'objectif du champ Fuseau horaire de référence ?

Le champ Fuseau horaire de référence vous permet de sélectionner un fuseau horaire autre que le fuseau horaire local actuel. En d'autres termes, vous pouvez importer des transactions de carburant d'autres fuseaux horaires ou de périodes différentes, telles que celles effectuées pendant l'heure d'été.

Annexe 1

Exemple de fichier de configuration

Reportez-vous à l’exemple de fichier de configuration, puis à l’explication qui suit.

Reportez-vous également à l’exemple de fichier d’importation Excel associé à cette configuration.

Capture d’écran du fichier example.json :

Capture d’écran de l’exemple de fichier d’importation Excel :

Exemples d’explications

Exemple décrivant chaque propriété et son paramètre associé/sa valeur associée.

Explication de FuelProviderExample1

Exemple de plusieurs fournisseurs de carburant

Pour voir comment un fichier de configuration contenant plusieurs fournisseurs de carburant est configuré, reportez-vous à ce lien.