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