get_timerecording.asp
Inhaltsverzeichnis
Kompatibilität
Diese Funktion ist für Nutzer der Zeiterfassung V2 gedacht.
Sollten Sie bereits die Zeiterfassung V3 verwenden, nutzen Sie bitte de Funktion get_timerecording.php
Gibt alle empfangenen Zeiterfassungsbuchungen des abgefragten Zeitraumes zurück. Es wird das Verarbeitungsdatum verwendet. D.h. wann bei uns die Meldungen verarbeitet wurden.
Falls die Zeiterfassungsbuchungen aus den Digitacho Dateien erstellt werden ist zu beachten, das es zu Verzögerungen kommt. Es muss erst die jeweilige Datei vom Fahrzeug heruntergeladen werden und danach noch exportiert werden. Dies kann zu mehreren Stunden, eventuell sogar Tagen, Verzögerung führen. Deshalb wird auch das Verarbeitungsdatum verwendet, damit kann man chronologisch Daten abrufen und verpasst keinen Wert.
Beschreibung
GET get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&mode=CSV&version=2&date_query=insert
Parameter
| Parameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | ja | |
| import | RTI Importschlüssel | string | ja | |
| begin | Startzeitpunkt der Ausgabe | string | der Ausgabezeitraum darf maximal 31 Tage umfassen | ja |
| end | Endzeitpunkt der Ausgabe | string | der Ausgabezeitraum darf maximal 31 Tage umfassen | ja |
| mode | Ausgabeformat | string | zulässige Ausgabeformate
| ja |
| version | alternative CSV Ausgabe | integer | ein Wert von "2" bei der CSV Ausgabe fügt die Geokoordinaten hinzu | nein |
| date_query | Welches Datum bildet die Grundlage für die Zeitraumeingrenzung | string | 'insert' (Standard) = Verarbeitungsdatum 'gps' = Datum an dem die Zeitbuchung stattgefunden hat | nein |
Rückgabe
Es wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung".
ReinerSCT Format
Es wird eine TXT Datei zurückgegeben. Die Formatierung der Datei entspricht den Anforderungen zum Import in ReinerSCT timeCard.
Botime Format
Es wird eine TXT Datei zurückgegeben. Die Formatierung entspricht der für das Zeiterfassungsprogramm BOTIME. Es werden lediglich Kommen und Gehen Buchungen übertragen. Datumsquelle ist das Datum, wann die Meldung entstanden ist, nicht wann es verarbeitet wurde.
CSV Format
Bei einer korrekten Anfrage werden die Daten im CSV (Comma Separated Value) Format ausgeliefert wobei die erste Anwortzeile immer die Kopfzeile ist, die die Feld-/Spalten Namen festlegt. Dannach folgen dann die Daten
Metainformationen
| Trennzeichen | Semikolon ( ; ) |
|---|---|
| Textbegrenzer | Doppeltes Hochkomma ( " ) |
| Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
| Header | Zeile 1 |
| Kodierung | Windows-1252 |
Spalten
| Spalte | Beschreibung | |
|---|---|---|
| DATETIME | Zeitpunkt der Buchung | Format: TT.MM.JJJJ HH:MM:SS |
| ACTION | Kürzel, welche Buchung durchgeführt wurde | K, G, X, Y, B, E |
| ACTIONTEXT | Beschreibungstext, welcher für diese Buchung hinterlegt wurde | Festlegung unter Verwaltung -> Timerecording |
| POSITION | Aufgelöster Positionstext | |
| AREA | Kostenstelle/Gebiete, welche für diese Position festgelegt wurden |
|
| DRIVERKEY | Schlüssel des Fahrers, der die Buchung getätigt hat | |
| DRIVERNAME | Name des Fahrers, der die Buchung getätigt hat | |
| CAR | Kurzbezeichnung des Fahrzeugs bei dem die Buchung getätigt wurde | |
| LAT | Latitude |
|
| LON | Longitude |
|
Beispiel Ausgabe
Ausgabe als CSV
"DATETIME";"ACTION";"ACTIONTEXT";"POSITION";"AREA";"DRIVERKEY";"DRIVERNAME";"CAR";"LAT";"LON";
"01.10.2015 08:00:00";"K";"Arbeitsbeginn";"Musterstraße 17, 01234 Musterstadt";"Hauptzentrale";"12345";"Max Mustermann";"MU-YF 1";"51.4";"13.1";
"01.10.2015 08:00:00";"X";"Pausenbeginn";"Testweg 23, 91234 Testhausen";"Müller GmbH";"12345";"Max Mustermann";"MU-YF 1";"52";"11.3";
Beispiele
Abruf der Buchungen mit Geokoordinaten
https://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151102000000&end=20151108235959&mode=CSV&version=2
Abruf der Buchungen für einen Reiner SCT Import
https://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151026000000&end=20151101235959&mode=RSCT