Dieses Handbuch beschreibt die Verwendung der DLE zur Anbindung an die TomTom WebFleetlösung. Näheres zu TomTom finden sie unter www.TomTom.com. Das Handbuch setzt Kenntnisse über die Architektur und Benutzung der DLE voraus. Hier werden nur die Erweiterungen im Rahmen der TomTom Anbindung beschrieben.
Die zur TomTom Anbindung nötigen Kommandos und Datenstrukturen sind in dem DLE Paket TomTom zusammengefasst.
Für die Verwendung des TomTom Paketes werden folgende Dateien benötigt.
Das Verzeichnis ist relativ zum DLE Installationsverzeichnis.
Datei Verzeichnis Bedeutung
TomTom_DTA.xml etc/packages Metadaten
TomTom_CMD.xml etc/packages Kommandodefinition
TomTom_de.properties etc/resources Deutsche Übersetzung
TomTom.jar lib/ API Library jar
Nachdem die benötigten Dateien in das DLE Verzeichnis kopiert (entpackt) worden sind, können die Paketstammdaten und die Beispielbricks importiert werden.
Die Kommunikation mit dem TomTom System erfolgt über einen Webservice. Dieser muss konfiguriert werden, bevor die TomTom Funktionalität genutzt werden kann. Dazu wird ein neuer Service in der DLE Session Konfiguration definiert und mit entsprechenden Parametern versehen:
<!--
The TomTomWebService gives access to the
TomTom WebFleet System
through a WebService interface. See www.Webfleet.com.
-->
<Service name="TomTomService"
class="at.visionflow.dle.tomtom.http.url.DLETomTomService">
<Properties>
<Property name="UserName" value="XXX" />
<Property name="EncodedPassword" value="XXX" />
<Property name="Account" value="XXX" />
</Properties>
</Service>
Name und Klasse des Services sind dabei fix vorgegeben. Zu diesem Service gibt es drei konfigurierbare Parameter, die den Zugriff auf den Service steuern.
Parameter UserName, Ihr von WebFleet zugeteilter Benutzername. EncodedPassword, Ihr Passwort kodiert und Account, Ihr von WebFleet zugeteilter Account.
Passwortkodierung:
Das Kennwort muss mittels eines Hilfsprogramms verschlüsselt werden. In dem Verzeichnis DLE/etc/scripts befindet sich das Script encodetext.bat. Als Parameter wird der zu verschlüsselnde Text angegeben. Das Programm verschlüsselt den Text und gibt das Ergebnis aus. Dieses ist als Wert im entsprechenden Parameter einzugeben.
Damit das TomTom Paket im Brickeditor verwendet werden kann, muß das Paket in die Paketliste der DLE Session Konfiguration aufgenommen werden. Dazu ist das Paket TomTom im Parameter ListOfPackages hinzuzufügen:
<Property name="ListOfPackages" value="BASE;DLE;TOMTOM"/>
Die Paketliste ist eine durch Semikolon getrennte Aufzählung der Pakete, die im Brickeditor zur Verfügung stehen.
