OftpService
Der OFTPService erlaubt es, Datenübertragungen per Odette-Filetransfer gemäß VDA 4914-2 zu empfangen und nachfolgenden Prozessen zur Verfügung zu stellen. Die Kommunikation kann dabei über ISDN oder TCP/IP erfolgen.
Für den Betrieb mittels ISDN ist dafür eine CAPI-fähige ISDN-Karte und ein auf dem System installierter CAPI-Treiber notwendig, über den die ISDN-Karte programmtechnisch angesprochen werden kann.
Da für die Anbindung per Java eine sogenannte JNI-Schicht eingesetzt werden muss, ist je nach verwendendetem Betriebssystem das Kompilieren einer speziellen C-Datei erforderlich. Für folgende Betriebssysteme existieren bereits vorkompilierte Dateien.
Alle unterstützten Windows-Versionen.
Linux-Systeme mit CAPI-2.0-Treibern (kein l4i).
Ähnlich wie schon beim FTPService beschrieben, werden eingetroffene Daten per MessageService weitergereicht an nachfolgende Prozesse. Welcher Kontext und welche Queue hierbei eingesetzt werden soll, muss entsprechend eingestellt werden.
XML-Konfiguration
Wichtiger Hinweis: Die Verfügbarkeit eines Services hängt von der erworbenen Lizenz ab und davon, ob der Service innerhalb der Konfigurationsdatei ./etc/factory.xml der Service-Factory eingetragen wurde (Änderungen erfordern Server-Neustart!). Dort finden Sie auch die zuständige Konfigurationsdatei für einen Service, ansonsten können Sie die Konfigurationsdatei des Services auch direkt in der GUI des Services bearbeiten (Änderungen erfordern Service-Neustart!).
Folgendes XML-Fragment mit allen möglichen Basiseinstellungen kann für die Konfiguration des OFTPServices verwendet werden.
<Set name="controller">1</Set><Set name="ignoreTooBigTransferedSize" type="boolean">false</Set><Set name="maximumReceieverThreads">2</Set>Hierbei haben die einzelnen Parameter die folgende Bedeutung.
|
controller |
Der für den Zugriff auf das CAPI-System zu verwendende Controller. Ein Controller entspricht hierbei üblicherweise einer ISDN-Karte. Wird kein expliziter Controller angegeben, wird der erste verfügbare Controller verwendet. |
|
ignoreTooBigTransferedSize |
Manche per OFTP-Daten sendende Systeme liefern am Ende des Transfers falsche Angaben über die Menge an übertragenen Daten. Standardmäßig wird diese daher ignoriert. Soll dieses Verhalten geändert werden, kann dies über diese Einstellung erfolgen. |
|
maximumReceiverThreads |
Gibt die Anzahl an gleichzeitig laufenden Empfangsthreads an. Sind alle Threads mit dem Empfangen von Daten beschäftigt, werden keine weiteren Anrufe mehr angenommen. |
|
traceBaseDirectory |
Sollen die CAPI-Nachrichten mitgeloggt werden, ist das Verzeichnis anzugeben, in das die Meldungen hineingeschrieben werden sollen. Das Tracing selbst startet erst im Verbose-Mode. Da der Datenumfang solch eines Loggings sehr groß werden kann, sollte diese Einstellung nur vorgenommen werden, wenn es gilt, Verbindungsproblemen nachzugehen. |
Aktivieren der Message-basierten Benachrichtigung
Folgendes XML-Fragment aktiviert die Benachrichtigung von Applikationen über den MessageService bei eintreffenden Dateien und anderen OFTP-basierten Ereignissen.
<Call name="enableMessageService"> <Arg>MessageService</Arg> <Arg>System</Arg> <Arg>oftp</Arg></Call>Hierbei haben die einzelnen Argumente folgende Bedeutung.
|
MessageService |
Der Name des zu verwendenden MessageServices. Dieser ist im Allgemeinen der im Beispiel zu sehende Name und sollte eigentlich nicht verändert werden müssen. |
|
System |
Der Message-Kontext. |
|
oftp |
Die Message-Queue. |
Aktivieren des TCP/IP-basierten OFTP-Servers
Folgendes XML-Fragment aktiviert den TCP/IP-basierten Empfang.
<Call name="enableTCPListener"> <Arg>listenaddress</Arg> <Arg type="int">port</Arg> <Arg type="int">nrThreads</Arg></Call>Hierbei haben die einzelnen Parameter die folgende Bedeutung.
|
listenaddress |
Die Adresse, auf der auf eingehende Anfragen gehorcht werden soll. Soll dies auf allen verfügbaren Interfaces passieren, ist 0.0.0.0 zu verwenden. |
|
nrThreads |
Anzahl der Threads, die auf eingehende Anfragen warten sollen. |
Setzen der zu verwendenden MSN beim Annehmen von Anrufen
Folgendes XML-Fragment führt zum Einschränken der MSN für das Annehmen von Anrufen.
<Call name="setLocalListenNumber"> <Arg> <New class="net.sourceforge.jcapi.message.parameter.CallingPartyNumber"> <Set name="number">08154711</Set> </New> </Arg> <Arg> <New class="net.sourceforge.jcapi.message.parameter.CallingPartySubAddress"> <Set name="number">12</Set> </New> </Arg></Call>Dies setzt die zu akzeptierende Nummer auf die Nummer 0815/4711 und die zu verwendende Subaddresse auf 12. Wird keine Subadresse verwendet, ist der Null-Wert zu setzen. Dies erfolgt über das XML-Fragment.
<New class="com.ebd.hub.xml.NullClass"/>Setzen der zu verwendende MSN bei ausgehenden Anrufen
Folgendes XML-Fragment setzt die MSN für ausgehende Anrufe.
<Call name="setCallingNumber"> <Arg> <New class="net.sourceforge.jcapi.message.parameter.CallingPartyNumber"> <Set name="number">08154711</Set> </New> </Arg></Call>Diese Nummer wird vom CAPI-Treiber für ausgehende Anrufe verwendet.
Allgemeine Einstellungen
(1) Auswahl von AuthenticationService, CommunicationLogService und MessageService. Diese Werte müssen normalerweise nicht geändert werden.
(2) Kontext und Queue, mit denen OFTP-Events an den MessageService gesendet werden.
(3) EFID-Größe-Fehler werden ignoriert, wenn diese Einstellung aktiviert ist.
(4) Der OftpService generiert CAPI-Traces, wenn das Basisverzeichnis gesetzt ist und der Service im Verbose-Mode ist. Achtung: Die Traces können sehr viele Daten auf der Festplatte erzeugen.
ISDN-Receiver-Thread-Einstellungen
(1) Anzahl der Threads, die eingehende Anrufe entgegennehmen.
(2) Nummer des verwendeten ISDN-Controllers.
(3) Die zu verwendende MSN für das Annehmen von Anrufen. Siehe Abschnitt Setzen der zu verwendenden MSN beim Annehmen von Anrufen oben.
(4) Timeout für das Warten auf Bestätigung einer Sendung eines B3-Datenblocks.
(5) Die MSN, die beim Senden von Anrufen verwendet wird. Siehe Abschnitt Setzen der zu verwendende MSN bei ausgehenden Anrufen oben.
(6) Die zu verwendende Subaddress der MSN für das Annehmen von Anrufen. Siehe Abschnitt Setzen der zu verwendenden MSN beim Annehmen von Anrufen oben.
TCP-Receiver-Thread-Einstellungen
(1) Anzahl der Threads, die eingehende Requests abarbeiten.
(2) Die IP-Adresse und der Port, an der sich der Service als Listener registriert.
TLS-Receiver-Thread-Einstellungen
(1) Anzahl der Threads, die eingehende Requests abarbeiten.
(2) Die IP-Adresse und der Port, an der sich der Service als Listener registriert.