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.
Description
POST 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
| 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 |
Field type formats
- date: YYYYMMDD
- time: hhmmss
- integer: 0123456789
- float: 123.4567890
- text 10: text with the length of 10 characters
- text 30: text with the length of 30 characters
- text 500: text with the length of 500 characters
- options field: text, which is one of the defined options of the form field
- yes/ no-field: yes = 1, no = 0
- pictures/ signatures/ forms: you send no value, this can not be set by this RTI function
Return
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 call
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