Versions Compared

Old Version 10

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version 11

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 
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" zurückgegeben.

Rainer SCT

ReinerSCT Format

Es wird eine TXT Datei zurückgegeben. Die Formatierung der Rückgabe Datei entspricht den Anforderungen zum Import in die Rainer SCT ZeiterfassungReinerSCT timeCard.

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
KodierungUTF-8

Spalten

)"
SpalteBeschreibung 
DATETIMEZeitpunkt der Buchung (im 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 -> 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 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
Sv translation
languageen

Returns all timerecording bookings within desired timerange.

Description

get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&mode=CSV&version=2

Parameter

parameterdescriptiontypenotemandatory
companyRTI company keystring yes
importRTI import keystring yes
beginoutput start timestringthe output timerange is limited to 31 daysyes
endoutput end timestringthe output timerange is limited to 31 daysyes
modeoutput formatstring

valid output formats

  • CSV
  • RSCT 
yes
versionalternative CSV outputintegera value of "2" add geocoordinates for outputno

Return

On error return "ERROR:Beschreibung".

Reiner SCT Format

The returning data matching the specification of Reiner SCT import definition.

CSV Format

On success, the data will be delivered in csv (comma seperated values) format. The first line always is defined as head with column names. The following rows containing the booking data.

Meta informations

SeparatorSemicolon ( ; )
DelimiterDouble quote ( " )
Line break0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1
EncodingUTF-8

Columns

ColumnDescription
DATETIMEDate with format DD.MM.YYYY HH:MM:SS
ACTION

Short booging type definition

  • K, G, X, Y, B, E
ACTIONTEXT

Description text for booking as defined

POSITIONAufgelöster Positionstext
AREA

Cost centers/areas, as defined for this Position

  • delimiter: "%|%" 
  • structure: cost center + space + area name
  • example: "101 construction site A%|%201 construction site B%|%456 customer smith"
DRIVERKEYpersonal key of person who did the booking
DRIVERNAMEname of person who did the booking
CAR

portal Name of object, where the booking was done

LAT

Latitude

  • example: "51.4"
  • only for "mode=CSV" and "version=2"
 LON

Longitude

  • example: "13.1"
  • only for "mode=CSV" and "version=2"

Output example

Code Block
"DATETIME";"ACTION";"ACTIONTEXT";"POSITION";"AREA";"DRIVERKEY";"DRIVERNAME";"CAR";"LAT";"LON";
"01.10.2015 08:00:00";"K";"work start";"Examplestreet 17, 01234 Examplecity";"head office";"12345";"Sam Smith";"MU-YF 1";"51.4";"13.1";
"01.10.2015 08:00:00";"X";"pause start";"Testroad 23, 91234 Testvillage";"John Doe GmbH";"12345";"Sam Smith";"MU-YF 1";"52";"11.3";
 

Examples

Code Block
titleget bookings with geo coordinates
http://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151102000000&end=20151108235959&mode=CSV&version=2
Code Block
titleget bookings for Reiner SCT import
http://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151026000000&end=20151101235959&mode=RSCT