Wiki-Quellcode von add_driver_license_check.php
Zuletzt geändert von YellowFox_RD am 2025/01/23 10:17
Verstecke letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | (% class="box" %) |
| |
2.1 | 2 | ((( |
| 3 | Inhaltsverzeichnis | ||
| 4 | ))) | ||
| 5 | |||
| |
1.1 | 6 | {{toc/}} |
| 7 | |||
| 8 | Ermöglicht das importieren einer durchgeführten Führerscheinkontrolle | ||
| |
2.1 | 9 | |
| |
1.1 | 10 | = Beschreibung = |
| |
2.1 | 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 | |||
| |
1.1 | 15 | = Parameter = |
| |
2.1 | 16 | |
| |
5.1 | 17 | == Query-Parameter == |
| |
2.1 | 18 | |
| |
1.1 | 19 | |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht |
| |
2.1 | 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:((( | ||
| |
1.1 | 23 | * single_insert: einzelne Buchung (default) |
| 24 | * csv_import: Import einer CSV Datei | ||
| 25 | )))|nein | ||
| |
2.1 | 26 | |nfc_tag|NFC Kennung|string| |ja, bei Modus single_insert |
| |
1.1 | 27 | |date|Datum in ME(S)Z|string|Format: YYYYMMDDHHMMSS|ja, bei Modus single_insert |
| |
2.1 | 28 | |terminal|An welchem Terminal wurde die Führerscheinkontrolle durchgeführt|string| |nein |
| |
1.1 | 29 | |delimiter|Welches Trennzeichen wurde in der CSV verwendet|string|COMMA, SEMICOLON oder TAB|ja, bei Modus csv_import |
| |
2.1 | 30 | |file|Datei|file| |ja, bei Modus csv_import |
| |
1.1 | 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 | |||
| |
5.1 | 41 | == Body-Parameter == |
| |
2.1 | 42 | |
| |
1.1 | 43 | |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht |
| |
2.1 | 44 | |file|Datei|file| |ja, bei Modus csv_import |
| |
1.1 | 45 | |
| 46 | = Rückgabe = | ||
| |
2.1 | 47 | |
| |
1.1 | 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. | ||
| |
2.1 | 50 | |
| |
1.1 | 51 | = Beispiele = |
| 52 | |||
| 53 | **Single Import** | ||
| |
5.1 | 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}} |
| |
1.1 | 55 | |
| 56 | **CSV Import** | ||
| |
5.1 | 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}} |
| |
1.1 | 58 | |
| 59 | **Rückgabe CSV Import mit 3 Zeilen** | ||
| |
5.1 | 60 | \\{{code language="java"}}{ |
| |
1.1 | 61 | "1": "ERROR:NO DRIVER FOUND WITH NFC KEY: abc123def", |
| 62 | "2": "OK", | ||
| 63 | "3": "OK" | ||
| 64 | }{{/code}} | ||
| 65 |