get_file_list.php
Inhaltsverzeichnis
Gibt eine Liste Dateien aus, welche vom Digitacho heruntergeladen wurden oder über ein Display an das Portal geschickt wurden.
Beschreibung
GET 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ü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";"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
Rückgabe
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
Aufruf zum Abrufen der Liste
https://map.yellowfox.de/rti/get_file_list.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&file_type=digitacho&show=new&start=20180101120000&end=20180131120000
https://map.yellowfox.de/rti/get_file_list.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&file_type=digitacho&show=new&start=20180101120000&end=20180131120000