Versions Compared

Old Version 6

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version 7

changes.mady.by.user YellowFox R&D

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede

Ermöglicht das importieren einer durchgeführten Führerscheinkontrolle

Beschreibung

Status
colourBlue
titlePOST
   /personnel/add_driver_license_check.php?company=RTI_COMPANYKEY&import=RTI_VEHICLEKEY&nfc_tag=NFC_TAG&date=20210324151000&terminal=optionales Terminal

Status
colourBlue
titlePOST
   /personnel/add_driver_license_check.php?company=RTI_COMPANYKEY&import=RTI_VEHICLEKEY&mode=csv_import&delimiter=COMMA&csv_structure[]={ "type" : "datetime", "pattern":"YmdHis"}&csv_structure[]={ "type" : "nfc_tag" }&headline=1

Parameter

Query-Parameter

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring
ja
importRTI Importschlüsselstring

ja

modeUnterscheidung der verschiedenen Aktionenstring

zulässige Modi sind:

  • single_insert: einzelne Buchung (default)
  • csv_import: Import einer CSV Datei


nein

nfc_tagNFC Kennungstring
ja, bei Modus single_insert
dateDatum in ME(S)Z stringFormat: YYYYMMDDHHMMSSja, bei Modus single_insert
terminalAn welchem Terminal wurde die Führerscheinkontrolle durchgeführtstring

nein

delimiterWelches Trennzeichen wurde in der CSV verwendetstring

COMMA, SEMICOLON oder TAB

ja, bei Modus csv_import
fileDateifile
ja, bei Modus csv_import
csv_structure[]Pro Spalte ein Eintrag, was für ein Inhalt in der Spalte zu finden iststring[]
  • { "type" : "datetime", "pattern":"YmdHis"}
  • { "type" : "date", "pattern":"Ymd"}
  • { "type" : "time", "pattern":"His"}
  • { "type" : "terminal" }
  • { "type" : "nfc_tag" }
  • { "type" : "ignore" }
ja, bei Modus csv_import
headlineenthält die Datei eine Kopfzeileint0 = keine Kopfzeile (default), 1 = Kopfzeile vorhandennein

Body-Parameter

ParameterBeschreibungTypHinweisPflicht
fileDateifile
ja, bei Modus csv_import

Rückgabe

Im Erfolgsfall wird "OK" zurückgegeben. bzw. beim CSV Import pro Zeile.

Bei fehlenden oder fehlerhaften Eingaben wird ein "ERROR:Beschreibung" zurückgegeben.

Beispiele


Code Block
titleSingle Import
https://map.yellowfox.de/rti/personnel/add_driver_license_check.php?company=COMPANY_KEY&import=IMPORTKEY&nfc_tag=abc123def&date=20210324151000&terminal=optionales Terminal


Code Block
titleCSV Import
https://map.yellowfox.de/rti/personnel/add_driver_license_check.php?company=COMPANY_KEY&import=IMPORTKEY&&mode=csv_import&delimiter=COMMA&csv_structure[]={"type":"datetime","pattern":"YmdHis"}&csv_structure[]={"type":"nfc_tag"}&headline=1


Code Block
titleRückgabe CSV Import mit 3 Zeilen
{
    "1": "ERROR:NO DRIVER FOUND WITH NFC KEY: abc123def",
    "2": "OK",
    "3": "OK"
}


...