Umgebung für den Nachrichtenaustausch konfigurieren

Zur Herstellung der Kommunikation zwischen WebSphere Data Interchange und WebSphere Partner Gateway führen Sie die folgenden Einrichtungs- und Konfigurationsschritte aus:

WebSphere MQ-Kommunikation konfigurieren

Der erste Schritt bei der Einrichtung der Umgebung besteht in der Konfiguration der übergreifenden WebSphere MQ-Kommunikation. Mit übergreifender Kommunikation wird das Senden von Nachrichten von einem Warteschlangenmanager zu einem anderen bezeichnet. Der erste Schritt ist das Definieren eines Warteschlangenmanagers (und zuhöriger Objekte) für das WebSphere Data Interchange-System und das WebSphere Partner Gateway-System. Wenn Sie beabsichtigen, Nachrichten in beide Richtungen zu senden, richten Sie auf beiden Systemen einen Quellenwarteschlangenmanager und einen Zielwarteschlangenmanager ein. Im Quellenwarteschlangenmanager definieren Sie einen Absenderkanal, eine Definition für ferne Warteschlange und eine Übertragungswarteschlange. Im Zielwarteschlangenmanager definieren Sie einen Empfängerkanal und eine Zielwarte- schlange.

Anmerkung: Weitere Einzelheiten zur Definition von Warteschlangenmanagern finden Sie in der Dokumentation zu WebSphere MQ.

Dieser Abschnitt zeigt die Werte, die Sie zur Einrichtung der für das Beispielszenario erforderlichen Warteschlangenmanager und der zugeordneten Objekte verwenden würden. In diesem Szenario ist WebSphere MQ Version 5.3 auf beiden Computern (A und B) installiert. Der erste Schritt besteht anschließend in der Erstellung eines Warteschlangenmanagers auf Computer A und Computer B zur Verwendung durch WebSphere Data Interchange bzw. WebSphere Partner Gateway Enterprise Edition.

Anmerkung: Ihr Warteschlangenmanager für WebSphere Data Interchange muss so konfiguriert werden, dass er den WebSphere Data Interchange Server mit Hilfe der Anwendung WDI Adapter auslöst.

Zum Senden von Nachrichten von einem Warteschlangenmanager zu einem anderen unter Verwendung von WebSphere MQ definieren Sie die folgenden Objekte:

Im Beispielszenario fungieren sowohl Computer A als auch Computer B als Absender und Empfänger. Daher müssten Sie eine Reihe von Objekten auf beiden Computer definieren.

In Tabelle 73 sind die Objekte aufgelistet, die Sie erstellen würden, um Computer A und Computer B als Absender und Empfänger einzurichten.

Tabelle 73. Zu erstellende WebSphere MQ-Objekte
WebSphere MQ-Objekt Computer A Computer B

Warteschlangenmanager

WDI32_QM

HUB_QM

Absenderkanal

TO.HUB60

TO.WDI32

Empfängerkanal

TO.WDI32

TO.HUB60

Ferne Warteschlange

EDI_OUT_A

EDI_OUT_B

Übertragungswarteschlange

XMITQ_A

XMITQ_B

Lokale Warteschlange

EDI_IN_A

EDI_IN_B

Lokale Warteschlange

XML_IN_A

XML_IN_B

Lokale Warteschlange

XML_OUT_A

XML_OUT_B

Abb. 30 zeigt den Nachrichtenfluss zwischen Computer A und Computer B sowie die Rolle der in Tabelle 73 aufgelisteten WebSphere MQ-Objekte.

Abbildung 30. Nachrichtenfluss zwischen Computer A und Computer B
Diese Abbildung zeigt die Warteschlangen, die für den Empfang und das Senden von Dokumenten an bzw. von WebSphere Data Interchange konfiguriert sind. Außerdem werden in der Abbildung die Warteschlangen dargestellt, die für den Empfang und das Senden von Dokumenten von bzw. an WebSphere Partner Gateway konfiguriert wurden.

Abhängig von der verwendeten WebSphere MQ-Plattform könnten Sie verschiedene Methoden zum Definieren dieser Objekte verwenden. Zum Beispiel könnten Sie unter Windows die Objekte mit WebSphere MQ Explorer definieren.

WebSphere Data Interchange konfigurieren

Damit WebSphere Data Interchange Nachrichten aus der WebSphere MQ-Warteschlange empfangen und EDI-Nachrichten in eine Warteschlange schreiben kann, müssen Sie Profile im WebSphere Data Interchange Client konfigurieren. Bei Verwendung von WebSphere Data Interchange Client würden Sie die folgenden Profile erstellen, die in den nachfolgenden Abschnitten beschrieben werden:

Im Beispielszenario empfängt WebSphere Data Interchange XML-Nachrichten aus der WebSphere MQ-Warteschlange XML_IN_A und schreibt das Ergebnis der Über- setzung in die WebSphere MQ-Warteschlange EDI_OUT_A. Dieser Vorgang wird als XML-in-EDI-Übersetzung bezeichnet. WebSphere Data Interchange empfängt EDI-Dokumente aus WebSphere Partner Gateway Enterprise Edition in der WebSphere MQ-Warteschlange EDI_IN_A und schreibt das Ergebnis der Übersetzung in XML_OUT_A.

MQSeries(R)-Warteschlangenprofil

Ein MQSeries-Warteschlangenprofil (MQSeries Queue Profile) enthält Informationen über eine WebSphere MQ-Nachrichtenwarteschlange. Tabelle 74 zeigt die Eigenschaften zur Konfiguration der einzelnen Profile.

Tabelle 74. Eigenschaften in einem MQSeries-Warteschlangenprofil
MQ-Eigenschaft Beschreibung
Queue Profile ID (Warteschlangenprofil-ID)

Die eindeutige Kennung zur Benennung des Profils (logischer Name).

Full Queue Name (Vollständiger Warteschlangenname)

Der tatsächliche Name der WebSphere MQ-Warteschlange.

Queue Manager Name (Warteschlangenmanagername)

Der tatsächliche Name des WebSphere MQ-Warteschlangenmanagers.

Description (Beschreibung)

Eine beliebige Zeichenfolge zur Beschreibung des Zwecks des Profils.

Maximum Length (Maximale Länge)

Die größte zulässige Nachricht für die Warteschlange, entsprechend der Definition in WebSphere MQ.

Destructive Reads (Löschende Lesevorgänge)

Falls ausgewählt, veranlassen diese Operationen WebSphere Data Interchange die Nachrichten beim Lesen aus der WebSphere MQ-Warteschlange zu entfernen.

Syncpoint Control (Synchronisationspunktsteuerung)

Wenn ausgewählt, erfolgt das Lesen und Schreiben von Warteschlangennachrichten unter Steuerung eines Synchronisationspunkts. Wenn die Steuerung durch Synchronisationspunkt aktiviert ist, finden Änderungen an einer Nachrichtenwarteschlange erst statt, wenn WebSphere Data Interchange einen Synchronisationspunkt ausgibt.

Da Sie mit den WebSphere MQ-Warteschlangen arbeiten, benötigen Sie für jede Warteschlange ein MQSeries-Warteschlangenprofil in WebSphere Data Interchange. Insgesamt würden Sie vier MQSeries-Warteschlangenprofile erstellen, also eines für jede WebSphere MQ-Warteschlange, die im Nachrichtenfluss verwendet wird. Über den Konfigurationsbereich von WebSphere Data Interchange Client würden Sie folgende Aktionen ausführen:

  1. Erstellen Sie ein MQSeries-Warteschlangenprofil für XML_IN_A und EDI_OU_A.

    In Tabelle 75 sind die tatsächlichen Parameter aufgeführt, die in jedem von Ihnen erstellten MQSeries-Warteschlangenprofil angegeben sind. Die hier dargestellten Warteschlangen werden bei der XML-in-EDI-Übersetzung verwendet.

    Tabelle 75. MQSeries-Warteschlangenprofil für XML_IN_A und EDI_OU_A
    Eigenschaft der Warteschlange Wert für XML_IN_A Wert für EDI_OU_A
    Queue Profile ID (Warteschlangenprofil-ID) XML_IN_A EDI_OU_A
    Full Queue Name (Vollständiger Warteschlangenname) XML_IN_A EDI_OUT_A
    Queue Manager Name (Warteschlangenmanagername) WDI32_QM WDI32_QM
    Destructive Reads (Löschende Lesevorgänge)

    Ausgewählt

    Ausgewählt

    Syncpoint Control (Synchronisationspunktsteuerung)

    Ausgewählt

    Ausgewählt

    Anmerkung: Die Warteschlangenprofil-ID (Queue Profile ID) ist auf maximal acht Zeichen beschränkt. Daher muss die Profil-ID für die Warteschlange EDI_OUT_A den Namen EDI_OU_A erhalten. Alle Verweise auf die WebSphere MQ-Warteschlange EDI_OUT_A in WebSphere Data Interchange verwenden EDI_OU_A.
  2. Erstellen Sie ein MQSeries-Warteschlangenprofil für EDI_IN_A und XML_OU_A. Tabelle 76 zeigt die Eigenschaften für jede einzelne Warteschlange, die bei der EDI-in-XML-Übersetzung verwendet wird.
    Tabelle 76. MQSeries-Warteschlangenprofil für EDI_IN_A und XML_OU_A
    Eigenschaft der Warteschlange Wert für EDI_IN_A Wert für XML_OU_A
    Queue Profile ID (Warteschlangenprofil-ID) EDI_IN_A XML_OU_A
    Full Queue Name (Vollständiger Warteschlangenname) EDI_IN_A XML_OUT_A
    Queue Manager Name (Warteschlangenmanagername) WDI32_QM WDI32_QM
    Destructive Reads (Löschende Lesevorgänge)

    Ausgewählt

    Ausgewählt

    Syncpoint Control (Synchronisationspunktsteuerung)

    Ausgewählt

    Ausgewählt

Netzprofil

Für WebSphere Data Interchange definieren Netzprofile die Merkmale von Netzen, die Sie zur Kommunikation mit Handelspartnern verwenden. Für dieses Szenario würden Sie ein Netzprofil (Network Profile) erstellen und konfigurieren, das mit den zuvor erstellten WebSphere MQ-Warteschlangen kommuniziert.

Tabelle 77 zeigt die Eigenschaften zur Konfiguration des Netzprofils.

Tabelle 77. Eigenschaften in einem Netzprofil
Netzeigenschaft Beschreibung
Network ID (Netz-ID)

Eine eindeutige Kennung zur Benennung des Profils

Communication Routine (Kommunikationsroutine)

Der Name des Programms, das Netzbefehle erstellt und das Netzprogramm zur Verarbeitung der Befehle aufruft

Network Program (Netzprogramm)

Das Programm, das von der Kommunikationsroutine zur Verarbeitung von Anforderungen aufgerufen wird

Network Parameters (Netzparameter)

Für das Netzprogramm erforderliche Parameter

Für dieses Szenario erstellen und konfigurieren Sie wie folgt ein Netzprofil, das mit den zuvor erstellten WebSphere MQ-Warteschlangen kommuniziert (siehe MQSeries(R)-Warteschlangenprofil):

  1. Erstellen Sie ein neues Netzprofil mit dem Namen HUB_IN.

    Dieses Netzprofil wird im XML-in-EDI-Szenario verwendet. In Tabelle 78 sind die tatsächlichen, für HUB_IN angegebenen Parameter aufgeführt.

    Tabelle 78. Netzprofil für HUB_IN
    Netzeigenschaft Wert für das Profil HUB_IN
    Network ID (Netz-ID) HUB_IN
    Communication Routine (Kommunikationsroutine) VANIMQ
    Network Program (Netzprogramm) EDIMQSR
    Network Parameters (Netzparameter) SENDMQ=EDI_OU_A RECEIVEMQ=XML_IN_A
  2. Erstellen Sie ein zweites Netzprofil mit dem Namen HUB_OUT.

    Dieses Netzprofil wird in der Übersetzung von EDI-Dokumenten verwendet, die aus WebSphere Partner Gateway Enterprise Edition empfangen werden. Ein zweites Netzprofil ist erforderlich, weil WebSphere Partner Gateway Enterprise Edition Nachrichten in die WebSphere MQ-Warteschlangen stellt, die RFH2-Header enthalten. In Tabelle 79 sind die Eigenschaften von HUB_OUT aufgeführt.

    Tabelle 79. Netzprofil für HUB_OUT
    Netzeigenschaft Wert für das Profil HUB_OUT
    Network ID (Netz-ID) HUB_OUT
    Communication Routine (Kommunikationsroutine) VANIMQ
    Network Program (Netzprogramm) EDIRFH2
    Network Parameters (Netzparameter) SENDMQ=XML_OU_A RECEIVEMQ=EDI_IN_A

Mailboxprofil

Mailboxprofile enthalten die Informationen, die von WebSphere Data Interchange zur Identifizierung von Einzelpersonen und Gruppen in Ihrer Organisation benötigt werden, die zu übersetzende Dokumente empfangen. Tabelle 80 zeigt die für jedes Mailboxprofil zu konfigurierenden Eigenschaften.

Tabelle 80. Eigenschaften in einem Mailboxprofil
Mailboxeigenschaft Beschreibung
Mailbox ID (Mailbox-ID)

Eine eindeutige Kennung zur Benennung des Profils

Network ID (Netz-ID)

Die Netz-ID des zuvor erstellten Netzprofils

Sie erstellen Mailboxprofile wie folgt für jede einzelne WebSphere MQ-Warteschlange, um die Einzelpersonen und Gruppen in der Organisation anzugeben:

  1. Erstellen Sie ein Mailboxprofil für jede verwendete WebSphere MQ-Warteschlange.

    In Tabelle 81 sind die tatsächlichen Parameter in den einzelnen Mailboxprofilen aufgeführt.

    Tabelle 81. Mailboxprofile für XML_IN_A und EDI_OU_A
    Mailboxeigenschaft Wert für XML_IN_A Wert für EDI_OU_A
    Mailbox ID (Mailbox-ID) XML_IN_A EDI_OU_A
    Network ID (Netz-ID) HUB_IN HUB_IN
    Receive File (Empfangsdatei) XML_IN_A EDI_OU_A
  2. Erstellen Sie ein zweites Paar Mailboxen.

    Tabelle 82 listet die Eigenschaften für jede Mailbox auf.

    Tabelle 82. Mailboxprofile für EDI_IN_A und XML_OU_A
    Mailboxeigenschaft Wert für EDI_IN_A Wert für XML_OU_A
    Mailbox ID (Mailbox-ID) EDI_IN_A XML_OU_A
    Network ID (Netz-ID) HUB_OUT HUB_OUT
    Receive File (Empfangsdatei) EDI_IN_A XML_OU_A

Serviceprofil

Serviceprofile geben Ihnen die Möglichkeit, einen Dienstprogrammbefehl einzugeben und alle Dateien zu definieren, die bei der Ausführung dieses Befehls verwendet werden.

Für das Beispielszenario führen Sie die folgenden Schritte aus:

  1. Erstellen Sie ein neues Serviceprofil (Service Profile) für XML_IN_A. Sie definieren die Eigenschaften auf der Registerkarte General ('Allgemein') wie folgt:

    In Tabelle 83 sind die Eigenschaften für die allgemeinen Dateien ('Common Files') aufgeführt.

    Tabelle 83. Allgemeine Dateien für XML_IN_A
    Eigenschaft 'Common File' Wert

    Tracking File (Überwachungsdatei)

    ..\trk\xml_in.trk

    Exception File (Ausnahmendatei)

    ..\xex\xml_in.xex

    Work File (Arbeitsdatei)

    ..\wrk\xml_in.wrk

    Report File (Berichtsdatei)

    ..\rpt\xml_in.rpt

    Query File (Abfragedatei)

    ..\qry\xml_in.qry

  2. Geben Sie folgende Details auf der Registerkarte Output Files ('Ausgabedateien') ein:
  3. Erstellen Sie ein zweites Serviceprofil für EDI_IN_A. Sie definieren die Eigenschaften auf der Registerkarte General ('Allgemein') wie folgt:

    In Tabelle 84 sind die Eigenschaften für die allgemeinen Dateien ('Common Files') aufgeführt.

    Tabelle 84. Allgemeine Dateien für EDI_IN_A
    Eigenschaft 'Common File' Wert

    Tracking File (Überwachungsdatei)

    ..\trk\edi_in.trk

    Exception File (Ausnahmendatei)

    ..\xex\edi_in.xex

    Work File (Arbeitsdatei)

    ..\wrk\edi_in.wrk

    Report File (Berichtsdatei)

    ..\rpt\edi_in.rpt

    Query File (Abfragedatei)

    ..\qry\edi_in.qry

  4. Geben Sie folgende Details auf der Registerkarte Output Files ('Ausgabedateien') ein:
    Anmerkung: Wegen der Zeichenlängenbeschränkungen wird XML_OU_A an Stelle von XML_OUT_A verwendet. Diese Beschränkung wurde mit CSD10 für WebSphere Interchange Server beseitigt.

Datentransformationszuordnungen importieren und kompilieren

Nach der im vorigen Abschnitt beschriebenen Erstellung der Profile können Sie alle Zuordnungen importieren, die Sie zur Umwandlung Ihrer Daten benötigen. Anschließend kompilieren Sie die Transformationszuordnungen und definieren für jede Zuordnung eine Regel. Diese Aufgaben werden über den WebSphere Data Interchange Client ausgeführt. Informationen dazu finden Sie in der Dokumentation zu WebSphere Data Interchange.

JMS-Umgebung einrichten

Wie zuvor in diesem Kapitel erwähnt, kann WebSphere Partner Gateway Enterprise Edition die WebSphere MQ-Implementierung des Java Message Service (JMS) zur Integration mit WebSphere Data Interchange nutzen.

Anmerkung: Alternativ ist es möglich, LDAP oder WebSphere Application Server als JNDI-Provider zu verwenden.

In diesem zweiten Abschnitt werden die Schritte skizziert, die zur Erstellung einer JMS-Umgebung auf Computer B erforderlich sind:

WebSphere MQ-Klassen für Java und WebSphere MQ-Klassen für JMS sind in WebSphere MQ für Windows, Version 5.3 integriert.

JMSAdmin konfigurieren

Verwenden Sie das Tool JMSAdmin, das in WebSphere MQ zur Verfügung steht, um die JMS-Objekte im JNDI-Format zu erstellen. Informationen zur Erstellung der Standardkonfigurationsdatei JMSAdmin.config finden Sie im Handbuch Hub-Konfiguration.

Zur Erstellung der JMS-Objekte für diesen Lerntext:

  1. Zur Verwendung eines dateibasierten JNDI-Providers würden Sie sicherstellen, dass die Datei 'JMSAdmin.config' die nachfolgenden Zeilen enthielte:
    INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory
     PROVIDER_URL=file:/opt/mqm/java/JNDI
  2. Wenn das Verzeichnis JNDI nicht bereits vorhanden ist, erstellen Sie das Verzeichnis JNDI unterhalb des folgenden Verzeichnisses:
    /opt/mqm/java/bin

Vor dem Aufrufen des Tools JMSAdmin würden Sie sicherstellen, dass die Variable CLASSPATH die folgenden Einträge enthielte:

/opt/mqm/java/lib/jms.jar
 /opt/mqm/java/lib/com.ibm.mq.jar
 /opt/mqm/java/lib/com.ibm.mqjms.jar
 /opt/mqm/java/lib/jta.jar
 /opt/mqm/java/lib/connector.jar
 /opt/mqm/java/lib/jndi.jar
 /opt/mqm/java/lib/providerutil.jar
 /opt/mqm/java/lib/fscontext.jar

Anmerkung: Die obigen Einträge, die sich auf Linux(R) beziehen, setzen voraus, dass Sie mit einer dateibasierten JNDI-Komponente arbeiten.

JMS-Objekte erstellen

Zur Erstellung der erforderlichen JMS-Objekte verwenden Sie das Tool JMSAdmin. Für das Beispielszenario würden Sie wie folgt vorgehen:

  1. Definieren Sie einen neuen Kontext:
    DEF CTX(WdiJms)
  2. Wechseln Sie zu diesem neuen Kontext:
    CHG CTX(WdiJms)
  3. Definieren Sie eine Wartenschlangenverbindungsfactory:
    DEF QCF(HUB60_QM_QCF) TRAN(CLIENT) HOST(IP_COMPUTER_B)
     PORT(9999) CHAN(java.channel) QMANAGER(HUB60_QM)
  4. Definieren Sie die Warteschlange EDI_IN_B:
    DEF Q(EDI_IN_B) QMANAGER(HUB60_QM) QUEUE(EDI_IN_B)
  5. Definieren Sie die Warteschlange EDI_OUT_B:
    DEF Q(EDI_OUT_B) QMANAGER(HUB60_QM) QUEUE(EDI_OUT_B)
  6. Beenden Sie die JMSAdmin-Sitzung:
    END

WebSphere Partner Gateway Enterprise Edition konfigurieren

WebSphere Partner Gateway ist die Übertragungsschicht zwischen unterschiedlichen und voneinander unabhängigen Community-Teilnehmern und internen Prozessen. Wenn Sie WebSphere Partner Gateway zur Arbeit mit EDI-Dokumenten einrichten, können Sie das Produkt zu folgenden Zwecken konfigurieren:

Im Handbuch Hub-Konfiguration finden Sie umfassende Informationen zur Konfiguration von WebSphere Partner Gateway Enterprise Edition und Advanced Edition. Dieser Abschnitt enthält ein Beispiel für die Konfiguration von WebSphere Partner Gateway Enterprise Edition, das im Beispielszenario beschrieben ist. Die folgenden Schritte werden beschrieben:

  1. Teilnehmer erstellen
  2. B2B-Funktionalität einstellen
  3. Gateways erstellen
  4. Interaktion definieren
  5. Teilnehmerverbindungen erstellen
  6. Ziele erstellen

Anmerkung: Informationen zur Konfiguration von WebSphere Partner Gateway - Express finden Sie im Abschnitt WebSphere Partner Gateway - Express konfigurieren.

Teilnehmer erstellen

Ein Teilnehmerprofil identifiziert Unternehmen für das System. Teilnehmer für Partner 1 und Partner 2 werden über die Community Console von WebSphere Partner Gateway Enterprise Edition erstellt.

Teilnehmer für Partner 1 erstellen

Erstellen Sie ein Teilnehmerprofil, um Computer A und Computer B darzustellen, die die beiden Systeme sind, deren Eigner Partner 1 ist.

Zur Erstellung dieses Teilnehmerprofils können Sie folgende Schritte ausführen:

  1. Öffnen Sie die Community Console von WebSphere Partner Gateway.
  2. Melden Sie sich als Hubadmin an.
  3. Überprüfen Sie, ob im Menü Kontenadmin die Option Profile bereits ausgewählt ist.
  4. Klicken Sie auf Erstellen und geben Sie die Details wie in folgender Tabelle 85 aufgeführt ein.
    Tabelle 85. Teilnehmereigenschaften für Partner 1
    Feldname Wert

    Anmeldename des Unternehmens

    partner1

    Anzeigename des Teilnehmers

    Partner 1

    Teilnehmertyp

    Community Manager

    Status

    Aktiviert

    Lieferantentyp

    Andere

    Website

    http://IP_COMPUTER_A

    Dabei ist IP_COMPUTER_A die Internet Protocol-Adresse (IP-Adresse) von Computer A.

    Geschäfts-ID-Typ

    Unformatiert

    Geschäfts-ID-Kennung

    123456789

    Gateway-Typ für IP-Adresse

    Produktion

    IP-Adresse

    IP_COMPUTER_A

    Dabei ist IP_COMPUTER_A die Internet Protocol-Adresse (IP-Adresse) von Computer A.

    Anmerkung: Zur Erstellung des Geschäfts-ID-Typs und der Geschäfts-ID-Kennung klicken Sie zuerst auf die Schaltfläche Neu unter Geschäfts-ID. Die Geschäfts-ID muss eindeutig sein. Analog klicken Sie auf die Schaltfläche Neu unter IP-Adresse, um Details in Bezug auf die IP-Adresse zu erstellen.

  5. Klicken Sie auf Speichern.

WebSphere Partner Gateway Enterprise Edition verwendet die Geschäfts-ID-Kennung (in Tabelle 85 definiert) zur Identifizierung des Absenders oder Empfängers eines Dokuments. Wenn eine ANSI-X12-EDI-Transaktion empfangen wird, werden die Daten der Interchange-Absender- und Empfängerkomponente (Interchange Sender und Receiver) gelesen, um die Quelle und das Ziel der Transaktion zu ermitteln.

Wichtig: Notieren Sie sich das Kennwort des Administrators für Partner 1, da Sie es später benötigen. Wenn Sie sich an der Community Console als Partner 1 anmelden, werden Sie aufgefordert, das Kennwort einzugeben und es anschließend zu ändern.
Teilnehmer für Partner 2 erstellen

Erstellen Sie als Nächstes einen Community-Teilnehmer, um den Partner 2 darzustellen. Zur Erstellung des Teilnehmers führen Sie die folgenden Schritte aus:

  1. Klicken Sie im Hauptmenü auf Kontenadmin und auf Profile in der horizontalen Navigationsleiste.
  2. Klicken Sie auf Erstellen.
  3. Geben Sie die in der folgenden Tabelle 86 aufgeführten Werte ein.
    Tabelle 86. Teilnehmereigenschaften für Partner 2
    Feldname Wert

    Anmeldename des Unternehmens

    partner2

    Anzeigename des Teilnehmers

    Partner 2

    Teilnehmertyp

    Community-Teilnehmer

    Status

    Aktiviert

    Lieferantentyp

    Andere

    Website

    http://IP_COMPUTER_C

    Dabei ist IP_COMPUTER_C die Internet Protocol-Adresse (IP-Adresse) von Computer C.

    Geschäfts-ID-Typ

    Unformatiert

    Geschäfts-ID-Kennung

    987654321

    Gateway-Typ für IP-Adresse

    Produktion

    IP-Adresse

    IP_COMPUTER_C

    Dabei ist IP_COMPUTER_C die Internet Protocol-Adresse (IP-Adresse) von Computer C.

  4. Klicken Sie auf Speichern.
Wichtig: Notieren Sie sich das Kennwort des Administrators für Partner 2, da Sie es später benötigen. Wenn Sie sich an der Community Console als Partner 2 angemeldet haben, werden Sie aufgefordert, das Kennwort einzugeben und es anschließend zu ändern.

B2B-Funktionalität einstellen

Die B2B-Funktionalität wird für jeden Teilnehmer in WebSphere Partner Gateway Enterprise Edition über die Community Console definiert. Nachdem Sie die B2B-Funktionalität für Teilnehmer definiert haben, können Sie eine gültige Dokumen- tenflussdefinition definieren, die zur Unterstützung bestimmter Geschäfts-Colla- boration-Typen zwischen den Teilnehmern verwendet wird.

B2B-Funktionalität für Partner 1 einstellen

Zur Definition der B2B-Funktionalität für Partner 1 führen Sie die folgenden Schritte aus:

  1. Klicken Sie im Hauptmenü auf Kontenadmin und auf Profile in der horizontalen Navigationsleiste.
  2. Klicken Sie auf Suchen, um eine Liste aller im System definierten Teilnehmer anzuzeigen.
  3. Klicken Sie auf das Symbol Details anzeigen neben Partner 1 und anschließend auf B2B-Funktionalität.

Die B2B-Funktionalität wird durch Klicken auf das Symbol Rolle ist nicht aktiv. aktiviert. Für den Zweck dieses Beispiels konfigurieren Sie nur die B2B-Funktionalität, die zur Implementierung dieses Szenarios erforderlich ist.

Zur Festlegung des Quellen- und Zielpakettyps 'Kein Paket' für Partner 1 würden Sie wie folgt vorgehen:

  1. Klicken Sie auf das Symbol Rolle ist nicht aktiv. unter Quelle festlegen für Paket: Kein, um die Option zu aktivieren. Wiederholen Sie diesen Schritt für Ziel festlegen.
  2. Klicken Sie auf das Symbol Erweitern, um weitere Informationen anzuzeigen.
  3. Klicken Sie auf das Symbol Rolle ist nicht aktiv. für Protokoll: EDI-X12 (ALLE) für Quelle und Ziel.
  4. Klicken Sie auf das Symbol Erweitern.
  5. Klicken Sie auf das Symbol Rolle ist nicht aktiv. für Dokumentenfluss: ISA (ALL) für Quelle und Ziel.
B2B-Funktionalität für Partner 2 einstellen

Zur Definition der B2B-Funktionalität für Partner 2 führen Sie die folgenden Schritte aus:

  1. Klicken Sie im Hauptmenü auf Kontenadmin und auf Profile in der horizontalen Navigationsleiste.
  2. Klicken Sie auf Suchen, um eine Liste aller im System definierten Teilnehmer anzuzeigen.
  3. Klicken Sie auf das Symbol Details anzeigen neben Partner 2 und anschließend auf B2B-Funktionalität.

Zur Festlegung des Quellen- und Zielpakettyps 'AS' für Partner 2 würden Sie wie folgt vorgehen:

  1. Klicken Sie auf das Symbol Rolle ist nicht aktiv. unter Quelle festlegen für Paket: AS. Wiederholen Sie diesen Schritt für Ziel festlegen.
  2. Klicken Sie auf das Symbol Erweitern, um weitere Informationen anzuzeigen.
  3. Klicken Sie auf das Symbol Rolle ist nicht aktiv. für Protokoll: EDI-X12 (ALLE) für Quelle und Ziel.
  4. Klicken Sie auf das Symbol Erweitern.
  5. Klicken Sie auf das Symbol Rolle ist nicht aktiv. für Dokumentenfluss: ISA (ALL) für Quelle und Ziel.

Als Nächstes aktualisieren Sie wie folgt die AS-Definition für Partner 2, um sicherzustellen, dass Message Disposition Notifications (MDNs) für AS2, die an Partner 2 gesendet werden, an die richtige Adresse zurückgegeben werden:

  1. Klicken Sie auf das Symbol Bearbeiten.
  2. Geben Sie eine AS-MDN-E-Mail-Adresse an.

    Diese Adresse wird zum Empfangen von MDNs für AS1 verwendet.

  3. Geben Sie eine AS-MDN-HTTP-URL-Adresse ein:
    http://IP_COMPUTER_B:PORT/bcgreceiver/submit
    Anmerkung: Die für AS2 definierte URL-Adresse verwendet die gleichen Parameter, die später in diesem Kapitel für das AS2-Ziel definiert werden.

Gateways erstellen

Ein Gateway in WebSphere Partner Gateway definiert einen Netzpunkt, der als Eingang in ein anderes Netz fungiert. Das Gateway enthält die Informationen, die WebSphere Partner Gateway mitteilen, wie Dokumente an die Enterprise Application Integration-Schicht (EAI-Schicht) zuzustellen sind.

Gateway für Partner 1 erstellen

Partner 2 sendet EDI-Dokumente an Partner 1 über AS2. Das Gateway von Partner 1 wird zum Senden der über AS2 empfangenen EDI-Dokumente an eine JMS-Warteschlange und schließlich an WebSphere Data Interchange zur Übersetzung verwendet.

Zur Erstellung eines neuen Gateways für Partner 1 führen Sie die folgenden Schritte aus:

  1. Klicken Sie im Hauptmenü auf Kontenadmin und auf Profile in der horizontalen Navigationsleiste.
  2. Klicken Sie auf Suchen.
  3. Wählen Sie Partner 1 aus, indem Sie auf das Symbol Details anzeigen klicken und anschließend Gateways auswählen.
  4. Klicken Sie auf Erstellen, um ein neues Gateway für Partner 1 zu erstellen.
  5. Geben Sie die Werte für dieses neue Gateway wie in Tabelle 87 gezeigt ein.
    Tabelle 87. Eigenschaften für das Gateway von Partner 1
    Feldname Wert

    Gateway-Name

    JMStoPartner1

    Transport

    JMS

    Ziel-URI

    file:///opt/mqm/java/JNDI/WdiJms

    JMS-Factory-Name

    HUB60_QM_QCF

    JMS-Nachrichtenklasse

    TextMessage

    JMS-Nachrichtentyp

    TextMessage

    JMS-Warteschlangenname

    EDI_OUT_B

    JMS-JNDI-Factory-Name

    com.sun.jndi.fscontext.RefFSContextFactory

  6. Klicken Sie auf Speichern.

Definieren Sie 'JMStoPartner1' wie folgt als Standardgateway für Partner 1:

  1. Klicken Sie auf Standardgateways anzeigen.
  2. Wählen Sie in der Liste Produktion den Eintrag JMS2toPartner1 aus.
  3. Klicken Sie auf Speichern.
Gateway für Partner 2 erstellen

Partner 1 sendet EDI-Dokumente an WebSphere Partner Gateway Enterprise Edition über eine JMS-Warteschlange. Das Gateway von Partner 2 wird zum Senden der empfangenen EDI-Dokumente an Partner 2 über AS2 verwendet.

Zur Erstellung eines neuen Gateways für Partner 2 führen Sie die folgenden Schritte aus:

  1. Klicken Sie im Hauptmenü auf Kontenadmin und auf Profile in der horizontalen Navigationsleiste.
  2. Klicken Sie auf Suchen.
  3. Wählen Sie Partner 2 aus, indem Sie auf das Symbol Details anzeigen klicken und anschließend Gateways auswählen.
  4. Klicken Sie auf Erstellen, um ein neues Gateway für Partner 2 zu erstellen.
  5. Geben Sie die Werte für dieses Gateway wie in Tabelle 88 gezeigt ein.
    Tabelle 88. Eigenschaften für das Gateway von Partner 2

    Gateway-Name

    AS2toPartner2

    Transport

    HTTP/1.1

    Ziel-URI

    http://IP_COMPUTER_C/input/AS2

    Benutzername

    partner1

    Kennwort

    partner1

  6. Klicken Sie auf Speichern.
    Anmerkung: Der Benutzername und Kennwort wie oben eingegeben beziehen sich auf die Zuordnungsmethode von Teilnehmern für eingehende Dokumente für HTTP (Inbound Participant Mapping Method) wie in WebSphere Partner Gateway - Express definiert.

    Ein Beispiel für die Einstellung dieser Eigenschaften in WebSphere Partner Gateway - Express finden Sie im Abschnitt WebSphere Partner Gateway - Express konfigurieren.

    Beachten Sie, dass 'AS2toPartner2' als 'online' mit dem Status Aktiviert angezeigt wird.

Definieren Sie 'AS2toPartner2' mit folgenden Schritten als Standardgateway für Partner 2:

  1. Klicken Sie auf Standardgateways anzeigen.
  2. Wählen Sie in der Liste Produktion den Eintrag AS2toPartner2 aus.
  3. Klicken Sie auf Speichern.

Interaktion definieren

Eine Dokumentenflussdefinition ist eine Sammlung von "Metainformationen", die die Funktionen zur Dokumentverarbeitung des Teilnehmers definiert. Damit ein System ein Geschäftsdokument verarbeiten kann, müssen zwei oder mehr Dokumentenflussdefinitionen verknüpft werden, um eine Interaktion zu erstellen.

Zur Erstellung einer Interaktion zwischen Partner 1 und Partner 2 führen Sie die folgenden Schritte aus:

  1. Klicken Sie auf Hubadmin im Hauptmenü und auf Dokumentenflussdefinition in der horizontalen Navigationsleiste.
  2. Klicken Sie auf Interaktionen verwalten und anschließend auf Interaktion erstellen.
  3. Wählen Sie in der Spalte 'Quelle' folgende Werte aus:
    1. Paket: Kein Paket
    2. Protokoll: EDI-X12 (ALL)
    3. Dokumentenfluss: ISA (ALL)
  4. Wählen Sie in der Spalte 'Ziel' folgende Werte aus:
    1. Paket: AS
    2. Protokoll: EDI-X12 (ALL)
    3. Dokumentenfluss: ISA (ALL)
  5. Legen Sie die Aktion als Pass-Through fest.
  6. Klicken Sie auf Speichern.
  7. Klicken Sie erneut auf die Option Interaktion erstellen.
  8. Wählen Sie in der Spalte 'Quelle' folgende Werte aus:
    1. Paket: AS
    2. Protokoll: EDI-X12 (ALL)
    3. Dokumentenfluss: ISA (ALL)
  9. Wählen Sie in der Spalte 'Ziel' folgende Werte aus:
    1. Paket: Kein Paket
    2. Protokoll: EDI-X12 (ALL)
    3. Dokumentenfluss: ISA (ALL)
  10. Legen Sie die Aktion als Pass-Through fest.
  11. Klicken Sie auf Speichern.

Teilnehmerverbindungen erstellen

Teilnehmerverbindungen bilden den Mechanismus, der das System in die Lage versetzt, Dokumente zwischen dem Community Manager und seinen verschiedenen Teilnehmern zu verarbeiten und weiterzuleiten. Verbindungen enthalten die erforderlichen Informationen für den ordnungsgemäßen Austausch jedes einzelnen Dokumentenflusses.

Zur Erstellung einer Teilnehmerverbindung zwischen Partner 1 und Partner 2 führen Sie die folgenden Schritte aus:

  1. Klicken Sie im Hauptmenü auf Kontenadmin und auf Teilnehmerverbindungen in der horizontalen Navigationsleiste.
  2. Wählen Sie in der Liste Quelle den Eintrag Partner 1 aus.
  3. Wählen Sie in der Liste Ziel den Eintrag Partner 2 aus.
  4. Klicken Sie auf Suchen.
  5. Aktivieren Sie die Teilnehmerverbindung, die unten angezeigt wird, indem Sie auf die Schaltfläche Aktivieren klicken. Dadurch sollte die B2B-Funktionalität angezeigt werden, die in Tabelle 89 zu sehen ist.
    Tabelle 89. Aktivieren der Teilnehmerverbindung von Partner 1 zu Partner 2
    Dokumentenflusstyp Quelle Ziel

    Paket

    Nein (N/V)

    AS (N/V)

    Protokoll

    EDI-X12 (ALLE)

    EDI-X12 (ALLE)

    Dokumentenfluss

    ISA (ALL)

    ISA (ALL)

Zur Erstellung einer Teilnehmerverbindung, bei der Partner 2 die Quelle und Partner 1 das Ziel ist, führen Sie die folgenden Schritte aus:

  1. Klicken Sie im Hauptmenü auf Kontenadmin und auf Teilnehmerverbindungen in der horizontalen Navigationsleiste.
  2. Wählen Sie in der Liste Quelle den Eintrag Partner 2 aus.
  3. Wählen Sie in der Liste Ziel den Eintrag Partner 1 aus.
  4. Klicken Sie auf Suchen.
  5. Aktivieren Sie die Verbindung mit den in Tabelle 90 gezeigten Details.
    Tabelle 90. Aktivieren der Teilnehmerverbindung von Partner 2 zu Partner 1
    Dokumentenflusstyp Quelle Ziel

    Paket

    AS (N/V)

    Nein (N/V)

    Protokoll

    EDI-X12 (ALLE)

    EDI-X12 (ALLE)

    Dokumentenfluss

    ISA (ALL)

    ISA (ALL)

Ziele erstellen

Die Anzeige der Zielliste stellt Informationen zu Positionen bereit, die es dem Document Manager von WebSphere Partner Gateway ermöglichen, Dokumente von dem entsprechenden System auf der Basis des Transporttyps des eingehenden Dokuments abzurufen. Sie können separate Zielkonfigurationen auf der Basis des Transporttyps erstellen. Der Document Manager kann dann die Positionen von Dokumentrepositorys auf mehreren Web-, FTP- und POP-Mail-Servern, einschließlich interner Verzeichnisse und JMS-Warteschlangen, nach eingehenden Dokumenten abfragen.

Wenn der Document Manager ein Dokument aus der Position auf der Basis eines vordefinierten Ziels abruft, kann die Routinginfrastruktur das Dokument auf der Basis der Kanalkonfiguration verarbeiten.

Zum Empfangen einer EDI-Transaktion von WebSphere Data Interchange erstellen Sie ein neues JMS-Ziel, indem Sie folgende Schritte ausführen:

  1. Klicken Sie im Menü der höchsten Ebene auf Hubadmin.
  2. Klicken Sie im Menü der zweiten Ebene auf Ziele und anschließend auf Erstellen.
  3. Ordnen Sie die in Tabelle 91 gezeigten Eigenschaften zu.
    Tabelle 91. Zieleigenschaften für den Empfang über JMS
    Zieleigenschaft Wert

    Zielname

    WdiJmsListener

    Transport

    JMS

    Gateway-Typ

    Produktion

    JMS-Provider-URL

    file:///opt/mqm/java/JNDI/WdiJms

    JMS-Warteschlangenname

    EDI_IN_B

    JMS-Factory-Name

    HUB60_QM_QCF

    JNDI-Factory-Name

    com.sun.jndi.fscontext.RefFSContextFactory

Ein zweites Ziel ist für den Empfang von EDI-Dokumenten von Partner 2 über AS2 erforderlich. Führen Sie die folgenden Schritte aus, um dieses Ziel zu erstellen:

  1. Klicken Sie im Menü der höchsten Ebene auf Hubadmin.
  2. Klicken Sie im Menü der zweiten Ebene auf Ziele und anschließend auf Erstellen.
  3. Ordnen Sie die Eigenschaften aus der folgenden Tabelle 92 zu:
    Tabelle 92. Zieleigenschaften für den Empfang über AS2

    Zielname

    HubAS2Listener

    Transport

    HTTP/S

    Gateway-Typ

    Produktion

    URI

    /bcgreceiver/submit

    Anmerkung: Die URI für den Empfang von HTTP/S muss immer mit /bcgreceiver beginnen.
  4. Klicken Sie auf Speichern.

Copyright IBM Corp. 2003, 2005