User Guide
0 mins to read
Add-In Fuel Transaction Import (importation des transactions de carburant) v3.1.1
User Guide
0 mins to read
En savoir plus sur l'extension Importation des transactions de carburant, qui permet aux utilisateurs d’importer dans MyGeotab les transactions de pleins par l’application/le service du fournisseur de carburant. Ce document montre comment importer des transactions en utilisant trois options différentes : WEX, General Standard et Import Fuel Provider.
Pour toutes les versions de l’extension 4.x.x.
Mai 2023
Sommaire
Historique des révisions
Version | Date | Change |
1.0.0 | 30/12/2022 | Première publication pour cette version. |
1.0.1 | 09/03/2023 | Améliorations de la section sur le fichier de configuration. Améliorations des étapes d’importation des transactions de carburant. |
1.0.2 | 27/04/2023 | Ajout des sections Extension et Comment y accéder. Quelques améliorations générales. |
2.0 | 05/05/2023 | Mise à jour du style du document et du contenu pour respecter le guide de style. |
2.1 | 22/09/2023 | Mises à jour de la version 4.1.0, comme la modification de l’image du menu et de l’image d’importation. |
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.
Pour installer l’extension d’importation des transactions de carburant, accédez à MyGeotab, puis suivez les étapes ci-dessous :
{ "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.
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.
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 :
✱ REMARQUE : la première ligne est ignorée, car elle est supposée être une ligne d’en-tête.
✱ 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.
Il existe certaines conditions préalables à l’importation de transactions de carburant, notamment :
✱ 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.
Procédez comme suit pour importer les fichiers de transactions de carburant (reportez-vous à l’image ci-dessous).
✱ 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.