Versions Compared

Old Version 8

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version 9

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

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

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

Spalten

SpalteBeschreibungBeschreibung
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

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
Sv translation
languageen

Returns all timerecording bookings within desired timerange.

Description

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

ParameterparameterBeschreibungdescriptionTyptypeHinweisnotePflichtmandatory
companyRTI Firmenschlüsselcompany keystring jayes
importRTI Importschlüsselimport keystring jayes
beginStartzeitpunkt der Ausgabeoutput start timestringder Ausgabezeitraum darf maximal 31 Tage umfassenja
endEndzeitpunkt der Ausgabestringder Ausgabezeitraum darf maximal 31 Tage umfassenja
the output timerange is limited to 31 daysyes
endoutput end timestringthe output timerange is limited to 31 daysyes
modeoutput formatstring

valid output formats

modeAusgabeformatstring

zulässige Ausgabeformate

  • CSV
  • RSCT 
jayes
versionalternative CSV Ausgabeoutputintegerein Wert von a value of "2"  bei der CSV Ausgabe fügt die Geokoordinaten hinzunein

Rückgabewerte

add geocoordinates for outputno

Return

On error return Im Fehlerfall wird "ERROR:Beschreibung" zurückgegeben.

Rainer

Reiner SCT Format

Die Formatierung der Rückgabe entspricht den Anforderungen zum Import in die Rainer SCT ZeiterfassungThe returning data matching the specification of Reiner SCT import definition.

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

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 break
TrennzeichenSemikolon ( ; )
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1
KodierungEncodingUTF-8
Spalten

Columns

SpalteColumnBeschreibungBeschreibungDescription
DATETIMEZeitpunkt der Buchung (im Format: TTDate with format DD.MM.JJJJ YYYY HH:MM:SS)
ACTION

Kürzel, welche Buchung durchgeführt wurdeShort booging type definition

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

Description text for booking as defined

Beschreibungstext, welcher für diese Buchung hinterlegt wurde

POSITIONAufgelöster Positionstext
AREA

KostenstelleCost centers/Gebiete, welche für diese Position festgelegt wurdenareas, as defined for this Position

  • delimiterTrennzeichen: "%|%" 
  • Aufbaustructure: Kostenstelle  cost center + Leerzeichen  space + Gebietsnamearea name
  • Beispielexample: "101 Baustelle A%|%201 Baustelle 101 construction site A%|%201 construction site B%|%456 Kunde Meiercustomer smith"
DRIVERKEYSchlüssel des Fahrers, der die Buchung getätigt hat
DRIVERNAMEName des Fahrers, der die Buchung getätigt hat
personal key of person who did the booking
DRIVERNAMEname of person who did the booking
CAR

portal Name of object, where the booking was done

CAR

Kurzbezeichnung des Fahrzeugs bei dem die Buchung getätigt wurde

LAT

Latitude

  • Beispielexample: "51.4"
  • nur für only for "mode=CSV" und  and "version=2"
 LON

Longitude

  • Beispielexample: "13.1"
  •  nur für only for "mode=CSV" und  and "version=2"
Beispiel Ausgabe

Output example

Code Block
"DATETIME";"ACTION";"ACTIONTEXT";"POSITION";"AREA";"DRIVERKEY";"DRIVERNAME";"CAR";"LAT";"LON";
"01.10.2015 08:00:00";"K";"Arbeitsbeginnwork start";"MusterstraßeExamplestreet 17, 01234 MusterstadtExamplecity";"Hauptzentralehead office";"12345";"MaxSam MustermannSmith";"MU-YF 1";"51.4";"13.1";
"01.10.2015 08:00:00";"X";"Pausenbeginnpause start";"TestwegTestroad 23, 91234 TesthausenTestvillage";"MüllerJohn Doe GmbH";"12345";"MaxSam MustermannSmith";"MU-YF 1";"52";"11.3";
 
 Beispiele

Examples

Code Block
titleAbruf der Buchungen mit Geokoordinatenget 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
titleAbruf der Buchungen für einen get bookings for Reiner SCT Importimport
http://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151026000000&end=20151101235959&mode=RSCT