Info |
---|
| 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 Gibt alle empfangenen Zeiterfassungsbuchungen des abgefragten Zeitraumes zurück. Beschreibungget_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&mode=CSV&version=2 ParameterParameter | BeschreibungDescription | TypType | HinweisNote | PflichtMandatory |
---|
company | RTI Firmenschlüsselcompany key | string |
| yes | ja | import | RTI Importschlüsselimport key | string |
| yes | ja | beginStartzeitpunkt der Ausgabe | output start time | string | der Ausgabezeitraum darf maximal 31 Tage umfassen | ja | end | Endzeitpunkt der Ausgabe | string | der Ausgabezeitraum darf maximal 31 Tage umfassen | ja | the output timerange is limited to 31 days | yes | end | output end time | string | the output timerange is limited to 31 days | yes | mode | output format | string | valid output formats | yes | mode | Ausgabeformat | string | zulässige Ausgabeformate | ja | version | alternative CSV Ausgabeoutput | integer | ein Wert von "2" bei der CSV Ausgabe fügt die Geokoordinaten hinzu | nein |
RückgabewerteIm Fehlerfall wird "ERROR:Beschreibung" zurückgegeben. Die Formatierung der Rückgabe entspricht den Anforderungen zum Import in die Rainer SCT Zeiterfassung. 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 a value of "2" add geocoordinates for output | no | date_query | which date column is base for date query | string | 'insert' (default) : date of proceed 'gps' : date of timerecording message | no |
ReturnA string will be returned. In case of error "ERROR:Description". The returning data matching the specification of Reiner SCT import definition. 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. 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. Separator | Semicolon ( ; ) |
---|
Delimiter | Double quote ( " ) |
---|
Line break |
---|
Trennzeichen | Semikolon ( ; ) |
---|
Textbegrenzer | Doppeltes Hochkomma ( " ) |
---|
Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
---|
Header | Zeile Row 1 |
---|
KodierungEncoding | UTFWindows-81252 |
---|
SpaltenColumnsSpalteColumn | BeschreibungBeschreibungDescription |
|
---|
DATETIMEZeitpunkt der Buchung (im Format: TT | Date | format DD.MM. | JJJJ YYYY HH:MM:SS | ) | ACTION | Kürzel, welche Buchung durchgeführt wurdeShort booging type definition | | ACTIONTEXT Beschreibungstext, welcher für diese Buchung hinterlegt wurde Festlegung unter Verwaltung -> Zeiterfassung | Description text for booking as defined | | POSITION | Aufgelöster Positionstext |
| AREA | KostenstelleCost centers/Gebiete, welche für diese Position festgelegt wurden Trennzeichenareas, as defined for this Position | | Aufbau | Kostenstelle | Leerzeichen | Gebietsname | Beispiel | 101 Baustelle A%|%201 Baustelle - 101 construction site A%|%201 construction site B%|%456
| Kunde Meier | DRIVERKEY | Schlüssel des Fahrers, der die Buchung getätigt hat | DRIVERNAME | Name des Fahrers, der die Buchung getätigt hat | personal key of person who did the booking |
| DRIVERNAME | name 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 Beispiel | | nur für | und | LON | Longitude | - Beispielexample: "13.1"
- nur für only for "mode=CSV" und and "version=2"
|
Beispiel AusgabeExample 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";
| BeispieleExample calls Code Block |
---|
title | Abruf der Buchungen mit Geokoordinaten | get bookings with geo coordinates |
---|
| httpshttp://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151102000000&end=20151108235959&mode=CSV&version=2 |
Code Block |
---|
title | Abruf der Buchungen für einen get bookings for Reiner SCT Importimport |
---|
| httphttps://map.yellowfox.de/rti/get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=20151026000000&end=20151101235959&mode=RSCT |
|