Gibt eine Liste Dateien aus, welche vom Digitacho heruntergeladen wurden oder über ein Display an das Portal geschickt wurden. Beschreibung get_file_list.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&file_type=digitacho&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) | | file_type | Der Typ der Dateien, die angezeigt werden sollen. "digitacho" - Fahrerkartendateien "picture" - über Displays hochgeladene Bilder "signature" - über Formulare hochgeladene Unterschriften | 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ückgabeEs wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben. | Trennzeichen | Semikolon ( ; ) |
|---|
| Textbegrenzer | Doppeltes Hochkomma ( " ) |
|---|
| Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
|---|
| Header | Zeile 1 |
|---|
| Code Block |
|---|
| title | Header Informationen |
|---|
| "DID";"DATETIME";"NEW";"FILENAME","VEHICLE","TYPE";"DRIVERID";"DRIVERNAME";"IDENT";"ARCHIVEDAT";"CONTENTFROM";"CONTENTTO"; |
Spalten| Spalte | Beschreibung |
|
|---|
| DID | Hash-Bezeichner 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, mit dem die Datei über die get_file-Funktion ausgegeben werden kann |
| | VEHICLE | Fahrzeugkennzeichen von welchem Fahrzeug die Datei stammt |
| | TYPE | DRIVER (Fahrer) oder VEHICLE (Fahrzeug) für Digitacho Dateien, SIGNATURE (Unterschrift) bzw. PICTURE (Bild) für Bilddateien |
| | DRIVERID | Kartennummer des Fahrers (ohne fortlaufende Nummer 001, 002,...) |
| | DRIVERNAME | Name des Fahrers |
| | IDENT | Nutzerdefinierter RTI Ident des Fahrzeugs, welches die Datei gesendet hat |
| | ARCHIVEDAT | Verarbeitungsdatum der Datei im YellowFox Rechenzentrum | Format: YYYYMMDDHHMMSS | | CONTENTFROM | für DDD Dateien: 1. Tag mit einer aufgezeichneten Aktivität | Format: YYYYMMDD | | CONTENTTO | für DDD Dateien: letzter Tag mit einer aufgezeichneten Aktivität | Format: YYYYMMDD |
Beispiel| Code Block |
|---|
digitacho:
"DID";"DATETIME";"NEW";"FILENAME";"VEHICLE";"TYPE";"DRIVERID";"DRIVERNAME";"IDENT";"ARCHIVEDAT";"CONTENTFROM";"CONTENTTO";
"28a2fe18ab7fcb2079dacf75bd1ccb62";"20120725001100";"1";"C_20120725_0011_Slot_1_1000000000000.DDD";"DD-YF 2012";"DRIVER";"1000000000000";"Testfahrer";"YF-RTI-123";"20120725001130";"20111021";"20120724";
"1658d0cac3451b7dbaf00f7229e5775a";"20120725144700";"0";"M_20120725_1447__DD-YF_2012___WDB324865L2222229.DDD";"DD-YF 2012";"VEHICLE";"";"";""YF-RTI-123";"20120725144720";"20120720";"20120725"
picture/signature
"DID";"DATETIME";"NEW";"FILENAME";"VEHICLE";"TYPE";"DRIVERID";"DRIVERNAME";"IDENT";"ARCHIVEDAT";"CONTENTFROM";"CONTENTTO";
"28a2fe18ab7fcb2079dacf75bd1ccb62";"20120725001100";"1";"28a2fe18ab7fcb2079dacf75bd1ccb62.jpg";"DD-YF 2012";"PICTURE";"1000000000000";"Testfahrer";"YF-RTI-123";"20120725001200";"";"";
"1658d0cac3451b7dbaf00f7229e5775a";"20120725144700";"0";"1658d0cac3451b7dbaf00f7229e5775a.jpg";"DD-YF 2012";"PICTURE";"";"";"YF-RTI-123";"20120725164300";"";""; |
Beispielaufrufe| Code Block |
|---|
| title | Aufruf zum Abrufen der Liste |
|---|
| httphttps://map.yellowfox.de/rti/get_file_list.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&file_type=digitacho&show=new&start=20180101120000&end=20180131120000 |
|