Module im Message-Austausch 

Auf der Grafik sind die Module abgebildet, die am Message-Austauschprozess beteiligt sind. Der Zugriff auf Mechanismen des technischen Trace und Log wird ebenfalls gezeigt.

Die grau abgebildeten Blöcke sind Teile des Adapter-Framework. Die weißen Blöcke gehören zum AS Java. Die Blöcke in Orange müssen Sie in der Adapterentwicklung zur Verfügung stellen.

Das Adapter-Framework besteht hauptsächlich aus Enterprise JavaBeans. In aller Regel handelt es sich um stateful Session-Beans. Diese kommunizieren mit den Adaptern über den Enterprise JavaBeans-Container und das JCA-Framework.

Für die Umwandlung des externen Protokolls in das XI-Message-Protokoll haben Sie folgende Möglichkeiten:

●      Sie können die gesamte Protokollabbildung im JCA-Adapter durchführen.

●      Sie können Teile der Abbildung in Enterprise JavaBeans durchführen, die im Modul-Prozessor eingebettet sind.

Implementieren Sie die Abbildungen, die sich auf das Transport-Protokoll beziehen im JCA-Adapter (z.B. Verwaltung eines Ports, Verwaltung einer Verbindung zu einem anderen ERP System oder eine Datenbankverbindung).

Implementieren Sie Abbildungen, die sich auf das Message-Protokoll beziehen (z.B. die Konvertierung einer komma-separierten Payload zu einer XML-Payload) in einem Adapter-Framework-Modul. Dieses Modul kann dann bei verschiedenen Adaptertypen verwendet werden.

In beiden Fällen können Sie die AS Java-Services und die Adapter-Framework Bibliotheken verwenden.

Modul-Prozessor

Der Modul-Prozessor (in der Grafik AF Modul-Prozessor) kontrolliert die Verarbeitungsreihenfolge der Module. Die Module werden in der Reihenfolge aufgerufen, wie sie im Kommunikationskanal eingegeben sind.

Wird zur Laufzeit eine Exception ausgelöst, wird die Verarbeitung unterbrochen und der Auslöser der Exception wird benachrichtigt.

Die Modulverarbeitung kann durch folgende ergänzende Parameter, die in ModulDatagespeichert sind, kontrolliert werden:

●      mp.skip

Setzen Sie den Parameter Boolean.TRUE, können Module, die den Parameter kennen, die Verarbeitung überspringen. Andere Module können den Parameter zurücksetzen, so dass das nachfolgende Modul das Objekt verarbeitet.

In der Beschreibung des Moduls sollte seine Reaktion auf den Parameter beschrieben sein. Ist keine Beschreibung vorhanden, wird angenommen, dass das Modul den Parameter ignoriert.

●      audit.key

Um automatisches Auditing und das Sammeln von Performance-Statistiken zu ermöglichen, müssen Sie ein Parameterobjekt mit dem Schlüssel audit.key dem AuditKey-Objekt hinzufügen, das die gegenwärtig zu verarbeitende Message repräsentiert.

Es wird empfohlen, dass Sie für Senderadapter diesen Parameter setzen, um an der Performance-Statistikauswertung teilnehmen:

AuditKey amk = new AuditMessageKey(xiMsgId, AuditDirection.OUTBOUND);

md.setSupplementalData("mp.skip", Boolean.FALSE); //Default

md.setSupplementalData("audit.key", amk);

...

mp.process(channelId, md);

Weitere Informationen finden Sie im Quellcode des Beispieladapters nach CS_TRAUD START.

Weitere Informationen: Adapter- und Modul-Performance messen