Wiki-Quellcode von add_driver_license_check.php
Version 1.1 von YellowFox_RD am 2024/12/19 10:11
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | (% class="box" %) | ||
| 2 | (((Inhaltsverzeichnis))) | ||
| 3 | {{toc/}} | ||
| 4 | |||
| 5 | Ermöglicht das importieren einer durchgeführten Führerscheinkontrolle | ||
| 6 | = Beschreibung = | ||
| 7 | **(% class="blue mark" %)POST(%%) **//**/personnel/add_driver_license_check.php?company=**RTI_COMPANYKEY**&import=**RTI_VEHICLEKEY**&nfc_tag=**NFC_TAG**&date=**20210324151000**&terminal=**optionales Terminal// | ||
| 8 | **(% class="blue mark" %)POST(%%) **//**/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// | ||
| 9 | = Parameter = | ||
| 10 | === Query-Parameter === | ||
| 11 | |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht | ||
| 12 | |company|RTI Firmenschlüssel|string||ja | ||
| 13 | |import|RTI Importschlüssel|string||ja | ||
| 14 | |mode|Unterscheidung der verschiedenen Aktionen|string|zulässige Modi sind: | ||
| 15 | ((( | ||
| 16 | * single_insert: einzelne Buchung (default) | ||
| 17 | * csv_import: Import einer CSV Datei | ||
| 18 | )))|nein | ||
| 19 | |nfc_tag|NFC Kennung|string||ja, bei Modus single_insert | ||
| 20 | |date|Datum in ME(S)Z|string|Format: YYYYMMDDHHMMSS|ja, bei Modus single_insert | ||
| 21 | |terminal|An welchem Terminal wurde die Führerscheinkontrolle durchgeführt|string||nein | ||
| 22 | |delimiter|Welches Trennzeichen wurde in der CSV verwendet|string|COMMA, SEMICOLON oder TAB|ja, bei Modus csv_import | ||
| 23 | |file|Datei|file||ja, bei Modus csv_import | ||
| 24 | |csv_structure[]|Pro Spalte ein Eintrag, was für ein Inhalt in der Spalte zu finden ist|string[]|((( | ||
| 25 | * { "type" : "datetime", "pattern":"YmdHis"} | ||
| 26 | * { "type" : "date", "pattern":"Ymd"} | ||
| 27 | * { "type" : "time", "pattern":"His"} | ||
| 28 | * { "type" : "terminal" } | ||
| 29 | * { "type" : "nfc_tag" } | ||
| 30 | * { "type" : "ignore" } | ||
| 31 | )))|ja, bei Modus csv_import | ||
| 32 | |headline|enthält die Datei eine Kopfzeile|int|0 = keine Kopfzeile (default), 1 = Kopfzeile vorhanden|nein | ||
| 33 | |||
| 34 | === Body-Parameter === | ||
| 35 | |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht | ||
| 36 | |file|Datei|file||ja, bei Modus csv_import | ||
| 37 | |||
| 38 | = Rückgabe = | ||
| 39 | Im Erfolgsfall wird "**OK**" zurückgegeben. bzw. beim CSV Import pro Zeile. | ||
| 40 | Bei fehlenden oder fehlerhaften Eingaben wird ein "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben. | ||
| 41 | = Beispiele = | ||
| 42 | |||
| 43 | **Single Import** | ||
| 44 | {{code language="java"}}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}} | ||
| 45 | |||
| 46 | **CSV Import** | ||
| 47 | {{code language="java"}}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}} | ||
| 48 | |||
| 49 | **Rückgabe CSV Import mit 3 Zeilen** | ||
| 50 | {{code language="java"}}{ | ||
| 51 | "1": "ERROR:NO DRIVER FOUND WITH NFC KEY: abc123def", | ||
| 52 | "2": "OK", | ||
| 53 | "3": "OK" | ||
| 54 | }{{/code}} | ||
| 55 |