Changes for page do_customdialog_data.php

Last modified by YellowFox_RD on 2025/01/23 09:55
From version 2.1
edited by YellowFox_RD
on 2025/01/23 09:55
Change comment: There is no comment for this version
To version 1.1
edited by YellowFox_RD
on 2024/12/19 10:11
Change comment: Imported from XAR

Summary

Details

Page properties
Content
... ... @@ -1,23 +1,16 @@
1 1  (% class="box" %)
2 -(((
3 -Table of Contents
4 -)))
5 -
2 +(((Table of Contents)))
6 6  {{toc/}}
7 7  
8 8  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.
9 -
10 10  = Description =
11 -
12 -(% class="blue mark" %)//**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//
13 -
7 +//**(% class="blue mark" %)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//
14 14  = Parameter =
15 -
16 16  |=Parameter|=Desciption|=Type|=Hint|=Mandatory
17 17  |company|RTI Firmenschlüssel|string|comany RTI key is needed|yes
18 18  |vehicle|RTI Fahrzeugschlüssel|string|vehicle RTI key is needed|yes
19 -|driver|Fahrerschlüssel|string| |yes
20 -|form|Formularname|string| |yes
12 +|driver|Fahrerschlüssel|string||yes
13 +|form|Formularname|string||yes
21 21  |ts|Timestamp|string|Time of the form is set.
22 22  The following format is needed: YYYYMMDDhhmmss|yes
23 23  |valX|form entry field X|integer|Each form definition has up to 10 field which can be send.
... ... @@ -25,7 +25,6 @@
25 25  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
26 26  
27 27  = Field type formats =
28 -
29 29  (((
30 30  * date: YYYYMMDD
31 31  * time: hhmmss
... ... @@ -34,24 +34,21 @@
34 34  * text 10: text with the length of 10 characters
35 35  * text 30: text with the length of 30 characters
36 36  * text 500: text with the length of 500 characters
37 -* options field: text, which is** one **of the defined options of the form field** **
29 +* options field: text, which is** one **of the defined options of the form field** **
38 38  * yes/ no-field: yes = 1, no = 0
39 39  * pictures/ signatures/ forms: you send no value, this can not be set by this RTI function
40 40  )))
41 -
42 42  = Return =
43 -
44 44  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 "(% class="error" %)**ERROR:Description**(%%)".
45 45  Possible error Messages and their meaning:
46 -"(% class="error" %)**PARAMETER_TS_NOT_GIVEN**(%%)" - no timestamp passed
47 -"(% class="error" %)**PARAMETER_DRIVER_NOT_GIVEN**(%%)" - no driver key passed
48 -"(% class="error" %)**PARAMETER_FORM_NOT_GIVEN**(%%)" - no form name passed
49 -"(% class="error" %)**PARAMETER_TS_INVALID**(%%)" - timestamp is no correct date/time value
50 -"(% class="error" %)**PARAMETER_DRIVER_HEXKEY_INVALID**(%%)" - driver key is not correct or is not existing
51 -"(% class="error" %)**FORM_NOT_FOUND**(%%)" - no form found with this name
36 +(% class="error" %)"**PARAMETER_TS_NOT_GIVEN**" - no timestamp passed(%%)
37 +"**(% class="error" %)PARAMETER_DRIVER_NOT_GIVEN(%%)**" - no driver key passed
38 +"**(% class="error" %)PARAMETER_FORM_NOT_GIVEN(%%)**" - no form name passed
39 +"**(% class="error" %)PARAMETER_TS_INVALID(%%)**" - timestamp is no correct date/time value
40 +"**(% class="error" %)PARAMETER_DRIVER_HEXKEY_INVALID(%%)**" - driver key is not correct or is not existing
41 +"**(% class="error" %)FORM_NOT_FOUND(%%)**" - no form found with this name
52 52  "(% class="error" %)**WRONG_FORMATTED_FIELDS(Feldnummern)**(%%)" - list of fields where the values are wrong formatted
53 -"(% class="error" %)**MANDATORY_FIELDS_MISSING(Feldnummern)**(%%)" - list of fields, which are mandatory, but no value is passed
54 -
43 +"**(% class="error" %)MANDATORY_FIELDS_MISSING(Feldnummern(%%)(% class="error" %))(%%)**" - list of fields, which are mandatory, but no value is passed
55 55  = Example call =
56 56  
57 57  **normale Nachricht an einzelnes Fahrzeug**