Wiki-Quellcode von do_customdialog_data.php

Zuletzt geändert von YellowFox_RD am 2025/01/23 10:02
Zeige letzte Bearbeiter
1 (% class="box" %)
2 (((
3 Inhaltsverzeichnis
4 )))
5
6 {{toc/}}
7
8 Ein Formulareintrag wird für einen bestimmten Formulartyp angelegt. Dabei kann das Fahrzeug, der Fahrer und der Zeitpunkt, an dem das Formular gültig sein soll, übergeben werden.
9
10 = Beschreibung =
11
12 (% class="blue mark" %)//**POST**//(%%)//** do_customdialog_data.php?company**//=COMPANY_RTIKEY**&vehicle**=VEHICLE_RTIKEY&driver//=DRIVER_HEXKEY**&form**=Formname**&ts**//=//Zeitstempel**&val1**//=//Feld 1-Wert**&val2**//=Felld 2-Wert//**&valX**//=//Feld X-Wert//
13
14 = Parameter =
15
16 |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht
17 |company|RTI Firmenschlüssel|string|Firmen RTI Schlüssel wird erwartet|ja
18 |vehicle|RTI Fahrzeugschlüssel|string|Fahrzeug RTI Schlüssel wird erwartet|ja
19 |driver|Fahrerschlüssel|string| |ja
20 |form|Formularname|string| |ja
21 |ts|Timestamp|string|Zeitstempel, der den Zeitpunkt des Formulareintrags festlegt.
22 Dabei ist folgende Form einzuhalten: YYYYMMDDhhmmss|ja
23 |valX|Formularwert Feld X|integer|Je nach Formulardefinition können bis zu 10 Werten übergeben werden.
24 Dabei ist der jeweilige Formularaufbau zu beachten, der vorgibt welcher
25 Wertetyp bei den einzelnen Werten einzuhalten ist.
26 Felder für Bilder und Unterschriften können, selbst wenn sie als Pflichtfelder
27 deklariert sind, freigelassen werden.|ja, falls Pflichtfeld, ansonsten optional
28
29 = Feldtypen-Formate =
30
31 (((
32 * Datum: YYYYMMDD
33 * Zeit: hhmmss
34 * Ganzzahl: 0123456789
35 * Fließkommazahl: 123.4567890
36 * Text 10: Text mit der Länge von 10 Zeichen
37 * Text 30: Text mit der Länge von 30 Zeichen
38 * Text 500: Text mit der Länge von 500 Zeichen
39 * Auswahlfeld: Text, der **eine** in der Formulardefinition enthaltene Auswahlmöglichkeit enthält
40 * Ja/ Nein-Feld: Ja = 1, Nein = 0
41 * Bilder/ Unterschriften/ Formulare: es wird kein Wert übergeben, kann über RTI nicht eingegeben werden
42 )))
43
44 = Rückgabe =
45
46 Es wird standardmäßig eine "**OK**"-Meldung zurückgegeben, die den Erfolg der Funktion bestätigt. Bei fehlenden Pflichtparametern oder fehlerhaften Datentypen für einen oder mehrere Werte wird ein "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben
47 Mögliche Fehlermeldungen und Bedeutung:
48 "(% class="error" %)**PARAMETER_TS_NOT_GIVEN**(%%)" - Kein Timestamp übergeben
49 "(% class="error" %)**PARAMETER_DRIVER_NOT_GIVEN**(%%)" - Kein Fahrerschlüssel übergeben
50 "(% class="error" %)**PARAMETER_FORM_NOT_GIVEN**(%%)" - Kein Formularbezeichner übergeben
51 "(% class="error" %)**PARAMETER_TS_INVALID**(%%)" - Timestamp ist nicht korrekt
52 "(% class="error" %)**PARAMETER_DRIVER_HEXKEY_INVALID**(%%)" - Fahrerschlüssel ist nicht korrekt oder existiert nicht
53 "(% class="error" %)**FORM_NOT_FOUND**(%%)" - Kein Formular mit dem Bezeichner gefunden
54 "(% class="error" %)**WRONG_FORMATTED_FIELDS(Feldnummern)**(%%)" - Liste der Felder, für die falsch formatierte Werte übergeben wurden
55 "(% class="error" %)**MANDATORY_FIELDS_MISSING(Feldnummern)**(%%)" - Liste der Felder, die Pflichtfelder sind, für die aber keine Werte übergeben wurden
56
57 = Beispielaufrufe =
58
59 **normale Nachricht an einzelnes Fahrzeug**
60 {{code language="java"}}Beilspielwerte-Typen:
61 1: Text 10, 2: Datum, 3: Zeit, 4: Ganzzahl, 5: Fließkommazahl, 6: Auswahlfeld, 7: Ja/Nein-Feld, 8: Text 30, 9: Text 500, 10: Ja/Nein-Feld
62 https://map.yellowfox.de/rti/do_customdialog_data.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&driver=DRIVER_HEXKEY&form=FORM_NAME&ts=20171114120000&val1=Text&val2=20171231&val3=114500&val4=12345&val5=12.345&val6=Auswahl4&val7=1&val8=Ein%20l%C3%A4ngerer%20Text&val9=Ein%20noch%20viel%20l%C3%A4ngerer%20Text%20als%20Beispiel&val10=0
63
64 https://map.yellowfox.de/rti/do_customdialog_data.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&driver=DRIVER_HEXKEY&form=FORM_NAME&ts=20171114120000&val1=Text&val2=20171231&val3=114500&val4=12345&val5=12.345&val6=Auswahl4&val7=1&val8=Ein%20l%C3%A4ngerer%20Text&val9=Ein%20noch%20viel%20l%C3%A4ngerer%20Text%20als%20Beispiel&val10=0{{/code}}
65