Gibt alle empfangenen Zeiterfassungsbuchungen des abgefragten Zeitraumes zurück.
Beschreibung
get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&mode=CSV&version=2
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 |
Rückgabewerte
Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.
Rainer SCT Format
Die Formatierung der Rückgabe entspricht den Anforderungen zum Import in die Rainer SCT Zeiterfassung.
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 | UTF-8 |
Spalten
Spalte | BeschreibungBeschreibung |
---|---|
DATETIME | Zeitpunkt der Buchung (im Format: TT.MM.JJJJ HH:MM:SS) |
ACTION | Kürzel, welche Buchung durchgeführt wurde
|
ACTIONTEXT | Beschreibungstext, welcher für diese Buchung hinterlegt wurde
|
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
"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
http://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151102000000&end=20151108235959&mode=CSV&version=2
http://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151026000000&end=20151101235959&mode=RSCT