Umgebung für den Nachrichtenaustausch konfigurieren

Zur Herstellung der Kommunikation zwischen WebSphere Data Interchange und Business Integration Connect 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 Business Integration Connect-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 Zielwarteschlange.

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 Maschinen (A und B) installiert. Der erste Schritt besteht anschließend in der Erstellung eines Warteschlangenmanagers auf Maschine A und Maschine B zur Verwendung durch WebSphere Data Interchange bzw. WebSphere Business Integration Connect 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 Maschine A als auch Maschine B als Absender und Empfänger. Daher müssten Sie eine Reihe von Objekten auf beiden Maschine definieren.

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

Tabelle 92. Zu erstellende WebSphere MQ-Objekte
WebSphere MQ-Objekt Maschine A Maschine B

Warteschlangenmanager

WDI32_QM

WBIC42_QM

Absenderkanal

TO.WBIC42

TO.WDI32

Empfängerkanal

TO.WDI32

TO.WBIC42

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

Abbildung 28 zeigt den Nachrichtenfluss zwischen Maschine A und Maschine B sowie die Rolle der in Tabelle 92 aufgelisteten WebSphere MQ-Objekte.

Abbildung 28. Nachrichtenfluss zwischen Maschine A und Maschine B


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 Übersetzung 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 Business Integration Connect Enterprise Edition in der WebSphere MQ-Warteschlange EDI_IN_A und schreibt das Ergebnis der Übersetzung in XML_OUT_A.

MQSeries-Warteschlangenprofil

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

Tabelle 93. 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 mögliche Nachricht für die Warteschlange, wie in WebSphere MQ definiert

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 94 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 94. 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 XML_IN_A EDI_OU_A
    Full Queue Name XML_IN_A EDI_OUT_A
    Queue Manager Name WDI32_QM WDI32_QM
    Destructive Reads

    Ausgewählt

    Ausgewählt

    Syncpoint Control

    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 95 zeigt die Eigenschaften für jede einzelne Warteschlange, die bei der EDI-in-XML-Übersetzung verwendet wird.

    Tabelle 95. 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 EDI_IN_A XML_OU_A
    Full Queue Name EDI_IN_A XML_OUT_A
    Queue Manager Name WDI32_QM WDI32_QM
    Destructive Reads

    Ausgewählt

    Ausgewählt

    Syncpoint Control

    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 96 zeigt die Eigenschaften zur Konfiguration des Netzprofils.

Tabelle 96. 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-Warteschlangenprofil):

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

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

    Tabelle 97. Netzprofil für WBIC_IN
    Netzeigenschaft Wert für das Profil WBIC_IN
    Network ID WBIC_IN
    Communication Routine VANIMQ
    Network Program EDIMQSR
    Network Parameters SENDMQ=EDI_OU_A RECEIVEMQ=XML_IN_A

  2. Erstellen Sie ein zweites Netzprofil mit dem Namen WBIC_OUT.

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

    Tabelle 98. Netzprofil für WBIC_OUT
    Netzeigenschaft Wert für das Profil WBIC_OUT
    Network ID WBIC_OUT
    Communication Routine VANIMQ
    Network Program EDIRFH2
    Network Parameters 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 99 zeigt die für jedes Mailboxprofil zu konfigurierenden Eigenschaften.

Tabelle 99. 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 100 sind die tatsächlichen Parameter in den einzelnen Mailboxprofilen aufgeführt.

    Tabelle 100. 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) WBIC_IN WBIC_IN
    Receive File (Empfangsdatei) XML_IN_A EDI_OU_A

  2. Erstellen Sie ein zweites Paar Mailboxen.

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

    Tabelle 101. 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) WBIC_OUT WBIC_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 102 sind die Eigenschaften für die allgemeinen Dateien ('Common Files') aufgeführt.

    Tabelle 102. 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 103 sind die Eigenschaften für die allgemeinen Dateien ('Common Files') aufgeführt.

    Tabelle 103. 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 anstelle 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 Business Integration Connect 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 Maschine 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 in JNDI zu erstellen. Informationen zur Erstellung der Standardkonfigurationsdatei mit dem Namen JMSAdmin.config finden Sie in Anhang A, JMS-Protokoll mit WebSphere MQ konfigurieren.

Zur Erstellung der JMS-Objekte für diese Anleitung:

  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 beziehen, setzen voraus, dass Sie mit dateibasiertem JNDI 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 Factory für die Zuordnung von Warteschlangen:
    DEF QCF(WBIC42_QM_QCF) TRAN(CLIENT) HOST(IP_MACHINE_B)
     PORT(9999) CHAN(java.channel) QMANAGER(WBIC42_QM)
     
  4. Definieren Sie die Warteschlange EDI_IN_B:
    DEF Q(EDI_IN_B) QMANAGER(WBIC42_QM) QUEUE(EDI_IN_B)
     
  5. Definieren Sie die Warteschlange EDI_OUT_B:
    DEF Q(EDI_OUT_B) QMANAGER(WBIC42_QM) QUEUE(EDI_OUT_B)
     
  6. Beenden Sie die JMSAdmin-Sitzung:
    END
     

Business Integration Connect Enterprise Edition konfigurieren

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

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

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

Anmerkung:
Informationen zur Konfiguration von WebSphere Business Integration Connect - Express finden Sie in Business Integration Connect - 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 Business Integration Connect Enterprise Edition erstellt.

Teilnehmer für Partner 1 erstellen

Erstellen Sie ein Teilnehmerprofil, um die Maschine A und die Maschine 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 Business Integration Connect.
  2. Melden Sie sich als Hub-Administrator an.
  3. Stellen Sie sicher, dass Profile im Menü 'Kontenadmin' bereits ausgewählt ist.
  4. Klicken Sie auf Erstellen und geben Sie die Details wie in folgender Tabelle 104 aufgeführt ein.

    Tabelle 104. Teilnehmereigenschaften für Partner 1
    Feldname Wert

    Teilnehmeranmeldename

    partner1

    Teilnehmername

    Partner 1

    Teilnehmertyp

    Community Manager

    Status

    Aktiviert

    Lieferantentyp

    Andere

    Website

    http://IP_MASCHINE_A

    Dabei ist IP_MASCHINE_A die Internet Protocol-Adresse (IP-Adresse) von Maschine A.

    Geschäfts-ID-Typ

    Unformatiert

    Geschäfts-ID-Kennung

    123456789

    Gateway-Typ für IP-Adresse

    Produktion

    IP-Adresse

    IP_MASCHINE_A

    Dabei ist IP_MASCHINE_A die Internet Protocol-Adresse (IP-Adresse) von Maschine 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 Business Integration Connect Enterprise Edition verwendet die Geschäfts-ID-Kennung (in Tabelle 104 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 angemeldet haben, 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 105 aufgeführten Werte ein.

    Tabelle 105. Teilnehmereigenschaften für Partner 2
    Feldname Wert

    Teilnehmeranmeldename

    partner2

    Teilnehmername

    Partner 2

    Teilnehmertyp

    Community-Teilnehmer

    Status

    Aktiviert

    Lieferantentyp

    Andere

    Website

    http://IP_MASCHINE_C

    Dabei ist IP_MASCHINE_C die Internet Protocol-Adresse (IP-Adresse) von Maschine C.

    Geschäfts-ID-Typ

    Unformatiert

    Geschäfts-ID-Kennung

    987654321

    Gateway-Typ für IP-Adresse

    Produktion

    IP-Adresse

    IP_MASCHINE_C

    Dabei ist IP_MASCHINE_C die Internet Protocol-Adresse (IP-Adresse) von Maschine 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 Business Integration Connect Enterprise Edition über die Community Console definiert. Nachdem Sie die B2B-Funktionalität für Teilnehmer definiert haben, können Sie eine gültige Dokumentenflussdefinition definieren, die zur Unterstützung bestimmter Geschäfts-Collaboration-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 neben Partner 1 und anschließend auf B2B-Funktionalität.

Die B2B-Funktionalität wird durch Klicken auf das Symbol 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 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 , um weitere Informationen anzuzeigen.
  3. Klicken Sie auf das Symbol für Protokoll: EDI-X12 (ALLE) für Quelle und Ziel.
  4. Klicken Sie auf das Symbol .
  5. Klicken Sie auf das Symbol für Dokumentenfluss: Alle 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 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 unter Quelle festlegen für Paket: AS, um die Option zu aktivieren. Wiederholen Sie diesen Schritt für Ziel festlegen.
  2. Klicken Sie auf das Symbol , um weitere Informationen anzuzeigen.
  3. Klicken Sie auf das Symbol für Protokoll: EDI-X12 (ALLE) für Quelle und Ziel.
  4. Klicken Sie auf das Symbol .
  5. Klicken Sie auf das Symbol für Dokumentenfluss: Alle 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_MASCHINE_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 Business Integration Connect definiert einen Netzpunkt, der als Eingang in ein anderes Netz fungiert. Das Gateway enthält die Informationen, die WebSphere Business Integration Connect mitteilen, wie Dokumente an die Enterprise Application Integration-Schicht (EAI-Schicht) zuzustellen sind.

Ein 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 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 106 gezeigt ein.

    Tabelle 106. 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

    WBIC42_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.
Anmerkung:
Ein JMS-Gateway kann nur für den Community Manager definiert werden (Partner 1 im Beispielszenario).

Ein Gateway für Partner 2 erstellen

Partner 1 sendet EDI-Dokumente an WebSphere Business Integration Connect 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 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 107 gezeigt ein.

    Tabelle 107. Eigenschaften für das Gateway von Partner 2

    Gateway-Name

    AS2toPartner2

    Transport

    HTTP/1.1

    Ziel-URI

    http://IP_MASCHINE_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 Business Integration Connect - Express definiert.

    Ein Beispiel für die Einstellung dieser Eigenschaften in WebSphere Business Integration Connect - Express finden Sie in Business Integration Connect Enterprise Edition 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.

Dokumentenflussdefinitionen und Interaktionen 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 Dokumentenflussdefinition und einer gültigen 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 Gültige Interaktion erstellen.
  3. Wählen Sie in der Spalte 'Quelle' folgende Werte aus:
    1. Paket: Kein
    2. Protokoll: EDI-X12
    3. Dokumentenfluss: Alle
  4. Wählen Sie in der Spalte 'Ziel' folgende Werte aus:
    1. Paket: AS
    2. Protokoll: EDI-X12
    3. Dokumentenfluss: ALLE
  5. Legen Sie die Aktion als Pass-Through fest.
  6. Klicken Sie auf Speichern.
  7. Klicken Sie erneut auf die Option Gültige Interaktion erstellen.
  8. Wählen Sie in der Spalte 'Quelle' folgende Werte aus:
    1. Paket: AS
    2. Protokoll: EDI-X12
    3. Dokumentenfluss: ALLE
  9. Wählen Sie in der Spalte 'Ziel' folgende Werte aus:
    1. Paket: Kein
    2. Protokoll: EDI-X12
    3. Dokumentenfluss: Alle
  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 108 zu sehen ist.

    Tabelle 108. Aktivieren der Teilnehmerverbindung von Partner 1 zu Partner 2
    Dokumentenflusstyp Quelle Ziel

    Paket

    Kein (N/V)

    AS (N/V)

    Protokoll

    EDI-X12 (ALLE)

    EDI-X12 (ALLE)

    Dokumentenfluss

    ALLE (ALLE)

    ALLE (ALLE)

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 109 gezeigten Details.

    Tabelle 109. Aktivieren der Teilnehmerverbindung von Partner 2 zu Partner 1
    Dokumentenflusstyp Quelle Ziel

    Paket

    AS (N/V)

    Kein (N/V)

    Protokoll

    EDI-X12 (ALLE)

    EDI-X12 (ALLE)

    Dokumentenfluss

    ALLE (ALLE)

    ALLE (ALLE)

Ziele erstellen

Die Anzeige der Zielliste stellt Informationen zu Positionen bereit, die es dem Document Manager von Business Integration Connect 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 Infrastruktur zur Weiterleitung 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 110 gezeigten Eigenschaften zu.

    Tabelle 110. 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

    WBIC42_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 111 zu:

    Tabelle 111. Zieleigenschaften für den Empfang über AS2

    Zielname

    WbicAS2Listener

    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. 1997, 2004