Das SAPPER Paket

Dieses Handbuch beschreibt die Verwendung der DLE zur Compliance Prüfung von Adressen mittels des Domino Produktes von Sapper.
Näheres zur Compliance Prüfung, dem Domino Produkt und Sapper finden sie unter www.sapper.de.
Das Handbuch setzt Kenntnisse über die Architektur und Benutzung der DLE voraus. Hier werden nur die Erweiterungen im Rahmen der Compliance Prüfung beschrieben.
Wer sich näher mit dem Thema Compliance beschäftigen will, findet auf den Webseiten von Sapper die nötigen Informationen.

Die Definition der zur Compliance Prüfung nötigen Kommandos und Datenstrukturen sind in dem DLE Paket SAPPER zusammengefaßt.

Für die Verwendung des Sapper Paketes werden folgende Dateien benötigt.
Das Verzeichnis ist relativ zum DLE Installationsverzeichnis.

Im Verzeichnis lib/sapper befinden sich alle benötigten Bibliotheken und Skripte für die Verwendung des SAPPER Paketes. Das Skript lib/sapper/sapper.bat fügt die nötigen Bibliotheken der Bibliotheksliste der DLE hinzu. Aufgerufen wird das Skript von dem modifizierten zentralen Startskript etc/scripts/launch.bat mit der Zeile:

…
if exist %DLE_HOME%\etc\scripts\custom.bat call
%DLE_HOME%\etc\scripts\custom.bat
if exist %DLE_HOME%\lib\sapper\sapper.bat call
%DLE_HOME%\lib\sapper\sapper.bat
set CLASSPATH=%CLASSPATH%;%DLE_HOME%\bin
…

Die Compliance Prüfung von Adressen wird durch einen Webservice durchgeführt. Dieser muß konfiguriert werden, bevor die Compliance Funktionalität genutzt werden kann. Dazu wird ein neuer Service in der DLE Session Konfiguration definiert und mit entsprechenden Parametern versehen:

<Service
name="DominoWebService"
class="at.visionflow.dle.sapper.DLEDominoWebService">
<Properties>
<Property name="ServiceAddress"
value="http://api.dominowatch.com/dominorealtime.asmx"/>
<Property name="ServiceName"
value="DominoRealTimeSoap"/>
<Property name="User" value="username"/>
<Property name="Password" value="xxxxxx"/>
<Property name="Timeout" value="20"/>
</Properties>
</Service>

Name und Klasse des Services sind dabei fix vorgegeben. Zu diesem Service gibt es vier konfigurierbare Parameter, die den Zugriff auf den Service steuern.

Das Kennwort muß 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 Sapper Paket im Brickeditor verwendet werden kann, muß das Paket in die Paketliste der DLE Session Konfiguration aufgenommen werden. Dazu ist das Paket SAPPER im Parameter ListOfPackages hinzuzufügen:

<Property name="ListOfPackages" value="BASE;DPE;DLE;SAPPER"/>

Die Paketliste ist eine durch Semikolon getrennte Aufzählung der Pakete, die im Brickeditor zur Verfügung stehen.