dt_rdl.php (Command: list)
Version 1.1 von YellowFox_RD am 2024/12/19 10:11
Inhaltsverzeichnis
DEPRECATED
Wurde durch die Funktion get_file_list.php (https://doc.yellowfox.net/display/RTI/get_file_list.php) ersetzt.
Gibt eine Liste Dateien aus, welche vom Digitacho heruntergeladen wurden.
Beschreibung
dt_rdl.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&command=list&show=new&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS
Parameter
| Parameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | |
| vehicle | RTI Fahrzeugschlüssel | string | entweder vehicle oder group Parameter | (ja) |
| group | RTI Gruppenschlüssel | string | oder | (ja) |
| import | RTI Importschlüssel | string | import Parameter für alle Fahrzeuge | (ja) |
| command | Kommando: list | string | ja | |
| show | 'all': zeigt alle Dateien an 'new': zeigt nur noch nicht heruntergeladene Dateien an | string | ja | |
| start | Anfang des Abfragezeitraum (Datumstyp ändert sich bei Verwendung von date_type=process) | datestring | Format: YYYYMMDDHHMMSS | nein |
| end | Ende des Abfragezeitraum (Datumstyp ändert sich bei Verwendung von date_type=process) | datestring | Format: YYYYMMDDHHMMSS | nein |
| date_type | 'process' Nutzt das Datum zu dem die Datei bei YellowFox verarbeitet wurden und nicht das Datum an dem die Datei erzeugt wurde. Diese Einstellung hat Auswirkung auf die Bedeutung der Parameter 'start' und 'end' und auf den Rückgabewert DATETIME im CSV | string | nein |
Rückgabe
Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.
CSV Format
Metainformationen
| Trennzeichen | Semikolon ( ; ) |
|---|---|
| Textbegrenzer | Doppeltes Hochkomma ( " ) |
| Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
| Header | Zeile 1 |
Header
Header Informationen
"DID";"DATETIME";"NEW";"FILENAME","VEHICLE","TYPE";"DRIVERID";"DRIVERNAME";
Spalten
| Spalte | Beschreibung | |
|---|---|---|
| DID | ID der Downloaddatei (wichtig für den Download via RTI) | |
| DATETIME | Erstellungsdatum der Datei oder Verarbeitungsdatum, falls parameter 'date_type' gesetzt ist und den Wert 'process' hat. | Format: YYYYMMDDHHMMSS |
| NEW | 1 - steht für neu, 0 - für bereits heruntergeladen | |
| FILENAME | Dateiname | |
| VEHICLE | Fahrzeugkennzeichen von welchem Fahrzeug die Downloaddatei heruntergeladen wurde | |
| TYPE | DRIVER (Fahrer) oder VEHICLE (Fahrzeug) | |
| DRIVERID | Kartennummer des Fahrers (ohne fortlaufende Nummer 001, 002,...) | |
| DRIVERNAME | Name des Fahrers |
Beispiel
"DID";"DATETIME";"NEW";"FILENAME";"VEHICLE";"TYPE";"DRIVERID";"DRIVERNAME"
"123456";"20120725001100";"1";"C_20120725_0011_Slot_1_1000000000000.DDD";"DD-YF 2012";"DRIVER";"1000000000000";"Testfahrer"
"789012";"20120725144700";"0";"M_20120725_1447__DD-YF_2012___WDB324865L2222229.DDD";"DD-YF 2012";"VEHICLE";"";""
"123456";"20120725001100";"1";"C_20120725_0011_Slot_1_1000000000000.DDD";"DD-YF 2012";"DRIVER";"1000000000000";"Testfahrer"
"789012";"20120725144700";"0";"M_20120725_1447__DD-YF_2012___WDB324865L2222229.DDD";"DD-YF 2012";"VEHICLE";"";""
Beispielaufrufe
Aufruf zum Abrufen der Liste
https://map.yellowfox.de/rti/dt_rdl.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&command=list&show=new&start=20151020120000&end=20151025120000