Wiki-Quellcode von get_d8_driver_time.php
Zuletzt geändert von YellowFox_RD am 2025/01/20 15:36
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | (% class="box" %) | ||
| 2 | (((Inhaltsverzeichnis))) | ||
| 3 | {{toc/}} | ||
| 4 | |||
| 5 | Gibt aktuelle Informationen bezüglich Lenkzeit, Arbeitszeit, Restlenkzeit, Schichtbeginn vom aktuellen Tag, Woche und Doppelwoche eines Fahrers zurück auf Basis der Digitacho Infoschnittstelle (D8). | ||
| 6 | = Beschreibung = | ||
| 7 | **(% class="green mark" %)GET(%%) get_d8_driver_time.php?****company**=//COMPANY_RTIKEY//**&import**=//IMPORT_RTIKEY//**&driver**=//DF0123456789000//**&format**//=csv// | ||
| 8 | = Parameter = | ||
| 9 | |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht | ||
| 10 | |company|RTI Firmenschlüssel|string||ja | ||
| 11 | |import|RTI Importschlüssel|string||ja | ||
| 12 | |driver|Fahrerschlüssel|string||ja | ||
| 13 | |format|Rückgabeformat|string|csv oder json (Standard)|nein | ||
| 14 | |||
| 15 | = Rückgabe = | ||
| 16 | Es wird ein **string** zurückgegeben. Im Fehlerfall wird "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben. | ||
| 17 | == CSV Format == | ||
| 18 | === Metainformationen === | ||
| 19 | |=Trennzeichen|Semikolon ( ; ) | ||
| 20 | |=Textbegrenzer|Doppeltes Hochkomma ( " ) | ||
| 21 | |=Zeilenende|0x0D 0x0A (CarriageReturn LineFeed) | ||
| 22 | |=Header|Zeile 1 | ||
| 23 | |||
| 24 | === Spalten === | ||
| 25 | |=Spalte|=Beschreibung|= | ||
| 26 | |DRIVER_NAME|Fahrername| | ||
| 27 | |DRIVER_KEY|Fahrerschlüssel| | ||
| 28 | |STEER_SECONDS|Tagesaktuelle Lenkzeit in Sekunden| | ||
| 29 | |STEER_TIME|Tagesaktuelle Lenkzeit|Format 0h 00m | ||
| 30 | |WORK_SECONDS|Tagesaktuelle Arbeitszeit in Sekunden| | ||
| 31 | |WORK_TIME|Tagesaktuelle Arbeitszeit|Format 0h 00m | ||
| 32 | |IDLE_SECONDS|Gebuchte Ruhezeiten innerhalb der aktuellen Schicht in Sekunden| | ||
| 33 | |IDLE_TIME|Gebuchte Ruhezeit innerhalb der aktuellen Schicht|Format 0h 00m | ||
| 34 | |REMAINING_SECONDS|Tagesrestlenkzeit in Sekunden| | ||
| 35 | |REMAINING_TIME|Tagesrestlenkzeit|Format 0h 00m | ||
| 36 | |SHIFT_START|Schichtbeginn|Format YYYY-MM-DD HH:MM:SS | ||
| 37 | |WEEK_STEER_SECONDS|Wochenlenkzeit in Sekunden| | ||
| 38 | |WEEK_STEER_TIME|Wochenlenkzeit|Format 0h 00m | ||
| 39 | |WEEK_WORK_SECONDS|Wochenarbeitszeit in Sekunden| | ||
| 40 | |WEEK_WORK_TIME|Wochenarbeitszeit|Format 0h 00m | ||
| 41 | |WEEK_REMAINING_SECONDS|Wochenrestlenkzeit in Sekunden| | ||
| 42 | |WEEK_REMAINING_TIME|Wochenrestlenkzeit|Format 0h 00m | ||
| 43 | |WEEK_START|Wochenstart|Format YYYY-MM-DD HH:MM:SS | ||
| 44 | |DBL_WEEK_STEER_SECONDS|Doppelwochenlenkzeit in Sekunden| | ||
| 45 | |DBL_WEEK_STEER_TIME|Doppelwochenlenkzeit|Format 0h 00m | ||
| 46 | |DBL_WEEK_WORK_SECONDS|Doppelwochenarbeitszeit in Sekunden| | ||
| 47 | |DBL_WEEK_WORK_TIME|Doppelwochenarbeitszeit|Format 0h 00m | ||
| 48 | |DBL_WEEK_REMAINING_SECONDS|Doppelwochenrestlenkzeit in Sekunden| | ||
| 49 | |DBL_WEEK_REMAINING_TIME|Doppelwochenrestlenkzeit|Format 0h 00m | ||
| 50 | |DBL_WEEK_START|Start der Doppelwoche|Format YYYY-MM-DD HH:MM:SS | ||
| 51 | |BLOCK_STEER_TIME_SECONDS|Lenkzeit seit der letzten Pause in Sekunden| | ||
| 52 | |BLOCK_STEER_TIME|Lenkzeit seit der letzten Pause|Format 0h 00m | ||
| 53 | |BLOCK_REMAINING_TIME_SECONDS|Restlenkzeit bis zur nächsten Pause in Sekunden| | ||
| 54 | |BLOCK_REMAINING_TIME|Restlenkzeit bis zur nächsten Pause|Format 0h 00m | ||
| 55 | |NEXT_BREAK_DURATION_SECONDS|Dauer der nächsten Pause in Sekunden| | ||
| 56 | |NEXT_BREAK_DURATION|Dauer der nächsten Pause|Format 0h 00m | ||
| 57 | |LAST_TACHOGRAPH_STATUS|Aktivitätsstatus der letzten Tacho-Buchung | ||
| 58 | 0 .. Ruhe | ||
| 59 | 1 .. Bereitschaft | ||
| 60 | 2 .. Arbeit | ||
| 61 | 3 .. Lenken| | ||
| 62 | |LAST_TACHOGRAPH_TIME|Zeitpunkt der letzten Buchung|Format YYYY-MM-DD HH:MM:SS | ||
| 63 | |LAST_TACHOGRAPH_SLOT|Tacho-Slot in dem diese Buchung vorgenommen wurde | ||
| 64 | 1 .. Fahrer | ||
| 65 | 2 .. Beifahrer| | ||
| 66 | |WEEK_SHORT_IDLES_TIMES|Anzahl verkürzter Ruhezeiten innerhalb der aktuellen Schichtwoche| | ||
| 67 | |WEEK_EXTENDED_STEER_TIMES|Anzahl der Schichttage mit langen Lenkzeiten innerhalb der aktuellen Schichtwoche. | ||
| 68 | ((( | ||
| 69 | * reguläre Tageslenkzeit <= 9h, | ||
| 70 | * 9h < lange Tageslenkzeit <= 10h | ||
| 71 | )))| | ||
| 72 | |||
| 73 | **Beispiel** | ||
| 74 | {{code language="java"}}"DRIVER_NAME";"DRIVER_KEY";"STEER_SECONDS";"STEER_TIME";"WORK_SECONDS";"WORK_TIME";"IDLE_SECONDS";"IDLE_TIME";"REMAINING_SECONDS";"REMAINING_TIME";"SHIFT_START";"WEEK_STEER_SECONDS";"WEEK_STEER_TIME";"WEEK_WORK_SECONDS";"WEEK_WORK_TIME";"WEEK_REMAINING_SECONDS";"WEEK_REMAINING_TIME";"WEEK_START";"DBL_WEEK_STEER_SECONDS";"DBL_WEEK_STEER_TIME";"DBL_WEEK_WORK_SECONDS";"DBL_WEEK_WORK_TIME";"DBL_WEEK_REMAINING_SECONDS";"DBL_WEEK_REMAINING_TIME";"DBL_WEEK_START";"BLOCK_STEER_TIME_SECONDS";"BLOCK_STEER_TIME";"BLOCK_REMAINING_TIME_SECONDS";"BLOCK_REMAINING_TIME";"NEXT_BREAK_DURATION_SECONDS";"NEXT_BREAK_DURATION";"LAST_TACHOGRAPH_STATUS";"LAST_TACHOGRAPH_TIME";"LAST_TACHOGRAPH_SLOT" | ||
| 75 | "Musternamm, Paul";"DF00011424169815";"0";"0 h 0 m";"0";"0 h 0 m";"0";"0 h 0 m";"36000";"10 h 0 m";"2015-11-17 10:02:43";"20520";"5 h 42 m";"3180";"0 h 53 m";"181080";"50 h 18 m";"2015-11-16 00:00:00";"166140";"46 h 9 m";"11520";"3 h 12 m";"157860";"43 h 51 m";"2015-11-09 00:00:00";"3900";"1 h 5 m";"12325";"3 h 25 m";"2700";"0 h 45 m";"0";"2015-1-16 14:30:00";"1"{{/code}} | ||
| 76 | |||
| 77 | == JSON Format == | ||
| 78 | === Spalten === | ||
| 79 | |=Spalte|=Beschreibung|= | ||
| 80 | |driverName|Fahrername| | ||
| 81 | |driverKey|Fahrerschlüssel| | ||
| 82 | |steerTimeSeconds|Tagesaktuelle Lenkzeit in Sekunden| | ||
| 83 | |steerTime|Tagesaktuelle Lenkzeit|Format 0h 00m | ||
| 84 | |workTimeSeconds|Tagesaktuelle Arbeitszeit in Sekunden| | ||
| 85 | |workTime|Tagesaktuelle Arbeitszeit|Format 0h 00m | ||
| 86 | |idleTimeSeconds|gebuchte Ruhezeit innerhalb der aktuellen Schicht in Sekunden| | ||
| 87 | |idleTime|gebuchte Ruhezeit innerhalb der aktuellen Schicht|Format 0h 00m | ||
| 88 | |remainingTimeSeconds|Tagesrestlenkzeit in Sekunden| | ||
| 89 | |remainingTime|Tagesrestlenkzeit|Format 0h 00m | ||
| 90 | |blockSteerTimeSeconds|Lenkzeit seit der letzten Pause in Sekunden| | ||
| 91 | |blockSteerTime|Lenkzeit seit der letzten Pause|Format 0h 00m | ||
| 92 | |blockRemainingTimeSeconds|Restlenkzeit bis zur nächsten Pause in Sekunden| | ||
| 93 | |blockRemainingTime|Restlenkzeit bis zur nächsten Pause|Format 0h 00m | ||
| 94 | |nextBreakDurationSeconds|Dauer der nächsten Pause in Sekunden| | ||
| 95 | |nextBreakDuration|Dauer der nächsten Pause|Format 0h 00m | ||
| 96 | |shiftStart|Schichtbeginn|Format YYYY-MM-DD HH:MM:SS | ||
| 97 | |steerTimeSecondsSingleWeek|Wochenlenkzeit in Sekunden| | ||
| 98 | |steerTimeSingleWeek|Wochenlenkzeit|Format 0h 00m | ||
| 99 | |workTimeSecondsSingleWeek|Wochenarbeitszeit in Sekunden| | ||
| 100 | |workTimeSingleWeek|Wochenarbeitszeit|Format 0h 00m | ||
| 101 | |remainingTimeSecondsSingleWeek|Wochenrestlenkzeit in Sekunden| | ||
| 102 | |remainingTimeSingleWeek|Wochenrestlenkzeit|Format 0h 00m | ||
| 103 | |startSingleWeek|Wochenstart|Format YYYY-MM-DD HH:MM:SS | ||
| 104 | |singleWeekShortIdles|Anzahl verkürzter Ruhezeiten innerhalb der aktuellen Schichtwoche| | ||
| 105 | |singleWeekExtendedSteer|Anzahl der Schichttage mit langen Lenkzeiten innerhalb der aktuellen Schichtwoche. | ||
| 106 | ((( | ||
| 107 | * reguläre Tageslenkzeit <= 9h, | ||
| 108 | * 9h < lange Tageslenkzeit <= 10h | ||
| 109 | )))| | ||
| 110 | |steerTimeSecondsDoubleWeek|Doppelwochenlenkzeit in Sekunden| | ||
| 111 | |steerTimeDoubleWeek|Doppelwochenlenkzeit|Format 0h 00m | ||
| 112 | |workTimeSecondsDoubleWeek|Doppelwochenarbeitszeit in Sekunden| | ||
| 113 | |workTimeDoubleWeek|Doppelwochenarbeitszeit|Format 0h 00m | ||
| 114 | |remainingTimeSecondsDoubleWeek|Doppelwochenrestlenkzeit in Sekunden| | ||
| 115 | |remainingTimeDoubleWeek|Doppelwochenrestlenkzeit|Format 0h 00m | ||
| 116 | |startDoubleWeek|Start der Doppelwoche|Format YYYY-MM-DD HH:MM:SS | ||
| 117 | |lastTachographStatus|Aktivitätsstatus der letzten Tacho-Buchung | ||
| 118 | 0 .. Ruhe | ||
| 119 | 1 .. Bereitschaft | ||
| 120 | 2 .. Arbeit | ||
| 121 | 3 .. Lenken| | ||
| 122 | |lastTachographTime|Zeitpunkt der letzten Buchung|Format YYYY-MM-DD HH:MM:SS | ||
| 123 | |lastTachographSlot|Tacho-Slot in dem diese Buchung vorgenommen wurde | ||
| 124 | 1 .. Fahrer | ||
| 125 | 2 .. Beifahrer| | ||
| 126 | |||
| 127 | **Beispiel** | ||
| 128 | {{code language="java"}}{"driverName":"Mustermann, Paul","driverKey":"DF0123456789815","steerTimeSeconds":12325,"steerTime":"3 h 25 m","workTimeSeconds":120,"workTime":"0 h 2 m","idleTimeSeconds":240,"idleTime":"","remainingTimeSeconds":23675,"remainingTime":"6 h 35 m","blockSteerTimeSeconds":660,"blockSteerTime":"0h 11m","blockRemainingTimeSeconds":12325,"blockRemainingTime":"3 h 25 m","nextBreakDurationSeconds":2700,"nextBreakDuration":"0 h 45 m","shiftStart":"2015-11-16 12:04:00","steerTimeSecondsSingleWeek":12325,"steerTimeSingleWeek":"3 h 25 m","workTimeSecondsSingleWeek":120,"workTimeSingleWeek":"0 h 2 m","remainingTimeSecondsSingleWeek":189275,"remainingTimeSingleWeek":"52 h 35 m","startSingleWeek":"2015-11-16 00:00:00","steerTimeSecondsDoöubleWeek":157945,"steerTimeDoubleWeek":"43 h 52 m","workTimeSecondsDoubleWeek":8460,"workTimeDoubleWeek":"2 h 21 m","remainingTimeSecondsDoubleWeek":166055,"remainingTimeDoubleWeek":"46 h 8 m","startDoubleWeek":"2015-11-09 00:00:00","lastTachographStatus":3,"lastTachographTime":"2015-11-16 13:25:00","lastTachographSlot":1}{{/code}} | ||
| 129 | |||
| 130 | = Beispielaufrufe = | ||
| 131 | **Abfrage im JSON Format** | ||
| 132 | {{code language="java"}}https://map.yellowfox.de/rti/get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000{{/code}} | ||
| 133 | |||
| 134 | **Abfrage im CSV Format** | ||
| 135 | {{code language="java"}}https://map.yellowfox.de/rti/get_d8_driver_time.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&driver=DF0123456789000&format=csv{{/code}} | ||
| 136 |