Wiki-Quellcode von dt_rdl.php (Command: list)

Zuletzt geändert von YellowFox_RD am 2025/01/20 15:37
Zeige letzte Bearbeiter
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