Creating a form entry for a specific form definition. Every form belongs to a vehicle, a driver and a time, when the form is valid and this has to be given when the form is created.
do_customdialog_data.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&driver=DRIVER_HEXKEY&form=formname&ts=timestamp&val1=field 1-value&val2=field 2-value&valX=field X-value
Parameter | Desciption | Type | Hint | Mandatory |
---|---|---|---|---|
company | RTI Firmenschlüssel | string | comany RTI key is needed | yes |
vehicle | RTI Fahrzeugschlüssel | string | vehicle RTI key is needed | yes |
driver | Fahrerschlüssel | string | yes | |
form | Formularname | string | yes | |
ts | Timestamp | string | Time of the form is set. The following format is needed: YYYYMMDDhhmmss | yes |
valX | form entry field X | integer | Each form definition has up to 10 field which can be send. For every form you have to observe the form structure, because of the types and order of each entry. Fields with pictures or signatures can not be set by this function and you let them free, also if they are mandatory. | yes, if mandatory field, if not it is optional |
The standard return is a "OK"-message, which marks the succes of the function. If a mandatory parameter is missing or values have a wrong format the retrurn message is "ERROR:Description".
Possible error Messages and their meaning:
"PARAMETER_TS_NOT_GIVEN" - no timestamp passed
"PARAMETER_DRIVER_NOT_GIVEN" - no driver key passed
"PARAMETER_FORM_NOT_GIVEN" - no form name passed
"PARAMETER_TS_INVALID" - timestamp is no correct date/time value
"PARAMETER_DRIVER_HEXKEY_INVALID" - driver key is not correct or is not existing
"FORM_NOT_FOUND" - no form found with this name
"WRONG_FORMATTED_FIELDS(Feldnummern)" - list of fields where the values are wrong formatted
"MANDATORY_FIELDS_MISSING(Feldnummern)" - list of fields, which are mandatory, but no value is passed
example value-types: 1: text 10, 2: date, 3: time, 4: integer, 5: float, 6: options field, 7: yes/no-field, 8: text 30, 9: text 500, 10: yes/no-field 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=option4&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 |