Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languagede

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

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring
 

ja
vehicleRTI Fahrzeugschlüsselstringentweder vehicle oder group Parameter(ja)
groupRTI Gruppenschlüsselstringoder(ja)
importRTI Importschlüsselstringimport 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
startAnfang des Abfragezeitraum (Datumstyp ändert sich bei Verwendung von date_type=process)datestring

Format: YYYYMMDDHHMMSS

nein

endEnde 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

TrennzeichenSemikolon ( ; )
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1

Header

Code Block
titleHeader Informationen
"DID";"DATETIME";"NEW";"FILENAME","VEHICLE","TYPE";"DRIVERID";"DRIVERNAME";
 


Spalten

SpalteBeschreibung
 

DIDHash-Bezeichner der Downloaddatei (wichtig für den Download via RTI)
 

DATETIMEErstellungsdatum der Datei oder Verarbeitungsdatum, falls parameter 'date_type' gesetzt ist und den Wert 'process' hat.Format: YYYYMMDDHHMMSS
NEW1 - steht für neu, 0 - für bereits heruntergeladen
 

FILENAMEDateiname, mit dem die Datei über die get_file-Funktion ausgegeben werden kann
 

VEHICLEFahrzeugkennzeichen von welchem Fahrzeug die Datei stammt
 

TYPEDRIVER (Fahrer) oder VEHICLE (Fahrzeug) für Digitacho Dateien, SIGNATURE (Unterschrift) bzw. PICTURE (Bild) für Bilddateien
 

DRIVERIDKartennummer des Fahrers (ohne fortlaufende Nummer 001, 002,...)
 

DRIVERNAMEName des Fahrers
 

Beispiel

Code Block
digitacho:
"DID";"DATETIME";"NEW";"FILENAME";"VEHICLE";"TYPE";"DRIVERID";"DRIVERNAME"
"28a2fe18ab7fcb2079dacf75bd1ccb62";"20120725001100";"1";"C_20120725_0011_Slot_1_1000000000000.DDD";"DD-YF 2012";"DRIVER";"1000000000000";"Testfahrer"
"1658d0cac3451b7dbaf00f7229e5775a";"20120725144700";"0";"M_20120725_1447__DD-YF_2012___WDB324865L2222229.DDD";"DD-YF 2012";"VEHICLE";"";""

picture/signature
"DID";"DATETIME";"NEW";"FILENAME";"VEHICLE";"TYPE";"DRIVERID";"DRIVERNAME"
"28a2fe18ab7fcb2079dacf75bd1ccb62";"20120725001100";"1";"28a2fe18ab7fcb2079dacf75bd1ccb62.jpg";"DD-YF 2012";"PICTURE";"1000000000000";"Testfahrer"
"1658d0cac3451b7dbaf00f7229e5775a";"20120725144700";"0";"1658d0cac3451b7dbaf00f7229e5775a.jpg";"DD-YF 2012";"PICTURE";"";""

Beispielaufrufe

Code Block
titleAufruf zum Abrufen der Liste
http://map.yellowfox.de/rti/get_file_list.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&file_type=driverdatadigitacho&show=new&start=20180101120000&end=20180131120000


...