Show TOC

Module im Message-AustauschLocate this document in the navigation structure

Auf der Grafik sind die Module abgebildet, die am Message-Austausch 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 Java Beans. In aller Regel handelt es sich um stateless Session-Beans. Sie 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.
    Hinweis

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

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

In beiden Fällen können Sie die AS Java und die Adapter-Framework Facades 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 Modul-Przessor des Kommunikationskanals 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 ModulData gespeichert sind, kontrolliert werden:

  • mp.skip

    Setzen Sie den Parameter auf den Wert 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.

    Geben Sie in der Beschreibung des Moduls die Reaktion des Moduls auf den Parameter an. 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 MessageKey -Objekt hinzufügen, das die gegenwärtig zu verarbeitende Message repräsentiert.

    Es wird empfohlen, dass Sie in Senderadaptern den Parameter setzen, damit er an der Performance-Statistikauswertung teilnimmt:

    MessageKey amk = new MessageKey(xiMsgId, MessageDirection.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.

    Haben Sie audit-key gesetzt, können Sie sich Performance-Informationen anzeigen lassen.

    Weitere Informationen: Adapter- und Modul-Performance messen