Wiki-Quellcode von get_custom_form_data.php

Version 4.1 von Dominic Lippmann am 2025/01/23 10:03
Zeige letzte Bearbeiter
1 (% class="box" %)
2 (((
3 Inhaltsverzeichnis
4 )))
5
6 {{toc/}}
7
8 Zeigt alle Formulardaten die bei den gewählten Fahrzeugen, in dem gewählten Zeitraum empfangen wurden.
9
10 = Beschreibung =
11
12 (% class="green mark" %)//**GET**//(%%)//** get_custom_form_data.php?company**=COMPANY_RTIKEY**&import**=IMPORT_RTIKEY**&form**=FORM_NAME**&start**=YYYYMMDDHHMMSS**&end**=YYYYMMDDHHMMSS//
13
14 = Parameter =
15
16 |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht
17 |company|RTI Firmenschlüssel|string| |ja
18 |vehicle|RTI Fahrzeugschlüssel|string|Es muss immer einer der Parameter vehicle, group oder import angegeben werden!|ja
19 |group|RTI Gruppenschlüssel|string|Es muss immer einer der Parameter vehicle, group oder import angegeben werden!|ja
20 |import|RTI Importschlüssel (alle Fahrzeuge)|string|Es muss immer einer der Parameter vehicle, group oder import angegeben werden!|ja
21 |start|Datum ab dem alle Formulardaten zurückgegeben werden|string|Format: YYYYMMDDHHMMSS|ja
22 |end|Datum bis zu dem alle Formulardaten zurückgegeben werden|string|Format: YYYYMMDDHHMMSS|ja
23 |form|Formularname|string|Es kann einer der Parameter form oder custorder angegeben werden|nein
24 |custorder|Selbstdefinierte Auftragsnummer, zur Abfrage der Daten von einem Auftrag|string|Es kann einer der Parameter form oder custorder angegeben werden|nein
25 |output|Auswahl des Ausgabeformates|string|Es kann das Ausgabeformat gewählt werden. Mögliche Werte:(((
26 * csv
27 * json
28 * json_v2
29 )))Wenn kein Format gesetzt wird, werden die Daten standardmäßig als CSV ausgegeben. Die Formate CSV und JSON können nur bis zu 10 Felder pro Formular ausgeben. Das Format JSON V2 ist daher zu bevorzugen.|nein
30 |show_desc|Gib den Aufbau des Formulartyps zurück ( nichts -> nein, 1 -> ja )|integer|Ein optionaler Parameter, mit dem übergeben werden kann, ob die Formulardefinition mit übergeben werden soll.|nein
31 |date_query|Nach welchem Datumstyp soll eingegrenzt werden (create, insert, complete)|string|Optional. create ist der Standard|nein
32 |complete_buffer|Wie lange sollen nicht vollständige Formualre zurückgehalten werden|integer|Optional. Wert in Minuten. Hat nur Einfluss, wenn date_query = complete. Standard ist 0. Wird dauerhaft zurückgehalten.|nein
33
34 = Rückgabe =
35
36 Es wird eine** string **zurück gegeben. Ansonsten wird bei einem Fehler ein "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben
37
38 == CSV Format ==
39
40 === Metainformationen ===
41
42 |=Trennzeichen|Semikolon ( ; )
43 |=Textbegrenzer|Doppeltes Hochkomma ( " )
44 |=Zeilenende|0x0D 0x0A (CarriageReturn LineFeed)
45 |=Header|Zeile 1
46 |=Kodierung|UTF-8
47
48 === Spalten ===
49
50 |=Spalte|=Beschreibung
51 |DATE|Datum im Format (YYYY-MM-DD HH:MM:SS)
52 |VEHICLE|Fahrzeugkennzeichen
53 |DRIVER|Fahrername (falls einer angemeldet war)
54 |LAT|Latitude Koordinate(geographische Breite)
55 |LON|Longitude Koordinate (geographische Länge)
56 |SAT|Anzahl Satelliten
57 |IGNITION|Zündung an(1) oder aus(0)
58 |ENTRY1|Wert von Eingabefeld 1
59 |ENTRY2|Wert von Eingabefeld 2
60 |ENTRY3|Wert von Eingabefeld 3
61 |ENTRY4|Wert von Eingabefeld 4
62 |ENTRY5|Wert von Eingabefeld 5
63 |ENTRY6|Wert von Eingabefeld 6
64 |ENTRY7|Wert von Eingabefeld 7
65 |ENTRY8|Wert von Eingabefeld 8
66 |ENTRY9|Wert von Eingabefeld 9
67 |ENTRY10|Wert von Eingabefeld 10
68 |KM|aktueller KM-Stand des Fahrzeuges bei Ausfüllen des Formulars
69 |ORDER|selbstdefinierte Auftragsnummer, falls das Formular einem Auftrag zugeordnet war
70 |FORM|Name des Formulars/ wenn "show_desc" übergeben wurde,
71 wird die Formulardefinition über die Spalte FORM zurückgeliefert
72 |VEHICLE_COST_CENTER|Kostenstelle des Fahrzeugs
73 |DRIVER_MA_NUMBER|Mitarbeiter Nummer des Fahrers (nur gefüllt bei ReinerSCT Support)
74 |RTI_IDENT|RTI Ident des Fahrzeuges
75 |TOURDATA|selbstdefinierte Tournummern der Tour/des Ziels/der Sendung, falls das Formular einer Tour zugeordnet war
76 Format als JSON mit 
77 Unknown macro: {'tour'}
78 Wenn keine Referenz zu einer Tour besteht, ist dieses Feld null.
79 |PARENT_ID|Wenn dieses Formular ein Elternformular ist, dann enthält dieses Feld einen Hash um alle untergeordneten Kindformulare zu finden.
80 |PARENT_RELATION|Wenn dieses Formular ein Kindformular ist, dann enthält dieses Feld den Hash des übergeordneten Elternformulares.
81 |CUSTOM_ID|Eindeutige Identifikationsnummer des Formulars. Kann bei älteren Datensätzen NULL sein.
82
83 === Beispiel ===
84
85 **CSV-Rückgabe-Format - ohne Parameter "show_desc":**
86 {{code language="java"}}"DATE";"VEHICLE";"DRIVER";"LAT";"LON";"SAT";"IGNITION";"ENTRY1";"ENTRY2";"ENTRY3";"ENTRY4";"ENTRY5";"ENTRY6";"ENTRY7";"ENTRY8";"ENTRY9";"ENTRY10";"KM";"ORDER";"FORM";"VEHICLE_COST_CENTER";"DRIVER_MA_NUMBER";"RTI_IDENT";"TOURDATA";"PARENT_ID";"PARENT_RELATION";"CUSTOM_ID"
87 "2013-03-28 09:29:17";"DD-AB 123";"Herr Fuchs";"51.036687";"13.599141";"9";"0";"111";"22.12.89";"11:33";"Eintrag5";"TEXT10";"TEXT30";"777.77";"1";"";"";"123456";"AUFTRAG1";"UNTERSCHRIFT";"Kostenstelle XYZ";"MA123456";"IDENT1";null;"22201eb2fd123df28156bc0c86e0aba2";"" ;"5"{{/code}}
88
89 **CSV-Rückgabe-Format - mit Parameter "show_desc":**
90 {{code language="java"}}"DATE";"VEHICLE";"DRIVER";"LAT";"LON";"SAT";"IGNITION";"ENTRY1";"ENTRY2";"ENTRY3";"ENTRY4";"ENTRY5";"ENTRY6";"ENTRY7";"ENTRY8";"ENTRY9";"ENTRY10";"KM";"ORDER";"FORM";"VEHICLE_COST_CENTER";"DRIVER_MA_NUMBER";"RTI_IDENT";"TOURDATA";"PARENT_ID";"PARENT_RELATION";"CUSTOM_ID"
91 "2013-03-28 09:29:17";"DD-AB 123";"Herr Fuchs";"51.036687";"13.599141";"9";"0";"111";"22.12.89";"11:33";"Eintrag5";"TEXT10";"TEXT30";"777.77";"1";"";"";"123456";"AUFTRAG1";
92 "{""name"":""UNTERSCHRIFT"",""driver"":false,""entries"":[{""i"":1,""name"":""Ganzzahl"",""type"":""int"",""mand"":true},{""i"":2,""name"":""Datum"",""type"":""date"",""mand"":true},{""i"":3,""name"":""Zeit"",""type"":""time"",""mand"":true},{""i"":4,""name"":""Auswahlbox"",""type"":""sel"",""mand"":false,""spec"":""Eintrag1|Eintrag2|Eintrag8|Eintrag5""},{""i"":5,""name"":""Text"",""type"":""t10"",""mand"":false},{""i"":6,""name"":""Text"",""type"":""t30"",""mand"":false},{""i"":7,""name"":""Flie\u00dfkommazahl"",""type"":""flt"",""mand"":false},{""i"":8,""name"":""Frage"",""type"":""bool"",""mand"":true},{""i"":9,""name"":""Unterschrift"",""type"":""sig"",""mand"":false}]}";"Kostenstelle XYZ";"MA123456";"IDENT1";null;"22201eb2fd123df28156bc0c86e0aba2";"";"6" {{/code}}
93
94 == JSON Format ==
95
96 === Beispiel ===
97
98 **JSON-Rückgabe-Format - ohne Parameter "show_desc":**
99 {{code language="java"}}[{
100 "date":"2013-03-28 09:29:17",
101 "customId": "7",
102 "vehicle":"DD-AB 123",
103 "driver":"Herr Fuchs",
104 "lat":51.036687,
105 "lon":13.599141,
106 "sat":9,
107 "ignition":0,
108 "entry1":"111",
109 "entry2":"22.12.89",
110 "entry3":"11:33",
111 "entry4":"Eintrag5",
112 "entry5":"TEXT10",
113 "entry6":"TEXT30",
114 "entry7":"777.77",
115 "entry8":"1",
116 "entry9":"",
117 "entry10":"",
118 "km":"123456",
119 "order":"AUFTRAG1",
120 "tourData": null,
121 "form":"UNTERSCHRIFT",
122 "vehicleCostCenter":"Kostenstelle XYZ",
123 "driverMaNumber":"MA123456",
124 "rtiIdent":"Ident1",
125 "childForms":[
126 {
127 "date":"2013-03-28 08:29:17",
128 "vehicle":"DD-AB 123",
129 "driver":"Herr Fuchs",
130 "lat":51.036687,
131 "lon":13.599141,
132 "sat":9,
133 "ignition":0,
134 "entry1":"Text",
135 "entry2":"22.12.99",
136 "entry3":"11:33",
137 "km":"123456",
138 "order":"",
139 "tourData": null,
140 "form":"Unterformular",
141 "vehicleCostCenter":"Kostenstelle XYZ",
142 "driverMaNumber":"MA123456",
143 "rtiIdent":"Ident1"
144 }
145 ]
146  }]{{/code}}
147
148 **JSON-Rückgabe-Format - mit Parameter "show_desc":**
149 {{code language="java"}}[{
150 "date":"2013-03-28 09:29:17",
151 "customId": "8",
152   "vehicle":"DD-AB 123",
153 "driver":"Herr Fuchs",
154 "lat":51.036687,
155 "lon":13.599141,
156 "sat":9,
157 "ignition":0,
158 "entry1":"111",
159 "entry2":"22.12.89",
160 "entry3":"11:33",
161 "entry4":"Eintrag5",
162 "entry5":"TEXT10",
163 "entry6":"TEXT30",
164 "entry7":"777.77",
165 "entry8":"1",
166 "entry9":"",
167 "entry10":"",
168 "km":"123456",
169 "order":"AUFTRAG1",
170 "tourData": null,
171 "form":{
172 "name": "UNTERSCHRIFT",
173 "driver": false,
174 "entries": [
175 {
176 "i": 1,
177 "name": "Ganzzahl",
178 "type": "int",
179 "mand": true
180 },
181 {
182 "i": 2,
183 "name": "Datum",
184 "type": "date",
185 "mand": true
186 },
187 {
188 "i": 3,
189 "name": "Zeit",
190 "type": "time",
191 "mand": true
192 },
193 {
194 "i": 4,
195 "name": "Auswahlbox",
196 "type": "sel",
197 "mand": false,
198 "spec": "Eintrag1|Eintrag2|Eintrag8|Eintrag5"
199 },
200 {
201 "i": 5,
202 "name": "Text",
203 "type": "t10",
204 "mand": false
205 },
206 {
207 "i": 6,
208 "name": "Text",
209 "type": "t30",
210 "mand": false
211 },
212 {
213 "i": 7,
214 "name": "Fließkommazahl",
215 "type": "flt",
216 "mand": false
217 },
218 {
219 "i": 8,
220 "name": "Frage",
221 "type": "bool",
222 "mand": true
223 },
224 {
225 "i": 9,
226 "name": "Unterschrift",
227 "type": "sig",
228 "mand": false
229 }
230 ]
231 },
232 "vehicleCostCenter":"Kostenstelle XYZ",
233 "driverMaNumber":"MA123456",
234 "rtiIdent":"Ident1",
235 "childForms":[
236 {
237 "date":"2013-03-28 08:29:17",
238 "customId": "7",
239 "vehicle":"DD-AB 123",
240 "driver":"Herr Fuchs",
241 "lat":51.036687,
242 "lon":13.599141,
243 "sat":9,
244 "ignition":0,
245 "entry1":"Text",
246 "entry2":"22.12.99",
247 "entry3":"11:33",
248 "km":"123456",
249 "order":"",
250 "tourData": null,
251 "form":{
252 "name": "Unterformular",
253 "driver": false,
254 "entries": [
255 {
256 "i": 1,
257 "name": "Textfeld",
258 "type": "t30",
259 "mand": true
260 },
261 {
262 "i": 2,
263 "name": "Datum",
264 "type": "date",
265 "mand": true
266 },
267 {
268 "i": 3,
269 "name": "Zeit",
270 "type": "time",
271 "mand": true
272 }
273 ]
274 },
275 "vehicleCostCenter":"Kostenstelle XYZ",
276 "driverMaNumber":"MA123456",
277 "rtiIdent":"Ident1"
278 }
279 ]
280 }]{{/code}}
281
282 = JSON_V2 Format =
283
284 Die Parameter “form” und "custorder" werden ignoriert, wenn der Datentyp “json_v2” verwendet wird.
285
286 === Beispiel ===
287
288 **JSON-Rückgabe-Format - mit Parameter "show_desc":**
289 {{code language="java"}}[{
290 "date":"2019-11-26T10:51:39+01:00",
291 "customId": "9",
292 "vehicle":"DD-AB 123",
293 "driver":"Herr Fuchs",
294 "driverMaNumber":null,
295 "lat":51.036687,
296 "lon":13.599141,
297 "textPos": "D-01723 Wilsdruff (Kesselsdorf), Am Wüsteberg 3",
298 "sat":9,
299 "ignition":0,
300 "km":123456,
301 "order":null,
302 "orderMeta":null,
303 "tourData": null,
304 "vehicleCostCenter":null,
305 "rtiIdent":null,
306 "formName":"Beispielformular",
307 "formDriverMandatory":true,
308 "insertDate": "2020-07-22T16:08:00+02:00",
309 "completeDate": "2020-07-22T16:08:00+02:00",
310 "fields":
311 [{
312 "id":1,
313 "name":"Fließkommazahl",
314 "isMandatory":true,
315 "type":"flt",
316 "value":"111.11",
317 "isIncomplete": false
318 },
319 {
320 "id":2,
321 "name":"Text10",
322 "isMandatory":true,
323 "type":"t10",
324 "value":"Text10",
325 "isIncomplete": false
326 },
327 {
328 "id":3,
329 "name":"Text30",
330 "isMandatory":true,
331 "type":"t30",
332 "value":"Text30",
333 "isIncomplete": false
334 },
335 {
336 "id":4,
337 "name":"Text500",
338 "isMandatory":true,
339 "type":"t500",
340 "value":"Text500",
341 "isIncomplete": false
342 },
343 {
344 "id":5,
345 "name":"Ganzzahl",
346 "isMandatory":false,
347 "type":"int",
348 "value":"555",
349 "isIncomplete": false
350 },
351 {
352 "id":6,
353 "name":"Bild",
354 "isMandatory":false,
355 "type":"img",
356 "value":"48f5g3d04d177d95hs12182c39410a17e",
357 "isIncomplete": false
358 },
359 {
360 "id":7,
361 "name":"Unterschrift",
362 "isMandatory":false,
363 "type":"sig",
364 "value":"f7al12t4d177dfac0d2162f39410a17e",
365 "isIncomplete": false
366 },
367 {
368 "id":8,
369 "name":"Auswahlbox",
370 "isMandatory":false,
371 "type":"sel",
372 "value":"Eintrag 1",
373 "selectionList":
374 [
375 "Eintrag 1",
376 "Eintrag 2",
377 "Eintrag 3",
378 "Eintrag 4",
379 "Eintrag 5",
380 "Eintrag 6"
381 ]
382 },
383 {
384 "id":9,
385 "name":"Frage",
386 "isMandatory":false,
387 "type":"bool",
388 "value":"1",
389 "isIncomplete": false
390 },
391 {
392 "id":10,
393 "name":"Datum",
394 "isMandatory":false,
395 "type":"date",
396 "value":"10.10.2010",
397 "isIncomplete": false
398 },
399 {
400 "id":11,
401 "name":"Zeit",
402 "isMandatory":false,
403 "type":"time",
404 "value":"11:11",
405 "isIncomplete": false
406 },
407 {
408 "id":12,
409 "name":"Formular",
410 "isMandatory":false,
411 "type":"nestedForm",
412 "value":[
413 {
414 "date":"2019-11-26T09:51:39+01:00",
415 "customId": "7",        
416 "vehicle":"DD-AB 123",
417 "driver":"Herr Fuchs",
418 "driverMaNumber":null,
419 "lat":51.036687,
420 "lon":13.599141,
421 "textPos": "D-01723 Wilsdruff (Kesselsdorf), Am Wüsteberg 3",
422 "sat":9,
423 "ignition":0,
424 "km":123456,
425 "order":"",
426 "orderMeta":"",
427 "tourData":null,
428 "vehicleCostCenter":null,
429 "rtiIdent":null,
430 "formName":"Unterformular",
431 "formDriverMandatory":false,
432 "fields":[
433 {
434 "id":1,
435 "name":"Textfeld",
436 "isMandatory":false,
437 "type":"t30",
438 "value":"Text",
439 "isIncomplete":false
440 },
441 {
442 "id":2,
443 "name":"Bild",
444 "isMandatory":false,
445 "type":"img",
446 "value":null,
447 "isIncomplete":false
448 },
449 {
450 "id":3,
451 "name":"Unterschrift",
452 "isMandatory":false,
453 "type":"sig",
454 "value":null,
455 "isIncomplete":false
456 }
457 ],
458 "insertDate":"2019-11-26T09:53:39+01:00",
459 "completeDate":"2019-11-26T09:53:39+01:00"
460 }
461 ],
462 "isIncomplete": false
463 } ]}{{/code}}
464
465 = Beispielaufrufe =
466
467 **Für ein Fahrzeug im August 2015 und Auftragsnummer 123456**
468 {{code language="java"}}https://map.yellowfox.de/rti/get_custom_form_data.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&custorder=123456&start=20150801000000&end=20150831235959
469
470 https://map.yellowfox.de/rti/get_custom_form_data.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&custorder=123456&start=20150801000000&end=20150831235959{{/code}}
471
472 **Für alle Fahrzeuge am 01.08.2015 für Formular "Formular Name"**
473 {{code language="java"}}https://map.yellowfox.de/rti/get_custom_form_data.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&form=Formular+Name&start=20150801000000&end=20150801235959{{/code}}
474