Versions Compared

Old Version 18

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version 19

changes.mady.by.user YellowFox R&D

Saved on

Key

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

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

ParameterBeschreibungTypHinweisPflicht
companyRTI Firmenschlüsselstring ja
importRTI Importschlüsselstring ja
beginStartzeitpunkt der Ausgabestringder Ausgabezeitraum darf maximal 31 Tage umfassenja
endEndzeitpunkt der Ausgabestringder Ausgabezeitraum darf maximal 31 Tage umfassenja
modeAusgabeformatstring

zulässige Ausgabeformate

  • CSV
  • RSCT
  • BOTIME
ja
versionalternative CSV Ausgabeintegerein Wert von "2" bei der CSV Ausgabe fügt die Geokoordinaten hinzunein

Rückgabewerte

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

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

Spalten

SpalteBeschreibung 
DATETIMEZeitpunkt der BuchungFormat: 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 -> Zeiterfassung

POSITIONAufgelöster Positionstext 
AREA

Kostenstelle/Gebiete, welche für diese Position festgelegt wurden

  • Trennzeichen: "%|%" 
  • Aufbau: Kostenstelle + Leerzeichen + Gebietsname
  • Beispiel: "101 Baustelle A%|%201 Baustelle B%|%456 Kunde Meier"
DRIVERKEYSchlüssel des Fahrers, der die Buchung getätigt hat 
DRIVERNAMEName des Fahrers, der die Buchung getätigt hat 
CAR

Kurzbezeichnung des Fahrzeugs bei dem die Buchung getätigt wurde

 
LAT

Latitude

  • Beispiel: "51.4"
  • nur für "mode=CSV" und "version=2
 LON

Longitude

  • Beispiel: "13.1"
  • nur für "mode=CSV" und "version=2

Beispiel Ausgabe

Code Block
"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

Code Block
titleAbruf der Buchungen mit Geokoordinaten
http://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151102000000&end=20151108235959&mode=CSV&version=2
Code Block
titleAbruf der Buchungen für einen Reiner SCT Import
http://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151026000000&end=20151101235959&mode=RSCT

...