do_customdialog_data.php
Inhaltsverzeichnis
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.
Beschreibung
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
Parameter
| Parameter | Beschreibung | Typ | Hinweis | Pflicht |
|---|---|---|---|---|
| company | RTI Firmenschlüssel | string | Firmen RTI Schlüssel wird erwartet | ja |
| vehicle | RTI Fahrzeugschlüssel | string | Fahrzeug RTI Schlüssel wird erwartet | ja |
| driver | Fahrerschlüssel | string | ja | |
| form | Formularname | string | ja | |
| ts | Timestamp | string | Zeitstempel, der den Zeitpunkt des Formulareintrags festlegt. Dabei ist folgende Form einzuhalten: YYYYMMDDhhmmss | ja |
| valX | Formularwert Feld X | integer | Je nach Formulardefinition können bis zu 10 Werten übergeben werden. Dabei ist der jeweilige Formularaufbau zu beachten, der vorgibt welcher Wertetyp bei den einzelnen Werten einzuhalten ist. Felder für Bilder und Unterschriften können, selbst wenn sie als Pflichtfelder deklariert sind, freigelassen werden. | ja, falls Pflichtfeld, ansonsten optional |
Feldtypen-Formate
- Datum: YYYYMMDD
- Zeit: hhmmss
- Ganzzahl: 0123456789
- Fließkommazahl: 123.4567890
- Text 10: Text mit der Länge von 10 Zeichen
- Text 30: Text mit der Länge von 30 Zeichen
- Text 500: Text mit der Länge von 500 Zeichen
- Auswahlfeld: Text, der eine in der Formulardefinition enthaltene Auswahlmöglichkeit enthält
- Ja/ Nein-Feld: Ja = 1, Nein = 0
- Bilder/ Unterschriften/ Formulare: es wird kein Wert übergeben, kann über RTI nicht eingegeben werden
Rückgabe
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 "ERROR:Beschreibung" zurückgegeben
Mögliche Fehlermeldungen und Bedeutung:
"PARAMETER_TS_NOT_GIVEN" - Kein Timestamp übergeben
"PARAMETER_DRIVER_NOT_GIVEN" - Kein Fahrerschlüssel übergeben
"PARAMETER_FORM_NOT_GIVEN" - Kein Formularbezeichner übergeben
"PARAMETER_TS_INVALID" - Timestamp ist nicht korrekt
"PARAMETER_DRIVER_HEXKEY_INVALID" - Fahrerschlüssel ist nicht korrekt oder existiert nicht
"FORM_NOT_FOUND" - Kein Formular mit dem Bezeichner gefunden
"WRONG_FORMATTED_FIELDS(Feldnummern)" - Liste der Felder, für die falsch formatierte Werte übergeben wurden
"MANDATORY_FIELDS_MISSING(Feldnummern)" - Liste der Felder, die Pflichtfelder sind, für die aber keine Werte übergeben wurden
Beispielaufrufe
normale Nachricht an einzelnes Fahrzeug
Beilspielwerte-Typen:
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
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
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