Sv translation

language	de

Zeigt alle Formulardaten die bei den gewählten Fahrzeugen, in dem gewählten Zeitraum empfangen wurden.

Beschreibung

Status

colour	Green
title	GET

get_custom_form_data.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&form=FORM_NAME&start=YYYYMMDDHHMMSS&end=YYYYMMDDHHMMSS

Parameter

Parameter	Beschreibung	Typ	Hinweis	Pflicht
company	RTI Firmenschlüssel	string		ja
vehicle	RTI Fahrzeugschlüssel	string	Es muss immer einer der Parameter vehicle, group oder import angegeben werden!	ja
group	RTI Gruppenschlüssel	string	Es muss immer einer der Parameter vehicle, group oder import angegeben werden!	ja
import	RTI Importschlüssel (alle Fahrzeuge)	string	Es muss immer einer der Parameter vehicle, group oder import angegeben werden!	ja
start	Datum ab dem alle Formulardaten zurückgegeben werden	string	Format: YYYYMMDDHHMMSS	ja
end	Datum bis zu dem alle Formulardaten zurückgegeben werden	string	Format: YYYYMMDDHHMMSS	ja
form	Formularname	string	Es kann einer der Parameter form oder custorder angegeben werden	nein
custorder	Selbstdefinierte Auftragsnummer, zur Abfrage der Daten von einem Auftrag	string	Es kann einer der Parameter form oder custorder angegeben werden	nein
output	Auswahl des Ausgabeformates	string	Es kann das Ausgabeformat gewählt werden. Wenn keines gewählt ist wird als Standard die Daten in CSV ausgegeben.	nein
show_desc	Gib den Aufbau des Formulartyps zurück ( nichts -> nein, 1 -> ja )	integer	Ein optionaler Parameter, mit dem übergeben werden kann, ob die Formulardefinition mit übergeben werden soll.	nein
date_query	Nach welchem Datumstyp soll eingegrenzt werden (create, insert, complete)	string	Optional. create ist der Standard	nein
complete_buffer	Wie lange sollen nicht vollständige Formualre zurückgehalten werden	integer	Optional. Wert in Minuten. Hat nur Einfluss, wenn date_query = complete. Standard ist 0. Wird dauerhaft zurückgehalten.	nein

Rückgabe

Es wird eine string zurück gegeben. Ansonsten wird bei einem Fehler ein "ERROR:Beschreibung" zurückgegeben

CSV Format

Metainformationen

Trennzeichen	Semikolon ( ; )
Textbegrenzer	Doppeltes Hochkomma ( " )
Zeilenende	0x0D 0x0A (CarriageReturn LineFeed)
Header	Zeile 1
Kodierung	UTF-8

Spalten

Spalte

Beschreibung

DATE

Datum im Format (YYYY-MM-DD HH:MM:SS)

VEHICLE

Fahrzeugkennzeichen

DRIVER

Fahrername (falls einer angemeldet war)

LAT

Latitude Koordinate(geographische Breite)

LON

Longitude Koordinate (geographische Länge)

SAT

Anzahl Satelliten

IGNITION

Zündung an(1) oder aus(0)

ENTRY1

Wert von Eingabefeld 1

ENTRY2

Wert von Eingabefeld 2

ENTRY3

Wert von Eingabefeld 3

ENTRY4

Wert von Eingabefeld 4

ENTRY5

Wert von Eingabefeld 5

ENTRY6

Wert von Eingabefeld 6

ENTRY7

Wert von Eingabefeld 7

ENTRY8

Wert von Eingabefeld 8

ENTRY9

Wert von Eingabefeld 9

ENTRY10

Wert von Eingabefeld 10

KM

aktueller KM-Stand des Fahrzeuges bei Ausfüllen des Formulars

ORDER

selbstdefinierte Auftragsnummer, falls das Formular einem Auftrag zugeordnet war

FORM

Name des Formulars/ wenn "show_desc" übergeben wurde,

wird die Formulardefinition über die Spalte FORM zurückgeliefert

VEHICLE_COST_CENTER

Kostenstelle des Fahrzeugs

DRIVER_MA_NUMBER

Mitarbeiter Nummer des Fahrers (nur gefüllt bei ReinerSCT Support)

RTI_IDENT

RTI Ident des Fahrzeuges

TOURDATA

selbstdefinierte Tournummern der Tour/des Ziels/der Sendung, falls das Formular einer Tour zugeordnet war

Format als JSON mit

Wiki Markup
{'tour':'T1,'dest':'T2','ship':'T3'}

Wenn keine Referenz zu einer Tour besteht, ist dieses Feld null.

Beispiel

Code Block

title	CSV-Rückgabe-Format - ohne Parameter "show_desc":

"DATE";"VEHICLE";"DRIVER";"LAT";"LON";"SAT";"IGNITION";"ENTRY1";"ENTRY2";"ENTRY3";"ENTRY4";"ENTRY5";"ENTRY6";"ENTRY7";"ENTRY8";"ENTRY9";"ENTRY10";"KM";"ORDER";"FORM";"VEHICLE_COST_CENTER";"DRIVER_MA_NUMBER";"RTI_IDENT";"TOURDATA"
;"PARENT_ID";"PARENT_RELATION" "2013-03-28 09:29:17";"DD-AB 123";"Herr Fuchs";"51.036687";"13.599141";"9";"0";"111";"22.12.89";"11:33";"Eintrag5";"TEXT10";"TEXT30";"777.77";"1";"";"";"123456";"AUFTRAG1";"UNTERSCHRIFT";"Kostenstelle XYZ";"MA123456";"IDENT1";null
;"22201eb2fd123df28156bc0c86e0aba2";""

Code Block

title	CSV-Rückgabe-Format - mit Parameter "show_desc":

"DATE";"VEHICLE";"DRIVER";"LAT";"LON";"SAT";"IGNITION";"ENTRY1";"ENTRY2";"ENTRY3";"ENTRY4";"ENTRY5";"ENTRY6";"ENTRY7";"ENTRY8";"ENTRY9";"ENTRY10";"KM";"ORDER";"FORM";"VEHICLE_COST_CENTER";"DRIVER_MA_NUMBER";"RTI_IDENT";"TOURDATA"
";"PARENT_ID";"PARENT_RELATION"  "2013-03-28 09:29:17";"DD-AB 123";"Herr Fuchs";"51.036687";"13.599141";"9";"0";"111";"22.12.89";"11:33";"Eintrag5";"TEXT10";"TEXT30";"777.77";"1";"";"";"123456";"AUFTRAG1";
"{""name"":""UNTERSCHRIFT"",""driver"":false,""entries"":[{""i"":1,""name"":""Ganzzahl"",""type"":""int"",""mand"":true},{""i"":2,""name"":""Datum"",""type"":""date"",""mand"":true},{""i"":3,""name"":""Zeit"",""type"":""time"",""mand"":true},{""i"":4,""name"":""Auswahlbox"",""type"":""sel"",""mand"":false,""spec"":""Eintrag1|Eintrag2|Eintrag8|Eintrag5""},{""i"":5,""name"":""Text"",""type"":""t10"",""mand"":false},{""i"":6,""name"":""Text"",""type"":""t30"",""mand"":false},{""i"":7,""name"":""Flie\u00dfkommazahl"",""type"":""flt"",""mand"":false},{""i"":8,""name"":""Frage"",""type"":""bool"",""mand"":true},{""i"":9,""name"":""Unterschrift"",""type"":""sig"",""mand"":false}]}";"Kostenstelle XYZ";"MA123456";"IDENT1";null
;"22201eb2fd123df28156bc0c86e0aba2";""

JSON Format

Beispiel

Code Block

title	JSON-Rückgabe-Format - ohne Parameter "show_desc":

[{
	"date":"2013-03-28 09:29:17",
	"vehicle":"DD-AB 123",
	"driver":"Herr Fuchs",
	"lat":51.036687,
	"lon":13.599141,
	"sat":9,
	"ignition":0,
	"entry1":"111",
	"entry2":"22.12.89",
	"entry3":"11:33",
	"entry4":"Eintrag5",
	"entry5":"TEXT10",
	"entry6":"TEXT30",
	"entry7":"777.77",
	"entry8":"1",
	"entry9":"",
	"entry10":"",
	"km":"123456",
	"order":"AUFTRAG1",
	"tourData": null,
	"form":"UNTERSCHRIFT",
	"vehicleCostCenter":"Kostenstelle XYZ",
	"driverMaNumber":"MA123456",
	"rtiIdent":"Ident1"
 }]

Code Block

title	JSON-Rückgabe-Format - mit Parameter "show_desc":

[{
,
 	"childForms":[
		{
		  	"date":"2013-03-28 0908:29:17",
			"vehicle":"DD-AB 123",
			"driver":"Herr Fuchs",
			"lat":51.036687,
			"lon":13.599141,
			"sat":9,
			"ignition":0,
			"entry1":"111Text",
			"entry2":"22.12.8999",
			"entry3":"11:33",
			"entry4km":"Eintrag5123456",
			"entry5order":"TEXT10",
			"entry6tourData":"TEXT30" null,
			"entry7form":"777.77Unterformular",
			"entry8vehicleCostCenter":"1Kostenstelle XYZ",
			"entry9driverMaNumber":"MA123456",
			"entry10rtiIdent":"Ident1"
		}
	]
 }]

Code Block

title	JSON-Rückgabe-Format - mit Parameter "show_desc":

[{
	"date":"2013-03-28 09:29:17,
	"km":"123456",
	"order":"AUFTRAG1",
	"tourDatavehicle": null"DD-AB 123",
	"formdriver":{"Herr Fuchs",
	  "namelat": "UNTERSCHRIFT"51.036687,
      "driver": false,
      "entries": [
        	{
          		"i": 1,
          		"name": "Ganzzahl",
          		"type": "int",
          		"mand": true
        	},
        	{
          		"i": 2,
          		"name": "Datum",
          		"type": "date",
          		"mand": true	"lon":13.599141,
	"sat":9,
	"ignition":0,
	"entry1":"111",
	"entry2":"22.12.89",
	"entry3":"11:33",
	"entry4":"Eintrag5",
	"entry5":"TEXT10",
	"entry6":"TEXT30",
	"entry7":"777.77",
	"entry8":"1",
	"entry9":"",
	"entry10":"",
	"km":"123456",
	"order":"AUFTRAG1",
	"tourData": null,
	"form":{
	  "name": "UNTERSCHRIFT",
      "driver": false,
        	},"entries": [
        	{
          		"i": 31,
          		"name": "ZeitGanzzahl",
          		"type": "timeint",
          		"mand": true
        	},
        	{
          		"i": 42,
          		"name": "AuswahlboxDatum",
          		"type": "seldate",
          		"mand": false,
				"spec": "Eintrag1|Eintrag2|Eintrag8|Eintrag5" 
			true
        	},
        	{
          		"i": 53,
          		"name": "TextZeit",
          		"type": "t10time",
          		"mand": falsetrue
        	},
        	{
          		"i": 64,
          		"name": "TextAuswahlbox",
          		"type": "t30sel",
          		"mand": false,
				"spec":        "Eintrag1|Eintrag2|Eintrag8|Eintrag5" 
			},
        	{
          		"i": 75,
          		"name": "FließkommazahlText",
          		"type": "fltt10",
          		"mand": false
        	},
        	{
          		"i": 86,
          		"name": "FrageText",
          		"type": "boolt30",
          		"mand": truefalse
        	},
        	{
          		"i": 97,
          		"name": "UnterschriftFließkommazahl",
          		"type": "sigflt",
          		"mand": false
        	}
		]
	},
	"vehicleCostCenter":"Kostenstelle XYZ",
	"driverMaNumber":"MA123456",
	"rtiIdent":"Ident1"
 }]

JSON_V2 Format

Die Parameter “form” und "custorder" werden ignoriert, wenn der Datentyp “json_v2” verwendet wird.

Beispiel

,
        	{
          		"i": 8,
          		"name": "Frage",
          		"type": "bool",
          		"mand": true
        	},
        	{
          		"i": 9,
          		"name": "Unterschrift",
          		"type": "sig",
          		"mand": false
        	}
		]
	},
	"vehicleCostCenter":"Kostenstelle XYZ",
	"driverMaNumber":"MA123456",
	"rtiIdent":"Ident1",
   	"childForms":[
		{
		  	"date":"2013-03-28 08:29:17",
			"vehicle":"DD-AB 123",
			"driver":"Herr Fuchs",
			"lat":51.036687,
			"lon":13.599141,
			"sat":9,
			"ignition":0,
			"entry1":"Text",
			"entry2":"22.12.99",
			"entry3":"11:33",
			"km":"123456",
			"order":"",
			"tourData": null,
			"form":{
	  				"name": "Unterformular",
      				"driver": false,
      				"entries": [
        				{
          					"i": 1,
          					"name": "Textfeld",
          					"type": "t30",
          					"mand": true
        				},
        				{
          					"i": 2,
          					"name": "Datum",
          					"type": "date",
          					"mand": true
        				},
        				{
          					"i": 3,
          					"name": "Zeit",
          					"type": "time",
          					"mand": true
        				}
					]
			},
			"vehicleCostCenter":"Kostenstelle XYZ",
			"driverMaNumber":"MA123456",
			"rtiIdent":"Ident1"
		}
	] 
 }]

JSON_V2 Format

Die Parameter “form” und "custorder" werden ignoriert, wenn der Datentyp “json_v2” verwendet wird.

Beispiel

Code Block

title	JSON-Rückgabe-Format - mit Parameter "show_desc":

[{
	"date":"2019-11-26T10:51:39+01:00",
	"vehicle":"DD-AB 123",
	"driver":"Herr Fuchs",
	"driverMaNumber":null,
	"lat":51.036687,
	"lon":13.599141,
	"textPos": "D-01723 Wilsdruff (Kesselsdorf), Am Wüsteberg 3",
	"sat":9,
	"ignition":0,
	"km":123456,
	"order":null,
	"orderMeta":null,
	"tourData": null,
	"vehicleCostCenter":null,
	"rtiIdent":null,
	"formName":"Beispielformular",
	"formDriverMandatory":true,
	"insertDate": "2020-07-22T16:08:00+02:00",
    "completeDate": "2020-07-22T16:08:00+02:00",
	"fields":
			[{
				"id":1,
				"name":"Fließkommazahl",
				"isMandatory":true,
				"type":"flt",
				"value":"111.11",
				"isIncomplete": false            
			},
			{
				"id":2,
				"name":"Text10",
				"isMandatory":true,
				"type":"t10",
				"value":"Text10",
				"isIncomplete": false
			},
			{
				"id":3,
				"name":"Text30",
				"isMandatory":true,
				"type":"t30",
				"value":"Text30",
				"isIncomplete": false
			},
			{
				"id":4,
				"name":"Text500",
				"isMandatory":true,
				"type":"t500",
				"value":"Text500",
				"isIncomplete": false
			},
			{	
				"id":5,
				"name":"Ganzzahl",
				"isMandatory":false,
				"type":"int",
				"value":"555",
				"isIncomplete": false
			},
			{
				"id":6,
				"name":"Bild",
				"isMandatory":false,
				"type":"img",
				"value":"48f5g3d04d177d95hs12182c39410a17e",
				"isIncomplete": false
			},
			{
				"id":7,
				"name":"Unterschrift",
				"isMandatory":false,
				"type":"sig",
				"value":"f7al12t4d177dfac0d2162f39410a17e",
				"isIncomplete": false
			},
			{
				"id":8,
				"name":"Auswahlbox",
				"isMandatory":false,
				"type":"sel",
				"value":"Eintrag 1",
				"selectionList":
								[
									"Eintrag 1",
									"Eintrag 2",
									"Eintrag 3",
									"Eintrag 4",
									"Eintrag 5",
									"Eintrag 6"
								]
			},

Code Block

title	JSON-Rückgabe-Format - mit Parameter "show_desc":

[{
	"date":"2019-11-26T10:51:39+01:00",
	"vehicle":"DD-AB 123",
	"driver":"Herr Fuchs",
	"driverMaNumber":null,
	"lat":51.036687,
	"lon":13.599141,
	"textPos": "D-01723 Wilsdruff (Kesselsdorf), Am Wüsteberg 3",
	"sat":9,
	"ignition":0,
	"km":123456,
	"order":null,
	"orderMeta":null,
	"tourData": null,
	"vehicleCostCenter":null,
	"rtiIdent":null,
	"formName":"Beispielformular",
	"formDriverMandatory":true,
	"insertDate": "2020-07-22T16:08:00+02:00",
    "completeDate": "2020-07-22T16:08:00+02:00",
	"fields":
			[{
				"id":19,
				"name":"FließkommazahlFrage",
				"isMandatory":truefalse,
				"type":"fltbool",
				"value":"111.111",
				"isIncomplete": false            
			},
			{
				"id":210,
				"name":"Text10Datum",
				"isMandatory":truefalse,
				"type":"t10date",
				"value":"Text1010.10.2010",
				"isIncomplete": false
			},
			{
				"id":311,
				"name":"Text30Zeit",
				"isMandatory":truefalse,
				"type":"t30time",
				"value":"Text3011:11",
				"isIncomplete": false
			},
 			{
				"id":412,
				"name":"Text500Formular",
				"isMandatory":truefalse,
				"type":"t500nestedForm",
				"value":"Text500",[ 
				"isIncomplete": false
			{
 						},
			{			"date":"2019-11-26T09:51:39+01:00",
				"id":5,
				"namevehicle":"GanzzahlDD-AB 123",
				"isMandatory":false,
				"typedriver":"intHerr Fuchs",
				"value":"555",
				"isIncompletedriverMaNumber": falsenull,
			},
			{
				"idlat":651.036687,
								"namelon":"Bild"13.599141,
				"isMandatory":false,
				"typetextPos":"img",
 "D-01723 Wilsdruff (Kesselsdorf), Am Wüsteberg 3",
								"valuesat":"48f5g3d04d177d95hs12182c39410a17e"9,
								"isIncompleteignition": false0,
			},
			{
				"idkm":7123456, 
								"nameorder":"Unterschrift",
				"isMandatory":false,
				"typeorderMeta":"sig",
				"value":"f7al12t4d177dfac0d2162f39410a17e",
				"isIncompletetourData": falsenull,
			},
			{
				"idvehicleCostCenter":8null,
								"namertiIdent":"Auswahlbox"null,
				"isMandatory":false,
				"typeformName":"selUnterformular",
				"value":"Eintrag 1"				"formDriverMandatory":false,
								"selectionListfields":[
											[{
									"Eintrag 1",
			"id":1,
												"Eintrag 2"name":"Textfeld",
												"Eintrag 3isMandatory":false,
									"Eintrag 4			"type":"t30",
									"Eintrag 5			"value":"Text",
												"Eintrag 6isIncomplete":false
								]
			},
											{
												"id":92,
												"name":"FrageBild",
												"isMandatory":false,
												"type":"boolimg",
												"value":"1"null,
												"isIncomplete": false
											},
											{
												"id":103,
												"name":"DatumUnterschrift",
												"isMandatory":false,
												"type":"datesig",

												"value":"10.10.2010"null,
												"isIncomplete": false
											},
					{
					"id":11],
								"nameinsertDate":"Zeit2019-11-26T09:53:39+01:00",
				"isMandatory":false,
				"typecompleteDate":"time",2019-11-26T09:53:39+01:00"
							}
				"value":"11:11"],
				"isIncomplete": false
			}
  ]}

Beispielaufrufe

Code Block

title	Für ein Fahrzeug im August 2015 und Auftragsnummer 123456

https://map.yellowfox.de/rti/get_custom_form_data.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&custorder=123456&start=20150801000000&end=20150831235959

https://map.yellowfox.de/rti/get_custom_form_data.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&custorder=123456&start=20150801000000&end=20150831235959

Code Block

title	Für alle Fahrzeuge am 01.08.2015 für Formular "Formular Name"

https://map.yellowfox.de/rti/get_custom_form_data.php?company=COMPANY_RTIKEY&import=IMPORT_RTIKEY&form=Formular+Name&start=20150801000000&end=20150801235959

...

Page tree

Versions Compared

Old Version 80

New Version 81

Key

Beschreibung

Parameter

Rückgabe

CSV Format

Metainformationen

Spalten

Beispiel

JSON Format

Beispiel

JSON_V2 Format

Beispiel

JSON_V2 Format

Beispiel

Beispielaufrufe

Page tree

Page History

Versions Compared

Old Version 80

New Version 81

Key

Beschreibung

Parameter

Rückgabe

CSV Format

Metainformationen

Spalten

Beispiel

JSON Format

Beispiel

JSON_V2 Format

Beispiel

JSON_V2 Format

Beispiel

Beispielaufrufe