Sv translation |
---|
|
Info |
---|
| 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
|
- company - RTI Firmenkennung
- import - RTI Importschlüssel
- begin - Startdatum der Ausgabe (YYYYMMDDHHMMSS)
- end - Endedatum der Ausgabe (YYYYMMDDHHMMSS)
- mode - Ausgabeformat (CSV, RSCT)
- version - optional. Bei Angabe "2" werden die Geokoordinaten mit im CSV-Format ausgegeben
Zwischen (begin) und (end) dürfen maximal 31 Tage liegen.
Beispiel:
get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&mode=CSV&version=2&date_query=insert ParameterParameter | Beschreibung | Typ | Hinweis | Pflicht |
---|
company | RTI Firmenschlüssel | string |
| ja | import | RTI Importschlüssel | string |
| ja | begin | Startzeitpunkt der Ausgabe | string | der Ausgabezeitraum darf maximal 31 Tage umfassen | ja | end | Endzeitpunkt der Ausgabe | string | der Ausgabezeitraum darf maximal 31 Tage umfassen | ja | mode | Ausgabeformat | string | zulässige Ausgabeformate | ja | version | alternative CSV Ausgabe | integer | ein Wert von "2" bei der CSV Ausgabe fügt die Geokoordinaten hinzu | nein | date_query | Welches Datum bildet die Grundlage für die Zeitraumeingrenzung | string | 'insert' (Standard) = Verarbeitungsdatum 'gps' = Datum an dem die Zeitbuchung stattgefunden hat | nein |
RückgabeEs wird ein string zurückgegeben. Im Fehlerfall wird "ERROR:Beschreibung". Es wird eine TXT Datei zurückgegeben. Die Formatierung der Datei entspricht den Anforderungen zum Import in ReinerSCT timeCard. 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. 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 Trennzeichen | Semikolon ( ; ) |
---|
Textbegrenzer | Doppeltes Hochkomma ( " ) |
---|
Zeilenende | 0x0D 0x0A (CarriageReturn LineFeed) |
---|
Header | Zeile 1 |
---|
Kodierung | Windows-1252 |
---|
SpaltenSpalte | Beschreibung |
|
---|
DATETIME | Zeitpunkt 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 | POSITION | Aufgelö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"
| DRIVERKEY | Schlüssel des Fahrers, der die Buchung getätigt hat |
| DRIVERNAME | Name 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 |
---|
title | Abruf 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 |
---|
title | Abruf 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 |
---|
|
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 get_timerecording.asp?company=COMPANY_RTIKEY&import=COMPANY_IMPORTKEY&begin=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS&mode=CSV&version=2 ParameterParameter | Description | Type | Note | Mandatory |
---|
company | RTI company key | string |
| yes | import | RTI import key | string |
| yes | begin | output start time | string | 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 | version | alternative CSV output | integer | 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 | 0x0D 0x0A (CarriageReturn LineFeed) |
---|
Header | Row 1 |
---|
Encoding | Windows-1252 |
---|
ColumnsColumn | Description |
|
---|
DATETIME | Date | format DD.MM.YYYY HH:MM:SS | ACTION | Short booging type definition | | ACTIONTEXT | Description text for booking as defined | | POSITION | Aufgelö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"
| DRIVERKEY | 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 |
| 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 |
---|
| "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 |
---|
title | get 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 |
---|
title | get 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 |
|
...