Versions Compared

Old Version 6

changes.mady.by.user YellowFox R&D

Saved on

compared with

New Version Current

changes.mady.by.user YellowFox R&D

Saved on

Key

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


Info
titleKompatibilitä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

...

Status
colourGreen
titleGET
 get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&mode=CSV&version=2&date_query=insert

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

date_queryWelches Datum bildet die Grundlage für die Zeitraumeingrenzungstring

'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

TrennzeichenSemikolon ( ; )
TextbegrenzerDoppeltes Hochkomma ( " )
Zeilenende0x0D 0x0A (CarriageReturn LineFeed)
HeaderZeile 1
Kodierung

...

Windows-

...

1252

Spalten

Spalte

...

Beschreibung
DATETIMEZeitpunkt 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 -> 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
titleAusgabe 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

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


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


Sv translation
languageen


Info
titleCompatibility

This function is intended to be used with timerecording V2

If you are using the newer V3 version, please use get_timerecording.php


Returns all timerecording bookings within desired timerange.

Description

Status
colourGreen
titleGET
 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
  • BOTIME
yes
versionalternative CSV outputintegera value of "2" add geocoordinates for outputno
date_querywhich date column is base for date querystring

'insert' (default) : date of proceed

'gps' : date of timerecording message

no

Return

A string will be returned. In case of error "ERROR:Description".

Reiner SCT Format

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

Botime Format

The returning data matching the specification of BOTIME. A TXT file will be returned. The requested date is based on timerecording date and not the date of message processing.

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)
HeaderRow 1
EncodingWindows-1252

Columns

ColumnDescription
DATETIMEDateformat 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"

Example

Code Block
titlereturn in csv
"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";
 

Example calls

Code Block
titleget bookings with geo coordinates
https://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
https://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151026000000&end=20151101235959&mode=RSCT