Wiki-Quellcode von get_ddd_details.php

Zuletzt geändert von YellowFox_RD am 2025/01/20 15:36
Zeige letzte Bearbeiter
1 (% class="box" %)
2 (((Inhaltsverzeichnis)))
3 {{toc/}}
4
5 Ermöglicht das Abrufen der ausgelesenen Daten einer Digitacho Datei. **Unterstützt ausschließlich Fahrerdateien.**
6 = Beschreibung =
7 (% class="green mark" %)GET(%%)//** /get_ddd_details.php?company**=RTI_COMPANYKEY**&import**=RTI_IMPORTKEY**&file**=UUID//
8
9 = Parameter =
10 |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht
11 |company|RTI Firmenschlüssel|string||ja
12 |import|RTI Importschlüssel|string||ja
13 |file|UUID der angeforderten Datei|string|Dieses Wert erhalten Sie, indem Sie die verfügbaren Dateien über [[get_file_list.php>>doc:YellowFox Remote Tracking Interface.Funktionen.Abfrageseiten.get_file_list\.php.WebHome]] abrufen.|ja
14
15 = Rückgabe =
16 Es wird ein **string** im JSON Format zurückgegeben. Im Fehlerfall wird "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben.
17 = Generelles =
18 In einer Digitacho Datei befinden sich verschiedene Datenblöcke. Nicht alle dieser Blöcke sind immer gesetzt. Diese RTI Funktion gibt ausschließlich Blöcke zurück, die auch gesetzt sind. Weiterhin muss zwischen Daten der Tacho Generation 1 und 2 unterschieden werden. Ein vorhandener Block beschreibt sich daher als Array mit den potentiellen Feldern //G1// und //G2//. Diese enthalten zum Teil identische Daten. Generation 2 Daten enthalten aber auch Mehrinformationen und zusätzliche Blöcke. Diese Funktion gibt lediglich die Rohdaten zurück. Das Zusammenführen dieser beiden Generationen muss ggf. nachträglich vorgenommen werden.
19 Folgende Blöcke werden sofern vorhanden zurückgegeben:
20 (((
21 * Informationen zur Fahreridentifikation (//Identification//)
22 * Aktivitätsaufzeichnungen (//DriverActivityData//)
23 * Führerscheininformationen (//DriverLicenceInfo//)
24 * Länderkennungen (//Places//)
25 * genutzte Fahrzeuge (//VehiclesUsed//)
26 * für Generation 2 Karten: GPS Daten (//GNSSPlaces//)
27 )))
28
29 Offizielle Informationen zum Aufbau von Digitacho Dateien finden Sie beispielsweise im Datenglossar [[hier>>https://eur-lex.europa.eu/legal-content/DE/TXT/?uri=CELEX:32016R0799]]. Die Ausgabe dieser Funktion orientiert sich an dieser Struktur. Einige Daten wurden bereits für Sie vor verarbeitet. So erhalten Sie beispielsweise die Länderkennungen bereits als Länderkürzel, alle Daten wurden als UTF-8 kodiert und Zeitangaben kommen im Format ISO 8601.
30
31 == JSON ==
32 Die genaue Spezifikation finden Sie anhand einer JSON Schema Datei [[hier>>https://map.yellowfox.de/rti/schema/get_ddd_details_schema.json]].
33 **Beispiel Ausgabe**
34 {{code language="java"}}{
35     "Identification": {
36         "G1": {
37             "cardIdentification": {
38                 "cardIssuingMemberState": "PL",
39                 "cardNumber": "123456789",
40                 "cardIssuingAuthorityName": "PWPW S.A.",
41                 "cardIssueDate": "2021-03-24T00:00:00+00:00",
42                 "cardValidityBegin": "2021-04-11T00:00:00+00:00",
43                 "cardExpiryDate": "2026-04-10T23:59:59+00:00"
44             },
45             "driverCardHolderIdentification": {
46                 "cardHolderName": "Mustermann, Max",
47                 "cardHolderBirthDate": "08.06.1979",
48                 "cardHolderPreferredLanguage": "PL"
49             },
50             "certState": true
51         }
52     },
53     "DriverActivityData": {
54         "G1": {
55             "cardDriverActivity": {
56                 "cardActivityDailyRecords": [
57                     {
58                         "cardActivityDailyRecord": {
59                             "activityRecordDate": "2021-03-14T00:00:00+00:00",
60                             "activityDayDistance": 0,
61                             "activityChangeInfos": [
62                                 {
63                                     "activityChangeInfo": {
64                                         "slot": 0,
65                                         "drivingStatus": 1,
66                                         "cardStatus": 1,
67                                         "activity": 0,
68                                         "time": 0
69                                     }
70                                     [...]
71                                 }
72                             ]
73                         }
74                     }
75                     [...]
76                 ]
77             },
78             "certState": true
79         }
80     },
81     "DriverLicenceInfo": {
82         "G1": {
83             "cardDrivingLicenceInformation": {
84                 "drivingLicenceIssuingAuthority": "Testamt",
85                 "drivingLicenceIssuingNation": "D",
86                 "drivingLicenceNumber": "12345789 "
87             },
88             "certState": true
89         }
90     },
91     "Places": {
92         "G1": {
93             "cardPlaceDailyWorkPeriod": {
94                 "placeRecords": [
95                     {
96                         "placeRecord": {
97                             "entryTime": "2021-04-11T04:26:45+00:00",
98                             "entryTypeDailyWorkPeriod": 0,
99                             "dailyWorkPeriodCountry": "D",
100                             "dailyWorkPeriodRegion": 0,
101                             "vehicleOdometerValue": 422050
102                         }
103                     }
104                 ]
105             },
106             "certState": true
107         }
108     },
109     "VehiclesUsed": {
110         "G1": {
111             "cardVehiclesUsed": {
112                 "cardVehicleRecords": [
113                     {
114                         "vehicleOdometerBegin": 422050,
115                         "vehicleOdometerEnd": 422050,
116                         "vehicleFirstUse": "2021-04-11T04:26:45+00:00",
117                         "vehicleLastUse": "2021-04-11T23:59:59+00:00",
118                         "vehicleRegistration": {
119                             "vehicleRegistrationNation": "D",
120                             "vehicleRegistrationNumber": "YF 101"
121                         }
122                     }
123                 ]
124             },
125             "certState": true
126         }
127     }
128 }{{/code}}
129
130 == Mögliche Fehlerwerte ==
131 |=Fehler|=Beschreibung
132 |MISSING_COMPANY|Firmenschlüssel fehlt
133 |INVALID_COMPANY|Firma nicht gefunden. Dies kann an einem fehlerhaften Firmen- oder Import-Schlüssel liegen.
134 |ERROR_MAINTENANCE|Ihre Firma wird gerade gewartet, währenddessen sind keine RTI Abfragen möglich.
135 |MISSING_IMPORT|Import-Schlüssel fehlt.
136 |MISSING_FILE|Es wurde keine UUID angegeben.
137 |NO_FILE_FOUND|Es wurde keine Digitacho Datei mit dieser UUID gefunden.
138 |FILE_PARSING_FAILED|Beim Verarbeiten der vom Server abgerufenen Datei ist ein Fehler aufgetreten.
139 |FILE_TYPE_NOT_SUPPORTED|Der Typ dieser Datei wird nicht unterstützt. Es ist ausschließlich das Abrufen von Fahrerdateien möglich.
140