Für das Senden von Dokumenten über den JMS-Transport erforderliche Komponenten

Die Kommunikation von Business Integration Connect mit InterChange Server über das JMS-Transportprotokoll setzt voraus, dass diese beiden Komponenten zur Arbeit mit JMS konfiguriert werden. In Tabelle 70 sind diese Konfigurationsschritte zusammengefasst.

Tabelle 70. Konfigurieren von Business Integration Connect und InterChange Server für das JMS-Transportprotokoll
Komponente Version Weitere Informationen in
WebSphere Business Integration Connect 4.2.2

Für ausgehende Dokumente über das JMS-Transportprotokoll konfigurieren

Für eingehende Dokumente über das JMS-Transportprotokoll konfigurieren

WebSphere InterChange Server 4.1.1, 4.2.0, 4.2.1, 4.2.2 ICS-Artefakte für JMS erstellen

Zum Senden oder Empfangen eines Dokuments zwischen Business Integration Connect und InterChange Server über das JMS-Transportprotokoll verwenden Sie außerdem die ICS-kompatiblen Komponenten, die in Tabelle 71 aufgeführt sind.

Tabelle 71. Erforderliche Komponenten zur Übertragung von Dokumenten von und an InterChange Server über JMS
Komponente Beschreibung Anmerkungen und Einschränkungen

WebSphere Business Integration Adapter für JMS

(Adapter für JMS)

Dieser Adapter gibt InterChange Server die Möglichkeit, Geschäftsobjekte mit Anwendungen auszutauschen, die Daten in Form von JMS-Nachrichten senden oder empfangen. Der Adapter für JMS und Business Integration Connect kommunizieren über JMS-Warteschlangen.

  1. Stellen Sie sicher, dass Sie den Adapter für JMS Version 2.3.1 (oder eine höhere Version) verwenden, der Unterstützung für angepasste Headereigenschaften bietet. Vergewissern Sie sich anhand der Adapterdokumentation, dass die Version des Adapters mit der von Ihnen verwendeten Version von InterChange Server kompatibel ist.
  2. Der Adapter für JMS unterstützt lediglich JMS-Textnachrichten. Wenn Sie beabsichtigen, JMS-Bytenachrichten zu verwenden, nehmen Sie den Adapter für JMS Version 2.5.0.

Ein Payload-Data-Handler Dieser Data-Handler konvertiert die Nutzinformationen zwischen dem Dokumentformat und der entsprechenden Geschäftsobjektdarstellung. Weitere Informationen finden Sie in Payload-Data-Handler angeben.
Attachment-Data-Handler

Dieser Data-Handler konvertiert Dokumente mit Anhängen in Geschäftsobjekte.

Dieser Data-Handler ist nur für Dokumente mit Anhängen erforderlich. Weitere Informationen finden Sie in Dokumente mit Anhängen verarbeiten.

In den folgenden Abschnitten wird beschrieben, wie die Komponenten in Tabelle 71 zusammenarbeiten, um Dokumente zwischen Business Integration Connect und InterChange Server über das JMS-Transportprotokoll zu senden und zu empfangen.

Dokumente über den JMS-Transport senden

Beim Senden eines Dokuments von Business Integration Connect an InterChange Server über das JMS-Transportprotokoll verwenden Sie den Adapter für JMS, um die von Business Integration Connect in eine JMS-Warteschlange gestellte Nachricht abzurufen. Der Adapter leitet die Nachricht anschließend an InterChange Server weiter. Abbildung 20 veranschaulicht, wie Business Integration Connect Dokumente an InterChange Server über das JMS-Transportprotokoll sendet.

Abbildung 20. Nachrichtenfluss von Business Integration Connect an eine Collaboration über das JMS-Transportprotokoll


Die folgenden Schritte beschreiben, wie Business Integration Connect an einer Ereignisbenachrichtigung durch Senden eines Dokuments an eine Collaboration innerhalb von InterChange Server über das JMS-Transportprotokoll teilnimmt:

  1. Business Integration Connect übergibt eine Nachricht an die JMS-Ausgangswarteschlange.

    Wenn der Pakettyp des Dokuments 'Back-End-Integrationspaket' ist, wurden von Business Integration Connect angepasste Eigenschaften in dieser Nachricht bereitgestellt. Der JMS-Nachrichtenheader 'JMSType' wird mit dem Inhaltstyp (content-type) der Nutzinformationen (payload) definiert.

    Anmerkung:
    Innerhalb von Business Integration Connect müssen Sie ein Gateway konfigurieren, das die JMS-Warteschlange angibt, an die Business Integration Connect die Nachricht sendet und die vom Adapter für JMS abgefragt wird. Weitere Informationen finden Sie in Für ausgehende Dokumente über das JMS-Transportprotokoll konfigurieren.
  2. Wenn der Adapter für JMS eine Nachricht in einer seiner Eingabewarteschlangen erkennt, ruft er die Nachricht ab.

    Die JMS-Warteschlange, die von Business Integration Connect als Ausgangswarteschlange verwendet wird, ist dieselbe Warteschlange, die vom Adapter für JMS als Eingabewarteschlange verwendet wird. Informationen zur Konfiguration dieser Warteschlange finden Sie in JMS-Warteschlangen konfigurieren. Detaillierte Informationen zur Verarbeitung des Adapters für JMS finden Sie im Handbuch Adapter for JMS User Guide.

  3. Der Adapter für JMS versetzt die Nachricht in die eigene Verarbeitungswarteschlange.
  4. Der Adapter für JMS extrahiert den Hauptteil der JMS-Nachricht und ruft einen Data-Handler mit diesem Hauptteil der Nachricht auf. Der Data-Handler konvertiert den Hauptteil der JMS-Nachricht in ein Geschäftsobjekt.
    Anmerkung:
    Wenn Ihre Nachrichten Anhänge haben, können Sie den Attachment-Data-Handler installieren und anschließend den Adapter für JMS so konfigurieren, dass er den Attachment-Data-Handler aufruft, um den Hauptteil der JMS-Nachricht in ein Geschäftsobjekt zu konvertieren. Weitere Informationen finden Sie in Dokumente mit Anhängen verarbeiten.

    Wenn als Pakettyp 'Back-End-Integrationspaket' verwendet wird und das Dokument Anhänge enthält, ist der konfigurierte Data-Handler für die Behandlung der Nutzinformationen und der Anhänge zuständig.

  5. Der Data-Handler gibt das Geschäftsobjekt an den Adapter für JMS zurück.
    Anmerkung:
    Wenn der Attachment-Data-Handler verwendet wurde, enthält dieses Geschäftsobjekt die Nutzinformationen und die Anhänge.
  6. Wenn der Adapter für JMS ein untergeordnetes dynamisches Metaobjekt (angegeben durch cw_mo_conn in den anwendungsspezifischen Informationen auf Geschäftsobjektebene) antrifft, füllt der Adapter die im Geschäftsobjekt vorhandenen benutzerdefinierten JMS-Header mit den in der JMS-Nachricht vorhandenen Headern.
  7. Der Adapter für JMS übermittelt das Geschäftsobjekt im Rahmen einer Subskriptionszustellung an InterChange Server.

Dokumente über den JMS-Transport empfangen

Beim Empfangen eines Dokuments von InterChange Server durch Business Integration Connect über das JMS-Transportprotokoll verwenden Sie den Adapter für JMS, der die Nachricht, die er von InterChange Server empfängt, in eine JMS-Warteschlange stellt, wo sie von Business Integration Connect abgerufen werden kann. Abbildung 21 veranschaulicht, wie Business Integration Connect Dokumente von InterChange Server über das JMS-Transportprotokoll empfängt.

Abbildung 21. Nachrichtenfluss aus einer Collaboration an Business Integration Connect über das JMS-Transportprotokoll


Die folgenden Schritte beschreiben, wie Business Integration Connect an einer Anforderungsverarbeitung teilnimmt, indem es ein Dokument aus einer Collaboration innerhalb von InterChange Server über JMS-Transportprotokoll empfängt.

  1. Die Collaboration innerhalb von InterChange Server führt einen Serviceaufruf an den Adapter für JMS aus, indem sie das Anforderungsgeschäftsobjekt sendet.

    Das Anforderungsgeschäftsobjekt enthält anwendungsspezifische Informationen, die auf ein dynamisches Metaobjekt verweisen, das wiederum die JMS-Headerinformationen der Transportebene enthält, die von Business Integration Connect erwartet werden.

  2. Der Adapter für JMS verwendet einen Data-Handler, um das von der Collaboration gesendete Geschäftsobjekt in eine JMS-Nachricht zu konvertieren.

    Der Adapter liest die Eigenschaften DataHandlerMimeType und DataHandlerConfigMO, um den zu verwendenden Data-Handler zu ermitteln. Weitere Informationen finden Sie in Payload-Data-Handler angeben.

    Anmerkung:
    Wenn Ihre Dokumente Anhänge haben, installieren Sie den Attachment-Data-Handler und konfigurieren anschließend den Adapter für JMS so, dass er den Attachment-Data-Handler aufruft, um das Anforderungsgeschäftsobjekt in ein Dokument mit Anhängen zu konvertieren. Weitere Informationen finden Sie in Dokumente mit Anhängen verarbeiten.
  3. Der Data-Handler konvertiert das Geschäftsobjekt in eine Zeichenfolge und gibt diese an den Adapter für JMS zurück.
  4. Der Adapter für JMS ermittelt aus dem Anforderungsgeschäftsobjekt den Namen des dynamischen Metaobjekts für die angepassten JMS-Eigenschaften.

    Der Adapter durchsucht die anwendungsspezifischen Informationen des Anforderungsgeschäftsobjekts nach dem Tag cw_mo_conn, der das Attribut angibt, in dem das dynamische Metaobjekt enthalten ist. Wenn Sie mit dem Back-End-Integrationspaket für Ihr Dokument arbeiten, können Sie in diesem dynamischen Metaobjekt Headerinformationen der Transportebene angeben.

  5. Der Adapter für JMS durchsucht das dynamische Metaobjekt nach dem Attribut JMSProperties.

    Wenn dieses Attribut Daten enthält, definiert der Adapter die Headerfelder der Transportebene im Anforderungsdokument. Innerhalb des Attributs JMSProperties können Sie außerdem den Standard-JMS-Header des Inhaltstyps (Content-Type) angeben. Weitere Informationen finden Sie in JMS-Headerinformationen erstellen.

  6. Der Adapter für JMS erstellt eine JMS-Nachricht unter Verwendung der vom Data-Handler zurückgegebenen Zeichenfolge. Darüber hinaus legt er alle angepassten Eigenschaften fest, wie sie im dynamischen Metaobjekt definiert sind.
    Anmerkung:
    Die Versionen des Adapters für JMS vor 2.4.1 können nur JMS-Textnachrichten schreiben.
  7. Der Adapter für JMS sendet die resultierende Anforderungsnachricht an die Ausgabewarteschlange.

    Die Warteschlange kann im statischen oder im dynamischen Metaobjekt angegeben werden. Informationen zur Angabe von Warteschlangen finden Sie in JMS-Warteschlangen angeben. Business Integration Connect ist über diese JMS-Warteschlange empfangsbereit, die als zugehörige Eingangswarteschlange in der Zieldefinition konfiguriert ist. Weitere Informationen finden Sie in Für eingehende Dokumente über das JMS-Transportprotokoll konfigurieren.

  8. Business Integration Connect empfängt die Nachricht aus der zugehörigen JMS-Eingangswarteschlange, die als Ziel konfiguriert ist.

Anmerkung:
Business Integration Connect unterstützt nur eine asynchrone Interaktion mit InterChange Server über JMS. Daher ist es vielleicht nicht sinnvoll, auf die Antwort zu warten. Die Antwort vom Community-Teilnehmer oder von Business Integration Connect kann über eine andere Warteschlange erfolgen. Sie können den Adapter für JMS so konfigurieren, dass er diese Warteschlange abfragt. Die Antwort, die über die Warteschlange kommt, kann dann im Rahmen der Ereigniszustellung an InterChange Server geleitet werden.

Copyright IBM Corp. 1997, 2004