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