Wiki-Quellcode von do_order.asp
Zuletzt geändert von YellowFox_RD am 2025/01/20 15:37
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | (% class="box" %) | ||
| 2 | (((Inhaltsverzeichnis))) | ||
| 3 | {{toc/}} | ||
| 4 | |||
| 5 | (% class="red mark" %)DEPRECATED(%%) | ||
| 6 | Erstellt einen Auftrag und sendet diesen an das angegebene Fahrzeug | ||
| 7 | = Beschreibung = | ||
| 8 | **do_order.asp****?company**=//COMPANY_RTIKEY//**&vehicle**=//VEHICLE_RTIKEY//**&customorderid**=//NR123XYZ//**&order****text**=//Auftragstext&**lat**=51.0374&**lon**=13.587813// | ||
| 9 | = Parameter = | ||
| 10 | |=Parameter|=Beschreibung|=Typ|=Hinweis|=Pflicht | ||
| 11 | |company|RTI Firmenschlüssel|string||ja | ||
| 12 | |customorderid|eigene Auftragsnummer|string|max. 20 Zeichen (eigene Auftragsnummer wird nicht auf Duplikate geprüft)|ja | ||
| 13 | |ordertext|Auftragstext|string|max. 500 Zeichen (CE Display, Tablet) | ||
| 14 | max. 200 Zeichen (restliche Displays)|ja | ||
| 15 | |vehicle|RTI Fahrzeugschlüssel|string||ja | ||
| 16 | |lat|Latitude des Navigationsziels|float|-90 bis +90 im Format WGS84|ja bei Garmin Displays | ||
| 17 | |lon|Longitude des Navigationsziels|float|-180 bis +180 im Format WGS84|ja bei Garmin Displays | ||
| 18 | |street|Straßenname des Navigationsziels|string|max. 100 Zeichen|nein | ||
| 19 | |hnr|Hausnummer des Navigationsziels|string|max. 10 Zeichen|nein | ||
| 20 | |zipcode|Postleitzahl des Navigationsziels|string|max. 10 Zeichen|nein | ||
| 21 | |city|Stadt des Navigationsziels|string|max. 100 Zeichen|nein | ||
| 22 | |country|Ländercode des Navigationsziels|string|max. 3 Zeichen|nein | ||
| 23 | |target_time|Vorgabeankunftszeit|datestring|Format: YYYYMMDDHHMM | ||
| 24 | verringert die maximale Anzahl der Zeichen des Auftragstextes um 15 Zeichen|nein | ||
| 25 | |sortnumber|Sortiernummer|int|steht am Anfang des Auftragstextes in eckigen Klammern und | ||
| 26 | verringert die Anzahl der Auftragstextzeichen|nein | ||
| 27 | |formname|Name des Benutzerdefinierten Formulares, | ||
| 28 | was nach Abschluss des Auftrages angezeigt werden soll|string|max. 20 Zeichen (verfügbar für CE Displays ab Version 1.1.67 und Tablets) | ||
| 29 | (% class="box" %) | ||
| 30 | ((( | ||
| 31 | **Achtung | ||
| 32 | **Das Formular muss vorher dem Fahrzeug als [[Konfiguration >>doc:YellowFox Standard Portal.Verwaltung.Display Konfiguration.Konfiguration benutzerdefinierte Formulare.WebHome]]gesendet worden sein! | ||
| 33 | )))|nein | ||
| 34 | |textlayout|Layout wie der Auftragstext auf dem Display angezeigt wird|int|((( | ||
| 35 | * 0 = [Sortiernummer][Adresstext][Vorgabeankunftszeit]Auftragstext (Standard) | ||
| 36 | * 1 = [Sortiernummer]Auftragstext[Adresstext][Vorgabeankunftszeit] (nur für Garmin Geräte verfügbar) | ||
| 37 | * 2 = [Sortiernummer][Vorgabeankunftszeit][Adresstext]Auftragstext (nur für Garmin Geräte verfügbar) | ||
| 38 | ))) | ||
| 39 | (% class="box" %) | ||
| 40 | ((( | ||
| 41 | **Achtung | ||
| 42 | **Sortiernummer, Auftragstext und Vorgabeankunftszeit werden nur mit eingefügt, falls diese mit übermittelt worden sind | ||
| 43 | )))|nein | ||
| 44 | |||
| 45 | = Rückgabewerte = | ||
| 46 | Es wird ein **string** zurückgegeben. Bei Erfolg wird als Antwort "**OK**" zurückgegeben. Ansonsten wird ein "(% class="error" %)**ERROR:Beschreibung**(%%)" zurückgegeben | ||
| 47 | = Beispiele = | ||
| 48 | **Einfacher Auftrag** | ||
| 49 | {{code language="java"}}https://map.yellowfox.de/rti/do_order.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&customorderid=NR1234&ordertext=Auftragstext{{/code}} | ||
| 50 | |||
| 51 | **Beispiel mit Navigationsziel und Zielankunftszeit** | ||
| 52 | {{code language="java"}}https://map.yellowfox.de/rti/do_order.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&customorderid=NR1234&ordertext=Auftragstext&lat=51.0374&lon=13.587813&street=Hauptstr&hnr=3&zipcode=01723&city=Kesselsdorf&country=D&target_time=201411310800{{/code}} | ||
| 53 | |||
| 54 | **Beispiel mit Navigationsziel + Formular + Sortiernummer + Textlayout** | ||
| 55 | {{code language="java"}}https://map.yellowfox.de/rti/do_order.asp?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&customorderid=NR1234&ordertext=Auftragstext&lat=51.0374&lon=13.587813&street=Hauptstr&hnr=3&zipcode=01723&city=Kesselsdorf&country=D&sortnumber=1&formname=Abholung&textlayout=2{{/code}} | ||
| 56 |