Beispiel: EDI zu XML
Dieser Abschnitt enthält ein Beispiel für das Senden einer EDI-Transaktion in einem Umschlag an den Hub, auf dem sie in ein
XML-Dokument transformiert und an Community Manager gesendet wird.
In diesem Beispiel wird davon ausgegangen, dass der Zuordnungsexperte von Data Interchange Services eine Transformationszuordnung
erstellt hat, die eine EDI-879-Standardtransaktion (die mit dem Wörterbuch X12V5R1 definiert ist und der Version
5010 von X12 entspricht) nimmt und diese in ein XML-Dokument transformiert, das von der Back-End-Anwendung von
Community Manager verarbeitet wird. In diesem Beispiel heißt die Zuordnung S_DT_EDI_TO_XML.eif.
Der Zuordnungsexperte von Data Interchange Services kann die Transformationszuordnung direkt in die WebSphere Partner Gateway-Datenbank
exportieren. Alternativ hierzu kann der Zuordnungsexperte von Data Interchange Services Ihnen die Datei senden, in dem Fall verwenden Sie
das Dienstprogramm bcgDISImport, um die Datei in WebSphere Partner Gateway zu importieren. Dieser Anhang geht vom zweiten Szenario aus.
Die Transformationszuordnung importieren
Dieser Abschnitt beschreibt die Schritte, die Sie beim Importieren einer Transformationszuordnung ausführen, die die EDI-Eingabe
nimmt und diese in ein XML-Format transformiert. Beim Importieren der Transformationszuordnung können Sie auch die Dokumentdefinition
importieren, die der Zuordnung zugeordnet ist.
Bevor Sie die Transformationszuordnung importieren können, muss der Zuordnungsexperte von Data Interchange Services Ihnen diese
zusenden. Diese Gruppe von Schritten geht davon aus, dass sich die Datei S_DT_EDI_TO_XML.eif auf Ihrem System befindet.
- Öffnen Sie ein Befehlsfenster.
- Geben Sie den folgenden Befehl bzw. das folgende Script ein:
- Auf einem UNIX-System:
<Produktverz>/bin/bcgDISImport.sh <datenbankbenutzer-ID>
<kennwort> S_DT_EDI_TO_XML.eif
- Auf einem Windows-System:
<Produktverz>\bin\bcgDISImport.bat <datenbankbenutzer-ID>
<kennwort> S_DT_EDI_TO_XML.eif
Dabei gilt Folgendes: <datenbankbenutzer-ID> und <kennwort> sind die Werte, die Sie
verwendet haben, als Sie die Datenbank als Teil der WebSphere Partner Gateway-Installation installiert haben.
Die Transformationszuordnung und Dokumentenflussdefinitionen prüfen
Führen Sie die folgenden Schritte aus, um zu prüfen, ob die Transformationszuordnungen und Dokumentdefinitionen, die Sie
importiert haben, in Community Console verfügbar sind:
- Klicken Sie auf Hubadmin > Hubkonfiguration > Zuordnungen > Transformationszuordnungen.
Die Zuordnung S_DT_EDI_TO_XML wird angezeigt.
- Klicken Sie auf das Symbol Details anzeigen neben der Zuordnung.
Die Dokumentenflussdefinitionen, denen diese Zuordnung zugeordnet ist:
Tabelle 26. Dokumentenflussdefinition, die der Zuordnung zugeordnet ist
Quelle |
Ziel |
Paket: N/A
Protokoll: X12V5R1
Dokumentenfluss: 879 (ALL) |
Paket: None
Protokoll: FVT-XML-TEST (ALL)
Dokumentenfluss: WWRE_ITEMCREATIONINTERNAL (ALL) |
Die Zuordnung S_DT_EDI_TO_XML wurde definiert, um eine X12-879-Transaktion zu nehmen, die mit dem X12V4R1-Standard konform ist,
und sie in ein angepasstes Protokoll transformiert.
Das Ziel konfigurieren
In diesem Abschnitt erstellen Sie ein Dateisystemverzeichnisziel für den Hub:
- Klicken Sie auf Hubadmin > Hubkonfiguration > Ziele, und klicken Sie dann auf
Ziel erstellen.
- Geben Sie als Zielname den Namen EDIDateiziel ein.
- Wählen Sie in der Liste Transport die Option
Dateiverzeichnis aus.
- Geben Sie als Stammverzeichnispfad /Data/Manager/editarget ein.
- Klicken Sie auf Speichern.
Der Community-Teilnehmer sendet den EDI-Austausch an dieses Ziel.
Die Interaktionen erstellen
Sie erstellen zwei Interaktionen: eine für den EDI-Umschlag und eine für die Transaktion im EDI-Umschlag.
Erstellen Sie eine Interaktion, die den EDI-Umschlag darstellt.
- Klicken Sie auf Hubadmin > Hubkonfiguration > Dokumentenflussdefinition.
- Klicken Sie auf Interaktionen verwalten und dann auf
Interaktion erstellen.
- Erweitern Sie den Eintrag Paket: None und
Protokoll: EDI-X12, und wählen Sie Dokumentenfluss: ISA aus.
- Erweitern Sie den Eintrag Paket: N/A und
Protokoll: EDI-X12, und wählen Sie Dokumentenfluss: ISA aus.
- Wählen Sie in der Liste Aktion die Option EDI - Umschlag entfernen aus.
Anmerkung: In dieser Interaktion findet keine Transformation statt. Vom EDI-Austausch wird der Umschlag entfernt, wodurch die einzelne
Transaktion (879) entsteht. Sie benötigen daher keine Transformationszuordnung für diese Interaktion.
- Klicken Sie auf Speichern.
Erstellen Sie eine Interaktion, die über eine Quelle verfügt, die die 879-Transaktion darstellt, und ein Ziel, das das transformierte
Dokument darstellt.
- Klicken Sie auf Hubadmin > Hubkonfiguration > Dokumentenflussdefinition.
- Klicken Sie auf Interaktionen verwalten und dann auf
Interaktion erstellen.
- Erweitern Sie den Eintrag Paket: N/A und
Protokoll: X12V5R1, und wählen Sie Dokumentenfluss: 879 aus.
- Erweitern Sie den Eintrag Paket: None und
Protokoll: FVT-XML-TEST, und wählen Sie Dokumentenfluss: WWRE_ITEMCREATIONINTERNAL aus.
- Wählen Sie in der Liste Transformationszuordnung den Eintrag
S_DT_EDI_TO_XML aus.
- Wählen Sie in der Liste Aktion die Option EDI validieren und EDI konvertieren aus.
- Klicken Sie auf Speichern.
Diese Interaktion stellt die Transformation einer EDI-X12-879-Standardtransaktion in ein anderes Format dar, und daher müssen Sie eine
Transformationszuordnung auswählen.
Die Teilnehmer erstellen
Sie haben für dieses Beispiel zwei Teilnehmer: Community Manager (Manager) und einen Teilnehmer (TP1).
Erstellen Sie das Profil Community Manager:
- Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer, und klicken Sie auf
Erstellen.
- Geben Sie als Anmeldename des Unternehmens Folgendes ein: ComManager.
- Geben Sie als Anzeigename des Teilnehmers Folgendes ein: Manager.
- Wählen Sie als Teilnehmertyp Folgendes aus: Community Manager.
- Klicken Sie auf Neu für die Geschäfts-ID, und geben Sie 000000000 als unformatierte ID ein.
Anmerkung: Stellen Sie sicher, dass Sie Unformatiert und nicht DUNS ausgewählt haben.
- Klicken Sie erneut auf Neu für die Geschäfts-ID, und geben Sie 01-000000000 als unformatierte ID ein.
- Klicken Sie auf Speichern.
Erstellen Sie den zweiten Teilnehmer:
- Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer, und klicken Sie auf
Erstellen.
- Geben Sie als Anmeldename des Unternehmens Folgendes ein: TP1.
- Geben Sie als Anzeigename des Teilnehmers Folgendes ein, TP1.
- Wählen Sie als Teilnehmertyp Folgendes aus: Community-Teilnehmer.
- Klicken Sie auf Neu für die Geschäfts-ID, und geben Sie 000000001 als unformatierte ID ein.
Anmerkung: Stellen Sie sicher, dass Sie Unformatiert und nicht DUNS ausgewählt haben.
- Klicken Sie erneut auf Neu für die Geschäfts-ID, und geben Sie 01-000000001 als unformatierte ID ein.
- Klicken Sie auf Speichern.
Die Gateways erstellen
Erstellen Sie Dateiverzeichnisgateways für beide Teilnehmer im Beispiel. Erstellen Sie zuerst ein Gateway für den Manager.
- Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer, und klicken Sie auf
Suchen.
- Klicken Sie auf das Symbol Details anzeigen neben dem Profil Manager.
- Klicken Sie auf Gateways und dann auf Erstellen.
-
Geben Sie die folgenden Werte für das Gateway ein. Denken Sie daran, dass das Dateiverzeichnis (der vollständige Pfad)
schon auf Ihrem Dateisystem vorhanden sein muss.
- Geben Sie als Name Managerdateigateway ein.
- Wählen Sie in der Liste Transport die Option Dateiverzeichnis aus.
- Geben Sie als Adresse Folgendes ein: file:///Data/Manager/filegateway
- Klicken Sie auf Speichern.
- Klicken Sie auf Liste, um alle Gateways für Community Manager aufzulisten.
- Klicken Sie auf Standardgateways anzeigen.
- Wählen Sie in der Liste Produktion das Gateway aus, das Sie in Schritt 4
erstellt haben.
- Klicken Sie auf Speichern.
Erstellen Sie als Nächstes ein Gateway für den Teilnehmer.
- Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer, und klicken Sie auf
Suchen.
- Wählen Sie den anderen Teilnehmer aus, den Sie für dieses Beispiel erstellt haben, indem Sie auf das Symbol
Details anzeigen neben TP1 klicken.
- Klicken Sie auf Gateways und dann auf Erstellen.
-
Geben Sie die folgenden Werte für das Gateway ein. Denken Sie daran, dass das Dateiverzeichnis (der vollständige Pfad)
schon vorhanden sein muss.
- Geben Sie als Name TP1Dateigateway ein.
- Wählen Sie in der Liste Transport die Option
Dateiverzeichnis aus.
- Geben Sie als Adresse Folgendes ein: file:///Data/TP1/filegateway
- Klicken Sie auf Speichern.
- Klicken Sie auf Liste, um alle Gateways für den Teilnehmer aufzulisten.
- Klicken Sie auf Standardgateways anzeigen.
- Wählen Sie in der Liste Produktion das Gateway aus, das Sie in Schritt 4
erstellt haben.
- Klicken Sie auf Speichern.
B2B-Funktionalität konfigurieren
Aktivieren Sie die B2B-Funktionalität der zwei Teilnehmer in diesem Austausch. In diesem Beispiel stammt der EDI-Austausch vom
Community-Teilnehmer (TP1) und wird Community Manager zugestellt.
- Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer, und klicken Sie auf
Suchen.
- Klicken Sie auf das Symbol Details anzeigen für den Quellenteilnehmer dieses Beispiels (TP1).
- Klicken Sie auf B2B-Funktionalität.
- Aktivieren Sie zwei Funktionalitätsgruppen für den Quellenteilnehmer.
- Aktivieren Sie zuerst die Dokumentenflussdefinition, die den EDI-Umschlag darstellt:
- Klicken Sie zum Aktivieren auf das Symbol Rolle ist nicht aktiv unter Quelle festlegen für
Paket: None.
- Erweitern Sie Paket: None.
- Klicken Sie auf das Symbol Rolle ist nicht aktiv unter
Quelle festlegen für Protokoll: EDI-X12 (ALL).
- Erweitern Sie Protokoll: EDI-X12 (ALL).
- Klicken Sie auf das Symbol Rolle ist nicht aktiv unter
Quelle festlegen für Dokumentenfluss: ISA (ALL).
- Aktivieren Sie danach die Dokumentenflussdefinition, die die Transaktion darstellt:
- Klicken Sie zum Aktivieren auf das Symbol Rolle ist nicht aktiv unter Quelle festlegen für
Paket: N/A.
- Erweitern Sie Paket: N/A.
- Klicken Sie auf das Symbol Rolle ist nicht aktiv unter
Quelle festlegen für Protokoll: X12V5R1 (ALL).
- Erweitern Sie Protokoll: X12V5R1 (ALL).
- Klicken Sie auf das Symbol Rolle ist nicht aktiv unter
Quelle festlegen für Dokumentenfluss: 879.
- Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer, und klicken Sie auf
Suchen.
- Klicken Sie auf das Symbol Details anzeigen für den Zielteilnehmer dieses Beispiels (Manager).
- Klicken Sie auf B2B-Funktionalität.
- Aktivieren Sie zwei Funktionalitätsgruppen für den Zielteilnehmer.
- Aktivieren Sie zuerst die Dokumentenflussdefinition:
- Klicken Sie zum Aktivieren auf das Symbol Rolle ist nicht aktiv unter Ziel festlegen für
Paket: N/A.
- Erweitern Sie Paket: N/A.
- Klicken Sie auf das Symbol Rolle ist nicht aktiv unter
Ziel festlegen für Protokoll: EDI-X12 (ALL).
- Erweitern Sie Protokoll: EDI-X12 (ALL).
- Klicken Sie auf das Symbol Rolle ist nicht aktiv unter
Ziel festlegen für Dokumentenfluss: ISA (ALL).
- Aktivieren Sie als Nächstes die Dokumentenflussdefinition, die das transformierte Dokument darstellt:
- Klicken Sie zum Aktivieren auf das Symbol Rolle ist nicht aktiv unter Ziel festlegen für
Paket: None.
- Erweitern Sie Paket: None.
- Klicken Sie auf das Symbol Rolle ist nicht aktiv unter
Ziel festlegen für Protokoll: FVT-XML-TEST (ALL).
- Erweitern Sie Protokoll: FVT-XML-TEST (ALL).
- Klicken Sie auf das Symbol Rolle ist nicht aktiv unter
Ziel festlegen für Dokumentenfluss: WWRE_ITEMCREATIONINTERNAL (ALL).
Die Verbindungen aktivieren
Gehen Sie wie folgt vor, um die Verbindungen zu aktivieren:
- Klicken Sie auf Kontenadmin > Teilnehmerverbindungen.
- Wählen Sie TP1 in der Liste Quelle aus.
- Wählen Sie Manager in der Liste Ziel aus.
- Klicken Sie auf Suchen.
- Klicken Sie auf Aktivieren für die Verbindung, die den Umschlag darstellt:
Tabelle 27. Verbindung für Umschlag
Quelle |
Ziel |
Paket: None (N/A)
Protokoll: EDI-X12 (ALL)
Dokumentenfluss: ISA (ALL) |
Paket: N/A (N/A)
Protokoll: EDI-X12 (ALL)
Dokumentenfluss: ISA (ALL) |
- Klicken Sie auf Aktivieren für die Verbindung, die die 879-Transaktion darstellt, zum transformierten Dokument:
Tabelle 28. Verbindung für EDI-Transaktion zu XML-Dokument
Quelle |
Ziel |
Paket: N/A (N/A)
Protokoll: X12V5R1 (ALL)
Dokumentenfluss: 879 (ALL) |
Paket: None (N/A)
Protokoll: FVT-XML-TEST (ALL)
Dokumentenfluss: WWRE_ITEMCREATIONINTERNAL (ALL) |
Wenn an dieser Stelle TP1 einen EDI-Austausch mit einer 879-Transaktion an Community Manager gesendet hat, würde vom EDI-Austausch der Umschlag
entfernt werden, wodurch eine 879-Transaktion entstände. Die 879-Transaktion würde dann transformiert werden und
das transformierte Dokument würde an das Gateway von Community Manager gesendet werden.
