Erforderliche Komponenten für den Dokumentenversand über den JMS-Transport

Die Kommunikation von WebSphere Partner Gateway mit InterChange Server über das JMS-Transportprotokoll setzt voraus, dass die Komponenten zur Arbeit mit JMS konfiguriert werden. In Tabelle 51 sind diese Konfigurationsschritte zusammengefasst.

Tabelle 51. WebSphere Partner Gateway und InterChange Server für das JMS-Transportprotokoll konfigurieren
Komponente Version Weitere Informationen unter
WebSphere Partner Gateway 6.0

Dokumentenversand über das JMS-Transportprotokoll an ICS konfigurieren

Dokumentenempfang über das JMS-Transportprotokoll von ICS konfigurieren

WebSphere InterChange Server 4.2.2, 4.3 ICS-Artefakte für JMS erstellen

Zum Senden oder Empfangen eines Dokuments zwischen WebSphere Partner Gateway und InterChange Server über das JMS-Transportprotokoll verwenden Sie außerdem die Komponenten, die in Tabelle 52 aufgeführt sind.

Tabelle 52. 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 WebSphere Partner Gateway kommunizieren über JMS-Warteschlangen.

Vergewissern Sie sich, dass der Adapter für JMS, Version 2.7.0 (oder eine höhere Version) verwendet wird. Dieser Adapter bietet Unterstützung für angepasste Headereigenschaften. Prüfen Sie anhand der Adapterdokumentation, ob die Version des Adapters mit der von Ihnen verwendeten Version von InterChange Server kompatibel ist.

Payload-Data-Handler Dieser Data-Handler konvertiert die Nutzinformationen (payload) zwischen dem Dokumentformat und der entsprechenden Geschäftsobjektdarstellung. Weitere Informationen finden Sie im Abschnitt 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 im Abschnitt Dokumente mit Anhängen verarbeiten.

In den folgenden Abschnitten wird beschrieben, wie die Komponenten in Tabelle 52 zusammenarbeiten, um Dokumente zwischen WebSphere Partner Gateway und InterChange Server über das JMS-Transportprotokoll zu senden und zu empfangen.

Dokumentenversand über das JMS-Transportprotokoll

Beim Senden eines Dokuments von WebSphere Partner Gateway an InterChange Server über das JMS-Transportprotokoll verwenden Sie den Adapter für JMS, um die von WebSphere Partner Gateway in eine JMS-Warteschlange gestellte Nachricht abzurufen. Der Adapter leitet die Nachricht dann an InterChange Server weiter. In Abb. 22 ist zusammengefasst, wie WebSphere Partner Gateway über das JMS-Transportprotokoll Dokumente an InterChange Server sendet.

Abbildung 22. Nachrichtenfluss von WebSphere Partner Gateway an eine Collaboration über das JMS-Transportprotokoll
Diese Abbildung zeigt, wie ein Dokument an WebSphere Partner Gateway gesendet wird, wie WebSphere Partner Gateway die JMS-Nachricht an die Eingabewarteschlange des Adapters für JMS sendet, wie dieser den Payload-Data-Handler aufruft und das generierte Geschäftsobjekt anschließend an eine Collaboration sendet.

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

  1. WebSphere Partner Gateway übergibt eine Nachricht an die JMS-Ausgangswarteschlange.

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

    Anmerkung: Innerhalb von WebSphere Partner Gateway müssen Sie ein Gateway konfigurieren, das die JMS-Warteschlange angibt, an die WebSphere Partner Gateway die Nachricht sendet und die vom Adapter für JMS abgefragt wird.
  2. Wenn der Adapter für JMS eine Nachricht in einer seiner Eingabewarteschlangen erkennt, ruft er die Nachricht ab.

    Die JMS-Warteschlange, die von WebSphere Partner Gateway als Ausgangswarteschlange verwendet wird, ist dieselbe Warteschlange, die vom Adapter für JMS als Eingabewarteschlange verwendet wird. Informationen zur Konfiguration dieser Warteschlange finden Sie im Abschnitt 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 im Abschnitt 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.

Dokumentenempfang über das JMS-Transportprotokoll

Beim Empfangen eines Dokuments von InterChange Server durch WebSphere Partner Gateway ü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 WebSphere Partner Gateway abgerufen werden kann. In Abb. 23 ist zusammengefasst, wie WebSphere Partner Gateway über das JMS-Transportprotokoll Dokumente von InterChange Server empfängt.

Abbildung 23. Nachrichtenfluss aus einer Collaboration an WebSphere Partner Gateway über das JMS-Transportprotokoll
Diese Abbildung zeigt, wie ein Geschäftsobjekt von einer Collaboration an den Adapter für JMS gesendet wird, wie dieser den Payload-Data-Handler aufruft und die von diesem generierte JMS-Nachricht an eine Ausgabewarteschlange sendet, aus der sie von WebSphere Partner Gateway abgerufen wird.

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

  1. Die Collaboration innerhalb von InterChange Server führt einen Serviceaufruf an den Adapter für JMS aus, und sendet diesem das Anforderungsgeschäftsobjekt. Das Anforderungsgeschäftsobjekt enthält anwendungsspezifische Informationen, die auf ein dynamisches Metaobjekt verweisen, das wiederum die JMS-Headerinformationen der Transportebene enthält, die von WebSphere Partner Gateway 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 im Abschnitt 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 im Abschnitt 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 im Abschnitt 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.
  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 im Abschnitt JMS-Warteschlangen angeben. WebSphere Partner Gateway ist über diese JMS-Warteschlange empfangsbereit, die als zugehörige Eingangswarteschlange in der Zieldefinition konfiguriert ist.
  8. WebSphere Partner Gateway empfängt die Nachricht aus der zugehörigen JMS-Eingangswarteschlange, die als Ziel konfiguriert ist.

Anmerkung: WebSphere Partner unterstützt über JMS nur asynchrone Interaktionen mit InterChange Server. Daher ist es unter Umständen nicht sinnvoll, auf die Antwort zu warten. Die Antwort vom Community-Teilnehmer oder von WebSphere Partner Gateway 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. 2003, 2005