Fuel Transaction Import Add-In v3.1.0 (Add-In Importazione transazioni carburante v3.1.0)
User Guide
0 mins to read
Ulteriori informazioni sul componente aggiuntivo per l'importazione delle transazioni di carburante, che consente agli utenti di importare in MyGeotab le transazioni di rifornimento estratte dall'applicazione/servizio del fornitore di carburante. Questo documento mostra come importare le transazioni utilizzando tre diverse opzioni: WEX, Standard generale e Importazione del fornitore di carburante.
Valida per tutte le versioni dell'Add-In 4.x.x
Aprile 2024
Sommario
Introduzione
L'Add-In Fuel Transaction Import consente agli utenti di importare, nel database MyGeotab, le transazioni per il rifornimento di carburante effettuate mediante la carta carburante.
Riferimenti
- Il file di configurazione git repo viene fornito come riferimento per la compilazione del file di configurazione. L'archivio deve contenere tutte le informazioni necessarie per impostare e utilizzare un nuovo file di configurazione.
- L'entità delle transazioni di carburante (SDK) fornisce la struttura degli oggetti di backend che viene richiamata all'aggiunta dei dati della transazione. Si tratta di un'informazione utile per gli utenti che hanno maggiori competenze tecniche e desiderano conoscere gli elementi alla base di questa utilità.
Installazione dell'Add-In
Per installare l'Add-In Fuel Transaction Import, accedere a MyGeotab, quindi attenersi alla seguente procedura:
- Andare ad Amministrazione > Sistema… > Impostazioni del sistema.
- Nella pagina Impostazioni del sistema, selezionare la scheda Add-In e fare clic su Nuovo Add-In.
- Nella finestra popup Add-In, aggiungere la seguente configurazione:
{ "url": "https://app.geotab.com/addins/geotab/addin-fuel-transaction-import/Manifest.json" }
Per accedere all'Add-In, selezionare Motore e manutenzione > Fuel Transaction Import dal menu principale di MyGeotab.
Panoramica sul file di configurazione
Il file di configurazione include la mappatura delle colonne e le informazioni di configurazione necessarie per eseguire correttamente un'operazione di importazione delle transazioni di carburante.
Consultare l'archivio dei file di configurazione GitHub per comprendere la struttura del file di configurazione, le sue proprietà e le corrette modalità di compilazione per l'importazione dei dati all'interno del sistema del database MyGeotab.
Il file di configurazione deve includere la mappatura delle colonne e la configurazione prevista nel processo di importazione; descrive inoltre il file di importazione Excel.
Un file di configurazione campione e alcune istruzioni di formattazione sono riportati nel file git repo, ad esempio il file source.json.
L'oggetto di JSON data nel file di configurazione contiene i campi di proprietà dell' entità delle transazioni di carburante da importare e i relativi riferimenti di colonna.
Panoramica sul file di importazione Excel
Il file di importazione Excel è un foglio di calcolo in formato Excel (XLS, XLSX) assegnato da un fornitore di carte carburante (o un file personalizzato creato attraverso un altro meccanismo) contenente i dati delle transazioni del rifornimento da importare.
Di seguito riportiamo alcuni contesti relativi al file di importazione Excel:
- È necessaria una riga di intestazione.
✱ NOTA: la prima riga viene saltata in quanto si presume sia una riga di intestazione.
- È necessario specificare almeno un campo di identificazione del dispositivo: una targa (licencePlate), un numero VIN (vehicleIdentificationNumber) o un numero di serie Geotab (serialNumber). Se le opzioni menzionate in precedenza non consentono di individuare il dispositivo, la ricerca verrà estesa ai campi Commenti e Descrizione.
✱ NOTA: il numero massimo di transazioni importabili in un file è pari a 5000, quindi, se necessario, è consigliabile troncare i file di importazione prima di raggiungere la suddetta soglia.
Prerequisiti per l'importazione delle transazioni di carburante
Esistono alcuni prerequisiti per l'importazione delle transazioni relative al carburante, tra cui:
- Un file di configurazione strutturato correttamente.
- Un file Excel contenente le transazioni da importare.
- Ogni transazione deve identificare almeno un dispositivo attraverso il numero di serie, il numero VIN (numero identificativo del veicolo) o il numero di targa.
✱ NOTA: se un dispositivo non dispone di alcun riferimento di identificazione, il record verrà comunque importato, ma sarà orfano e non verrà associato a eventi di rifornimento effettivi.
Importazione dei file delle transazioni di carburante
Per importare i file delle transazioni di carburante, attenersi alla seguente procedura (fare riferimento all'immagine seguente).
- Per selezionare il file di configurazione (JSON), selezionare il pulsante Choose File (Scegliere file). (1)
- Selezionare il fornitore di carburante dal menu a discesa Scegliere il fornitore. (2)
- Per scegliere il file di importazione corretto (XLS o XLSX), selezionare il pulsante Choose File (Scegliere file). (3)
- Se il foglio desiderato non è il primo nella cartella di lavoro, modificare il numero del foglio. (4)
- Scegliere il fuso orario corretto selezionando il menu a discesa Fuso orario di riferimento. Per impostazione predefinita, il fuso orario corrisponde a quello del profilo utente impostato nelle opzioni di MyGeotab. (5)
- Selezionare il pulsante Importare al termine dell'immissione, per avviare il processo. (6)
- Per ripristinare il valore iniziale dei campi, premere il pulsante Ripristinare. (7)
- Durante l'importazione, la pagina mostra lo stato di avanzamento del caricamento. Al termine dell'operazione, nella sezione Riepilogo importazioni viene visualizzato un riepilogo degli errori importati e ignorati.
✱ NOTA: le transazioni importate non sono immediatamente visibili nel report disponibile alla pagina dei rifornimenti di carburante. In una fase successiva verrà eseguito un processo di post-elaborazione, che associa le transazioni agli eventi di rifornimento. In genere, le transazioni finali sono disponibili il giorno successivo.
Domande frequenti
D: Quanto tempo occorre affinché una transazione venga associata a un evento di rifornimento?
Le transazioni relative al carburante vengono elaborate alla fine di ogni giorno e non compaiono immediatamente nel database. È opportuno considerare sempre un ritardo massimo di 24 ore.
D: Qual è lo scopo del campo Fuso orario di riferimento?
Il campo Fuso orario di riferimento consente di selezionare un fuso orario diverso da quello corrente. In altre parole, è possibile importare transazioni relative ad altri fusi orari o per intervalli di tempo diversi, ad esempio in caso di transazioni avvenute durante l'ora legale.
Appendice 1
Esempio di file di configurazione
Fare riferimento a questo file di configurazione di esempio e alla seguente spiegazione.
Fare riferimento anche al file di importazione Excel di esempio associato a questa configurazione.
Schermata del file example.json:
Screenshot del file di importazione Excel di esempio:
Spiegazioni di esempio
Esempio che descrive ciascuna proprietà e relativi impostazioni/valori associati.
Spiegazione FuelProviderExample1
Proprietà | Impostazione/valore | Spiegazione | ||
Name | FuelProviderExample1 | La proprietà nome che identifica la configurazione. Si tratta del valore selezionato nel menu a discesa Fornitore carburante nell'add-in dopo aver selezionato la configurazione nel campo precedente (Selezionare il file di configurazione (JSON):). | ||
unitVolumeLiters | Y | Questa opzione indica se il volume di carburante è definito in unità metriche o imperiali. Impostare su Y per il sistema metrico (litri) e su N per il sistema imperiale (galloni). | ||
unitOdoKm | Y | Questa opzione indica se il contachilometri è definito in unità metriche o imperiali. Impostare su Y per il sistema metrico (chilometri) e su N per il sistema imperiale (miglia). | ||
isCellDateType | N | Questa opzione indica se la colonna del file di importazione contenente la data è formattata come tipo di data o come valore generale (testo). Impostare su Y per il tipo di data e su N per il testo. | ||
dateFormat | dd/MM/yyyy | Il formato di data previsto nel file della transazione, basato sulla definizione della tabella luxon di formattazione dei token. | ||
timeFormat | empty | N/D - vuoto | ||
currencyCodeMapped | empty | N/D - vuoto | ||
Sezione dati |
|
| ||
cardNumber | ColumnA | La colonna in cui si trova il numero della scheda carburante nel foglio di calcolo Excel. | ||
licencePlate | ColumnG | La colonna in cui si trova la targa del veicolo nel foglio di calcolo Excel. | ||
provider | ColumnB | La colonna in cui si trova il provider nel foglio di calcolo Excel. | ||
cost | ColumnC | La colonna in cui si trova il costo della transazione nel foglio di calcolo Excel. | ||
currencyCode | ColumnD | La colonna in cui si trova il codice valuta nel foglio di calcolo Excel. | ||
dateTime | ColumnE | La colonna in cui si trova la data e/o l'ora della transazione nel foglio di calcolo Excel. Si tratta di una proprietà speciale denominata Array delimitata da [parentesi quadre] che può contenere uno o due riferimenti di colonna. Ad esempio, ["ColumnE"] or ["ColumnE", "ColumnZ"], che rappresenta la data e/o l'ora. | ||
volume | ColumnF | La colonna in cui si trova il volume delle transazioni nel foglio di calcolo Excel. | ||
odometer | ColumnH | La colonna in cui si trova il contachilometri del veicolo nel foglio di calcolo Excel. |
Esempio di fornitore di carburante multiplo
Per vedere come è configurato un file di configurazione contenente molteplici fornitori di carburante, fare riferimento a questo collegamento.