WebSphere Partner Gateway konfigurieren

Im Abschnitt Hubkonfigurationsprozess wurde eine allgemeine Beschreibung der Arbeitsschritte aufgeführt, die vom Community Operator ausgeführt werden, um den Hub zu konfigurieren. In diesem Abschnitt werden die Schritte zur Konfiguration von WebSphere Partner Gateway zur Verwendung mit einem Back-End-System zusammengefasst. Diese Konfigurationsschritte setzen voraus, dass Sie die Community-Teilnehmer in Ihrer Hub-Community bereits konfiguriert haben. Insbesondere geht dieser Abschnitt von der Annahme aus, dass die folgenden Konfigurationsschritte bereits ausgeführt wurden:

Anmerkung: Sie sollten sich als Community Operator (Hubadministrator) anmelden.

Eine vollständige Beschreibung der Konfiguration von WebSphere Partner Gateway zur Unterstützung einer Hub-Community finden Sie im Handbuch Hub-Konfiguration.

Wenn die Community-Teilnehmer konfiguriert sind, müssen Sie WebSphere Partner Gateway zur Kommunikation mit einem Back-End-System konfigurieren. Dieser Abschnitt enthält die folgenden Informationen zur Einbindung eines Back-End-Systems in Ihre Hub-Community:

Dokumente an das Back-End-System senden

Zum Senden eines Dokuments an das Back-End-System führt WebSphere Partner Gateway die folgenden Schritte aus:

  1. Es empfängt ein Dokument von einem Community-Teilnehmer.

    Die Empfängerkomponente ruft dieses Quellendokument aus einem Ziel ab, das in WebSphere Partner Gateway für eingehende Nachrichten von diesem Community-Teilnehmer und für das zugehörige Transportprotokoll definiert wurde. Beim Senden eines Dokuments an das Back-End-System ist das Quellendokument das von einem Community-Teilnehmer empfangene Dokument, das daher als Teilnehmerdokument bezeichnet wird.

  2. Es konvertiert das Teilnehmerdokument in das Zieldokument, welches das für das Back-End-System erforderliche Format hat.

    Diese Konvertierung in das Zieldokument wird durch den Document Manager von WebSphere Partner Gateway ausgeführt. Beim Senden eines Dokuments an das Back-End-System ist das Zieldokument das an das Back-End-System gesendete Dokument, das daher als Back-End-Dokument bezeichnet wird.

  3. Es sendet das Back-End-Dokument an das Back-End-System.

    Der Document Manager sendet das Back-End-Dokument über ein Gateway, das auf dem Hub für ausgehende Nachrichten an das Back-End-System definiert wurde.

Damit der Hub ein Dokument an das Back-End-System senden kann, müssen Sie daher sicherstellen, dass die in Tabelle 17 zusammengefassten Konfigurationsschritte innerhalb von WebSphere Partner Gateway ausgeführt wurden.

Tabelle 17. Konfigurationsschritte zum Senden von Dokumenten an das Back-End-System
Konfigurationsschritt Schritte in WebSphere Partner Gateway Weitere Informationen unter...
1. Definieren, wohin das Dokument zu senden ist.

1. Erstellen Sie ein Gateway zum Back-End-System.

Zieleinheit für Teilnehmerdokument definieren
2. Definieren, wie das Dokument zu verarbeiten ist.

2. Erstellen Sie Dokumentenflussdefinitionen für das Quellen- und das Zielformat.

3. Aktivieren Sie die B2B-Funktionalität für die Dokumentenflussdefinition für das an das Back-End-System gesendete Dokument.

4. Erstellen Sie eine Interaktion für Dokumentenflussdefinitionen zwischen der Quellen- und der Zieldokumentenflussdefinition.

Verarbeitungsweise des Teilnehmerdokuments definieren
3. Definieren, wie die Verbindung zum Back-End-System herzustellen ist.

5. Erstellen Sie eine Teilnehmerverbindung, die Dokumente an das Back-End-System sendet.

Verbindungsaufbau zum Back-End-System definieren

Zieleinheit für Teilnehmerdokument definieren

Zum Senden von Dokumenten an das Back-End-System muss im Hub ein Gateway definiert werden. Dieses Gateway gibt das Ziel für die konvertierten Dokumente an. Es definiert also die (als URI angegebene) Position, an die der Hub das Back-End-Dokument sendet. Diese Position stimmt mit der Position überein, an der das Back-End-System für eingehende Nachrichten empfangsbereit ist. Das Gateway identifiziert den Eintrittspunkt in die Unternehmensanwendungsschicht (innerhalb des Back-End-Systems). Innerhalb von WebSphere Partner Gateway ist der Document Manager für die Prüfung auf ein Gateway zuständig. Wenn der Document Manager das Dokument verarbeitet hat, sendet er das konvertierte Dokument an das Back-End-System an der Position, die im Gateway definiert ist.

Gehen Sie wie folgt vor, um in WebSphere Partner Gateway ein Gateway zu definieren:

  1. Klicken Sie auf Kontenadmin > Profile.
  2. Klicken Sie auf Suchen, um eine Liste der Teilnehmer aufzurufen.
  3. Wählen Sie das Symbol Details anzeigen neben dem Namen des Community Managers aus.
  4. Klicken Sie auf Gateways.
  5. Klicken Sie auf Erstellen.

Wenn Sie das Gateway definieren, geben Sie das Transportprotokoll an, das vom Hub und dem Back-End-System zur Übertragung des Back-End-Dokuments verwendet wird. Wie Tabelle 12 zu entnehmen ist, hängt die Auswahl des Transportprotokolls vom Format des Dokuments ab.Das Format beinhaltet den Pakettyp und das Geschäftsprotokoll, die in der zugehörigen Dokumentenflussdefinition definiert sind.

Anmerkung: Weitere Informationen zur Erstellung eines Gateways in WebSphere Partner Gateway finden Sie im Handbuch Hub-Konfiguration.

Die Auswahl des Transportprotokolls hängt außerdem von den Transportprotokollen ab, die von Ihrem speziellen Back-End-System unterstützt werden. Weitere Informationen finden Sie im Kapitel über die Integration Ihres speziellen Back-End-Systems in diesem Handbuch.

Wenn Sie ein gültiges Transportprotokoll für Ihr Dokument ausgewählt haben, können Sie die anderen Informationen angeben, die Sie zur Definition des Gateways in der Anzeige Gateways benötigen.

Verarbeitungsweise des Teilnehmerdokuments definieren

Damit der Document Manager das Teilnehmerdokument verarbeiten kann, muss er das Format kennen, in das dieses Dokument zu konvertieren ist. Das heißt, er muss das Format des Back-End-Dokuments kennen. Als Teil der Back-End-Integration müssen Sie sicherstellen, dass die folgenden Entitäten innerhalb von WebSphere Partner Gateway definiert sind:

Dokumentenflussdefinition definieren

Jede Dokumentenflussdefinition definiert, wie WebSphere Partner Gateway ein bestimmtes Dokument verarbeitet. Sie enthält den Pakettyp und das Geschäftsprotokoll des Dokuments. WebSphere Partner Gateway stellt einige vordefinierte Pakettypen und Protokolldefinitionen zur Verfügung. Wenn diese vordefinierten Formate Ihre Teilnehmer- und Back-End-Dokumente korrekt definieren, müssen Sie keine Dokumentenflussdefinition definieren. Wenn die vordefinierten Formate Ihre Teilnehmer- und Back-End-Dokumente jedoch nicht geeignet definieren, müssen Sie eine gültige Dokumentenflussdefinition für diese Dokumente erstellen. Zur Definition einer Dokumentenflussdefinition in WebSphere Partner Gateway verwenden Sie die Seite Dokumentenflussdefinitionen verwalten (Hubadmin > Hubkonfiguration > Dokumentenflussdefinition > Dokumentenflussdefinition erstellen).

Anmerkung: Weitere Informationen zu vordefinierten Dokumentenflussdefini- tionen sowie zur Erstellung von Dokumentenflussdefinitionen in WebSphere Partner Gateway finden Sie im Handbuch Hub-Konfiguration.

Für die Back-End-Integration muss der Pakettyp des Back-End-Dokuments eine der folgenden Einstellungen haben:

Sie müssen je nach Geschäftsprotokoll Ihres Dokuments und dem speziellen, von Ihnen verwendeten Back-End-System feststellen, welcher dieser Pakettypen zutrifft. Informationen zu Pakettypen für Back-End-Systeme finden Sie im Abschnitt Zu verwendender Pakettyp. Informationen zu unterstützten Back-End-Systemen finden Sie in Vorgehensweise beim Zugriff auf Back-End-Anwendungen.

B2B-Funktionalität zum Senden einstellen

Bevor der Document Manager das Quellendokument konvertieren kann, muss er feststellen, ob er das Format des gewünschten Zieldokuments verarbeiten kann. Hierzu überprüft der Document Manager die B2B-Funktionalität des Community Manager-Profils, in der festgelegt ist, welche Dokumentenflussdefinitionen für den Community Manager aktiviert wurden. Bei unterstützten Dokumentenflussdefinitionen sind alle zugehörigen Komponentendokumenttypen (wie Pakettyp, Geschäftsprotokoll und Dokument) aktiviert. Zum Aktivieren einer bestimmten Dokumentenflussdefinition verwenden Sie die Anzeige B2B-Funktionalität von WebSphere Partner Gateway. Führen Sie die folgenden Arbeitsschritte aus, um auf diese Anzeige zuzugreifen:

  1. Klicken Sie auf Kontenadmin > Profile> Community-Teilnehmer.
  2. Klicken Sie auf Suchen, um eine Liste der Teilnehmer aufzurufen.
  3. Wählen Sie das Symbol Details anzeigen neben dem Namen des Community Managers aus.
  4. Klicken Sie auf B2B-Funktionalitäten.
  5. Stellen Sie für die Back-End-Integration sicher, dass alle Komponentendokumenttypen für das Back-End-Dokument aktiviert wurden, so dass sie als Ziel verwendet werden können. Aktivieren Sie hierzu unter Ziel festlegen alle Dokumenttypkomponenten in der Dokumentenflussdefinition des Back-End-Dokuments.
  6. Wenn der Hub außerdem Dokumente vom Back-End-System empfangen soll, ist es möglicherweise sinnvoll, auch die dazu erforderliche B2B-Funktionalität zu aktivieren, solange die Anzeige B2B-Funktionalität noch geöffnet ist. In diesem Fall können Sie unter Quelle festlegen die Dokumenttypkomponente des Back-End-Dokuments aktivieren.

Anmerkung: Weitere Informationen zur Konfiguration der B2B-Funktionalität in WebSphere Partner Gateway finden Sie im Handbuch Hub-Konfiguration.
Dokumentenflussinteraktion zum Senden definieren

Damit der Document Manager feststellen kann, wie ein bestimmtes Teilnehmerdokument konvertiert werden muss, ist es erforderlich, dass die Dokumentenflussinteraktion lokalisiert werden kann, die die Dokumentenflussdefinitionen für das Teilnehmerdokument und das Back-End-Dokument kombiniert und angibt, wer der Quellen- und wer der Zielteilnehmer ist.

Wenn der Document Manager bereit ist, das konvertierte Dokument an das Back-End-System zu senden, muss er eine Teilnehmerverbindung zwischen dem Quellenteilnehmer und dem Zielteilnehmer (Back-End-System) lokalisieren können. Damit eine Teilnehmerverbindung definiert werden kann, muss jedoch eine gültige Interaktion zwischen dem Quellen- und dem Zieldokument vorhanden sein. Zum Definieren einer Interaktion für Dokumentenflussdefinitionen in WebSphere Partner Gateway klicken Sie auf folgende Optionen: Hubadmin > Hubkonfiguration > Dokumentenflussdefinition > Interaktionen verwalten > Interaktion erstellen.

Anmerkung: Weitere Informationen zur Erstellung einer Dokumentenflussdefinition in WebSphere Partner Gateway finden Sie im Handbuch Hub-Konfiguration.

Zum Senden von Dokumenten an das Back-End-System definieren Sie eine Interaktion zwischen dem Quellen- und dem Zieldokument, wie dies in Tabelle 18 zusammengefasst ist.

Tabelle 18. Erstellen einer Interaktion zum Senden eines Dokuments
Abschnitt in 'Interaktionen verwalten' Aktion
Quelle Wählen Sie die Komponentendokumenttypen in der Dokumentenflussdefinition des Teilnehmerdokuments aus.
Ziel Wählen Sie die Komponentendokumenttypen in der Dokumentenflussdefinition des Back-End-Dokuments aus.

Anmerkung: Weitere Informationen zur Erstellung einer Dokumentenflussdefinition in WebSphere Partner Gateway finden Sie im Handbuch Hub-Konfiguration.

Verbindungsaufbau zum Back-End-System definieren

Damit der Document Manager das konvertierte Dokument an das Back-End-System senden kann, muss eine gültige Teilnehmerverbindung ermittelt werden, die den Quellen- und den Zielteilnehmer sowie die Position angibt, über die diese beiden Teilnehmer kommunizieren. Zur Erstellung einer Teilnehmerverbindung verwenden Sie die Seite Verbindungen verwalten in WebSphere Partner Gateway. Klicken Sie auf Kontenadmin > Teilnehmerverbindungen, um auf diese Anzeige zuzugreifen.

Für die Definition einer Teilnehmerverbindung muss bereits eine Interaktion für Dokumentenflussdefinitionen zwischen dem Quellendokument und dem Zieldokument vorhanden sein. In der Anzeige Verbindungen verwalten prüfen Sie zunächst, ob eine Interaktion vorhanden ist, indem Sie den Quellenteilnehmer und den Zielteilnehmer angeben. In Tabelle 19 sind die Teilnehmer der Seite Verbindungen verwalten aufgeführt, die zur Definition einer Teilnehmerverbindung zum Senden eines Dokuments an das Back-End-System auszuwählen sind.

Tabelle 19. Erstellen einer Teilnehmerverbindung zum Senden eines Dokuments
Dropdown-Liste 'Verbindungen verwalten' Name des Community-Teilnehmers
Quelle Name des Community-Teilnehmers, der das Dokument an den Community Manager sendet
Ziel Name des Community Managers, der das Dokument von dem Community-Teilnehmer empfängt

Wenn Sie die Quelle und das Ziel angegeben haben, klicken Sie auf Suchen, um zu überprüfen, ob eine Interaktion für Dokumentenflussdefinitionen vorhanden ist. Wenn keine Interaktion vorhanden ist, müssen Sie eine Interaktion erstellen, bevor Sie mit der Erstellung einer Teilnehmerverbindung fortfahren können. Wenn eine Interaktion vorhanden ist (eine, deren Quelle die Dokumentenflussdefinition des Teilnehmerdokuments und deren Ziel die Dokumentenflussdefinition des Back-End-Dokuments ist) können Sie die Teilnehmerverbindung für die Kommunikation mit dem Back-End-System konfigurieren.

Anmerkung: Weitere Informationen zur Erstellung einer Teilnehmerverbindung in WebSphere Partner Gateway finden Sie im Handbuch Hub-Konfiguration.

Für die Back-End-Integration muss diese Teilnehmerverbindung als Zielgateway das Gateway angeben, das Sie im Abschnitt Zieleinheit für Teilnehmerdokument definieren definiert haben.

Dokumente vom Back-End-System empfangen

Zum Empfangen eines Dokuments vom Back-End-System führt der Hub die folgenden Schritte aus:

  1. Er empfängt ein Dokument vom Back-End-System.

    Die Empfängerkomponente (Receiver) von WebSphere Partner Gateway ruft dieses Quellendokument aus einem Ziel ab, das im Hub für eingehende Nachrichten vom Back-End-System und für das zugehörige Transportprotokoll definiert wurde. Beim Empfangen eines Dokuments vom Back-End-System ist das Quellendokument das vom Back-End-System empfangene Dokument, das daher als Back-End-Dokument bezeichnet wird.

  2. Er konvertiert das Back-End-Dokument in das Zieldokument, das in dem Format codiert ist, das vom Community-Teilnehmer benötigt wird.

    Diese Konvertierung in das Zieldokument wird durch den Document Manager ausgeführt. Beim Empfangen eines Dokuments vom Back-End-System ist das Zieldokument das Dokument, das an den Community-Teilnehmer gesendet wird, das daher als Teilnehmerdokument bezeichnet wird.

  3. Er sendet das Teilnehmerdokument an den vorgesehenen Community-Teilnehmer.

    Der Document Manager sendet das Teilnehmerdokument über ein Gateway, das im Hub für ausgehende Nachrichten an den vorgesehenen Community-Teilnehmer definiert wurde.

Damit der Hub ein Dokument vom Back-End-System empfangen kann, müssen Sie daher sicherstellen, dass die in Tabelle 20 zusammengefassten Konfigurationsschritte innerhalb von WebSphere Partner Gateway ausgeführt wurden.

Tabelle 20. Konfigurationsschritte zum Empfangen von Dokumenten vom Back-End-System
Konfigurationsschritt Schritte in WebSphere Partner Gateway Weitere Informationen unter...
1. Definieren, wo das Dokument abzurufen ist.

1. Erstellen Sie ein Ziel, das vom Back-End-System eingehende Nachrichten empfängt.

Abrufposition für Back-End-Dokumente definieren
2. Definieren, wie das Dokument zu verarbeiten ist.

2. Erstellen Sie Dokumentenflussdefinitionen für das Quellen- und das Zielformat.

3. Aktivieren Sie die B2B-Funktionalität für die Dokumentenflussdefinition für das vom Back-End-System empfangene Dokument.

4. Erstellen Sie eine Interaktion für Dokumentenflussdefinitionen zwischen der Quellen- und der Zieldokumentenflussdefinition.

Verarbeitungsweise des Back-End-Dokuments definieren
3. Definieren, wie die Verbindung zu WebSphere Partner Gateway herzustellen ist.

5. Erstellen Sie eine Teilnehmerverbindung, die Dokumente an WebSphere Partner Gateway sendet.

Verbindungaufbau zu WebSphere Partner Gateway definieren

Abrufposition für Back-End-Dokumente definieren

Zum Empfangen von Dokumenten vom Back-End-System muss im Hub ein Ziel definiert werden. Dieses Ziel gibt die Quelle der Dokumente, d. h. die Position (in Form einer URI) an, unter der der Hub für eingehende Dokumente empfangsbereit ist. Diese Position stimmt mit der Position überein, an die das Back-End-System Dokumente sendet. Das Ziel identifiziert den Eintrittspunkt in die Empfängerkomponente (Receiver) innerhalb von WebSphere Partner Gateway. In WebSphere Partner Gateway prüft die Empfängerkomponente, ob ein Ziel vorhanden ist. Wenn die Empfängerkomponente das Dokument verarbeitet hat, speichert sie das konvertierte Dokument im persistenten gemeinsamen Speicher zum späteren Abrufen durch den Document Manager.

Zum Definieren eines Ziels innerhalb von WebSphere Partner Gateway klicken Sie auf Hubadmin > Hubkonfiguration > Ziele.

Anmerkung: Weitere Informationen zur Erstellung eines Ziels in WebSphere Partner Gateway finden Sie im Handbuch Hub-Konfiguration.

Wenn Sie das Ziel definieren, geben Sie das Transportprotokoll an, das vom Hub und dem Back-End-System zur Übertragung des Back-End-Dokuments verwendet wird. Wie Tabelle 13 zu entnehmen ist, hängt die Auswahl des Transportprotokolls vom Format des Dokuments ab.Das Format beinhaltet den Pakettyp und das Geschäftsprotokoll, die in der zugehörigen Dokumentenflussdefinition definiert sind.

Anmerkung: Die Auswahl des Transportprotokolls hängt außerdem von den Transportprotokollen ab, die von Ihrem speziellen Back-End-System unterstützt werden. Weitere Informationen finden Sie im Kapitel über die Integration mit Ihrem speziellen Back-End-System in diesem Handbuch.

Wenn Sie ein gültiges Transportprotokoll für Ihr Dokument ausgewählt haben, können Sie die anderen Informationen angeben, die Sie zur Definition des Ziels in der Anzeige 'Zieldetails' benötigen.

Verarbeitungsweise des Back-End-Dokuments definieren

Damit der Document Manager das Back-End-Dokument verarbeiten kann, muss er das Format kennen, in das dieses Dokument zu konvertieren ist. Das heißt, er muss das Format des Teilnehmerdokuments kennen. Als Teil der Back-End-Integration müssen Sie sicherstellen, dass die in Tabelle 21 zusammengefassten Entitäten in WebSphere Partner Gateway definiert sind.

Tabelle 21. Vorgehensweise zum Konvertieren des Back-End-Dokuments
Schritt Weitere Informationen unter...

1. Es müssen Dokumentenflussdefinitionen zur Definition des Formats des Teilnehmerdokuments und des Formats des Back-End-Dokuments vorhanden sein.

Dokumentenflussdefinition definieren

2. Die B2B-Funktionalität des Community Managers muss eine Aktivierung der Dokumentenflussdefinition des Back-End-Dokuments als Quelle beinhalten.

B2B-Funktionalität zum Empfangen einstellen

3. Eine Interaktion für Dokumentenflussdefinitionen muss vorhanden sein, die das Back-End-Dokument als Quelle und das Teilnehmerdokument als Ziel kombiniert.

Interaktion zum Empfangen definieren
B2B-Funktionalität zum Empfangen einstellen

Eine Zusammenfassung der B2B-Funktionalität, wie sie für die Back-End-Integration erforderlich ist, finden Sie in B2B-Funktionalität zum Senden einstellen.

Falls Sie diesen Arbeitsschritt noch nicht ausgeführt haben, aktivieren Sie nun unter Quelle festlegen die Dokumenttypkomponente des Back-End-Dokuments.

Interaktion zum Empfangen definieren

Eine Zusammenfassung der Interaktionen für Dokumentenflussdefinitionen, wie sie für die Back-End-Integration erforderlich sind, finden Sie in Dokumentenflussinteraktion zum Senden definieren. Dieser Abschnitt enthält eine Zusammenfassung darüber, wie die Interaktion zum Empfangen eines Dokuments vom Back-End-System definiert wird.

Zum Empfangen von Dokumenten vom Back-End-System definieren Sie eine Interaktion zwischen den Dokumentenflussdefinitionen des Quellen- und des Zieldokuments, wie dies in Tabelle 22 zusammengefasst ist.

Tabelle 22. Erstellen einer Interaktion zum Empfangen eines Dokuments
Abschnitt in 'Interaktionen verwalten' Aktion
Quelle Wählen Sie die Komponentendokumenttypen in der Dokumentenflussdefinition des Back-End-Dokuments aus.
Ziel Wählen Sie die Komponentendokumenttypen in der Dokumentenflussdefinition des Teilnehmerdokuments aus.

Verbindungaufbau zu WebSphere Partner Gateway definieren

Damit der Empfänger das Dokument vom Back-End-System abrufen kann, muss eine gültige Teilnehmerverbindung ermittelt werden, die den Quellen- und den Zielteilnehmer sowie die Position angibt, über die diese beiden Teilnehmer kommunizieren. Eine Zusammenfassung der Teilnehmerverbindungen, wie sie für die Back-End-Integration erforderlich sind, finden Sie in Verbindungsaufbau zum Back-End-System definieren.

In Tabelle 23 sind die Teilnehmer der Anzeige Verbindungen verwalten in WebSphere Partner Gateway aufgeführt, die zur Definition einer Teilnehmerverbindung zum Empfangen eines Dokuments vom Back-End-System auszu- wählen sind.

Tabelle 23. Erstellen einer Teilnehmerverbindung zum Empfangen eines Dokuments
Dropdown-Liste 'Verbindungen verwalten' Name des Community-Teilnehmers
Quelle Name des Community Managers
Ziel Name des Community-Teilnehmers, der das Dokument vom Community Manager empfängt

Wenn Sie die Quelle und das Ziel angegeben haben, klicken Sie auf Suchen, um zu überprüfen, ob eine Interaktion für Dokumentenflussdefinitionen vorhanden ist. Wenn keine Interaktion vorhanden ist, müssen Sie eine Interaktion erstellen, bevor Sie mit der Erstellung einer Teilnehmerverbindung fortfahren können.

Wenn eine Interaktion vorhanden ist (eine, deren Quelle die Dokumentenflussdefinition des Back-End-Dokuments und deren Ziel die Dokumentenflussdefinition des Teilnehmerdokuments ist) können Sie die Teilnehmerverbindung für die Kommunikation mit dem Back-End-System konfigurieren.

Anmerkung: Weitere Informationen zur Erstellung einer Teilnehmerverbindung in WebSphere Partner Gateway finden Sie im Handbuch Hub-Konfiguration.

Copyright IBM Corp. 2003, 2005