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.
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
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:
- 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.
- 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.
- Der Adapter für JMS versetzt die Nachricht in die eigene Verarbeitungswarteschlange.
- 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.
- 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.
- 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.
- 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
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.
- 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.
- 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.
- Der Data-Handler konvertiert das Geschäftsobjekt in eine Zeichenfolge und gibt diese an den
Adapter für JMS zurück.
- 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.
- 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.
- 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.
- 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.
- 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.
