Wiki-Quellcode von dt_rdl.php (Command: list)
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 | (% class="red mark" %)DEPRECATED(%%) | ||
| 6 | Wurde durch die Funktion get_file_list.php ([[https:~/~/doc.yellowfox.net/display/RTI/get_file_list.php>>doc:YellowFox Remote Tracking Interface.Funktionen.Abfrageseiten.get_file_list\.php.WebHome]]) ersetzt. | ||
| 7 | Gibt eine Liste Dateien aus, welche vom Digitacho heruntergeladen wurden. | ||
| 8 | = Beschreibung = | ||
| 9 | **dt_rdl.php****?company**=//COMPANY_RTIKEY//**&vehicle**=//VEHICLE_RTIKEY//**&command**=list**&show**=new**&start**=//YYYYMMDDHHMMSS//**&end**=//YYYYMMDDHHMMSS// | ||
| 10 | = Parameter = | ||
| 11 | |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht | ||
| 12 | |company|RTI Firmenschlüssel|string||ja | ||
| 13 | |vehicle|RTI Fahrzeugschlüssel|string|entweder vehicle oder group Parameter|(ja) | ||
| 14 | |group|RTI Gruppenschlüssel|string|oder|(ja) | ||
| 15 | |import|RTI Importschlüssel|string|import Parameter für alle Fahrzeuge|(ja) | ||
| 16 | |command|Kommando: list|string||ja | ||
| 17 | |show|'all': zeigt alle Dateien an | ||
| 18 | 'new': zeigt nur noch nicht heruntergeladene Dateien an|string||ja | ||
| 19 | |start|Anfang des Abfragezeitraum (Datumstyp ändert sich bei Verwendung von date_type=process)|datestring|Format: YYYYMMDDHHMMSS|nein | ||
| 20 | |end|Ende des Abfragezeitraum (Datumstyp ändert sich bei Verwendung von date_type=process)|datestring|Format: YYYYMMDDHHMMSS|nein | ||
| 21 | |date_type|'process' Nutzt das Datum zu dem die Datei bei YellowFox verarbeitet wurden und nicht das | ||
| 22 | Datum an dem die Datei erzeugt wurde. Diese Einstellung hat Auswirkung auf die Bedeutung | ||
| 23 | der Parameter 'start' und 'end' und auf den Rückgabewert DATETIME im CSV|string||nein | ||
| 24 | |||
| 25 | = Rückgabe = | ||
| 26 | Es wird ein **string** zurückgegeben. Im Fehlerfall wird "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben. | ||
| 27 | == CSV Format == | ||
| 28 | === Metainformationen === | ||
| 29 | |=Trennzeichen|Semikolon ( ; ) | ||
| 30 | |=Textbegrenzer|Doppeltes Hochkomma ( " ) | ||
| 31 | |=Zeilenende|0x0D 0x0A (CarriageReturn LineFeed) | ||
| 32 | |=Header|Zeile 1 | ||
| 33 | |||
| 34 | === Header === | ||
| 35 | **Header Informationen** | ||
| 36 | {{code language="java"}}"DID";"DATETIME";"NEW";"FILENAME","VEHICLE","TYPE";"DRIVERID";"DRIVERNAME";{{/code}} | ||
| 37 | |||
| 38 | === Spalten === | ||
| 39 | |=Spalte|=Beschreibung|= | ||
| 40 | |DID|ID der Downloaddatei (wichtig für den Download via RTI)| | ||
| 41 | |DATETIME|Erstellungsdatum der Datei oder Verarbeitungsdatum, falls parameter 'date_type' gesetzt ist und den Wert 'process' hat.|Format: YYYYMMDDHHMMSS | ||
| 42 | |NEW|1 - steht für neu, 0 - für bereits heruntergeladen| | ||
| 43 | |FILENAME|Dateiname| | ||
| 44 | |VEHICLE|Fahrzeugkennzeichen von welchem Fahrzeug die Downloaddatei heruntergeladen wurde| | ||
| 45 | |TYPE|DRIVER (Fahrer) oder VEHICLE (Fahrzeug)| | ||
| 46 | |DRIVERID|Kartennummer des Fahrers (ohne fortlaufende Nummer 001, 002,...)| | ||
| 47 | |DRIVERNAME|Name des Fahrers| | ||
| 48 | |||
| 49 | === Beispiel === | ||
| 50 | |||
| 51 | {{code language="java"}}"DID";"DATETIME";"NEW";"FILENAME";"VEHICLE";"TYPE";"DRIVERID";"DRIVERNAME" | ||
| 52 | "123456";"20120725001100";"1";"C_20120725_0011_Slot_1_1000000000000.DDD";"DD-YF 2012";"DRIVER";"1000000000000";"Testfahrer" | ||
| 53 | "789012";"20120725144700";"0";"M_20120725_1447__DD-YF_2012___WDB324865L2222229.DDD";"DD-YF 2012";"VEHICLE";"";""{{/code}} | ||
| 54 | |||
| 55 | = Beispielaufrufe = | ||
| 56 | **Aufruf zum Abrufen der Liste** | ||
| 57 | {{code language="java"}}https://map.yellowfox.de/rti/dt_rdl.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&command=list&show=new&start=20151020120000&end=20151025120000{{/code}} | ||
| 58 |