Beispiel: ROD zu EDI
Dieser Abschnitt enthält ein Beispiel davon, wie Community Manager ein ROD-Dokument a den Hub sendet, auf dem es in eine
EDI-Transaktion transformiert, in einem EDI-Austausch mit einem Umschlag versehen und an einen Teilnehmer gesendet wird.
In diesem Beispiel wird davon ausgegangen, dass der Zuordnungsexperte von Data Interchange Services eine Transformationszuordnung
erstellt hat, die ein satzorientiertes Datendokument (ROD) nimmt und dieses in eine EDI-850-Standardtransaktion (die mit dem Wörterbuch X12V5R1
definiert ist und der Version 5010 von X12 entspricht) transformiert, die vom Teilnehmer verarbeitet wird.
In diesem Beispiel heißt die Zuordnung S_DT_ROD_TO_EDI.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 ROD-Eingabe
nimmt und diese in eine X12-Transaktion 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_ROD_TO_EDI.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_ROD_TO_EDI.eif
- Auf einem Windows-System:
<Produktverz>\bin\bcgDISImport.bat <datenbankbenutzer-ID>
<kennwort> S_DT_ROD_TO_EDI.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_ROD_TO_EDI wird angezeigt.
- Klicken Sie auf das Symbol Details anzeigen neben der Zuordnung.
Die Dokumentenflussdefinitionen, denen diese Zuordnung zugeordnet ist:
Tabelle 32. Dokumentenflussdefinitionen, die der Zuordnung zugeordnet sind
Quelle |
Ziel |
Paket: None
Protokoll: ROD-TO-EDI_DICT (ALL)
Dokumentenfluss: DTROD-TO-EDI_ROD (ALL) |
Paket: N/A
Protokoll: X12V5R1 (ALL)
Dokumentenfluss: 850 (ALL) |
Die Zuordnung S_DT_ROD_TO_EDI wurde definiert, um ein ROD-Dokument, das
dem Wörterbuch ROD-TO-EDI_DICT zugeordnet ist, zu nehmen und dieses in eine X12-850-Transaktion zu transformieren,
die mit dem X12V5R1-Standard konform ist.
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 RODDateiziel ein.
- Wählen Sie in der Liste Transport die Option
Dateiverzeichnis aus.
- Geben Sie als Stammverzeichnispfad /Data/Manager/rodtarget ein.
- Wählen Sie in der Liste Konfigurationspunkt die Option
Vorverarbeitung aus.
- Wählen Sie com.ibm.bcg.edi.receiver.preprocesshandler.RODSplitterHandler in der Verfügbarkeitsliste
aus, und klicken Sie auf Hinzufügen, um den Handler in die Konfigurationsliste zu versetzen.
- Wählen Sie com.ibm.bcg.edi.receiver.preprocesshandler.RODSplitterHandler in der Konfigurationsliste
aus, und klicken Sie auf Konfigurieren.
- Fügen Sie die in der Tabelle gezeigten Werte hinzu:
Tabelle 33. Attribute für den ROD-Verteilerhandler
Feld |
Wert |
From Packaging Name |
None |
From Packaging Version |
N/A |
From Protocol Name |
ROD-TO-EDI_DICT |
From Protocol Version |
ALL |
From Process Code |
DTROD-TO-EDI_ROD |
From Process Version |
ALL |
METADICTIONARY |
ROD-TO-EDI_DICT |
METADOCUMENT |
DTROD-TO-EDI_ROD |
METASYNTAX |
rod |
ENCODING |
ascii |
BCG_BATCHDOCS |
ON |
- Klicken Sie auf Festlegen.
- Klicken Sie auf Speichern.
Community Manager sendet das ROD-Dokument an dieses Ziel.
Die Interaktionen erstellen
Sie erstellen zwei Interaktionen: eine für den EDI-Umschlag, der vom Hub gesendet wird, und eine für die Transformation
des ROD-Dokuments in EDI.
Erstellen Sie eine Interaktion, die über eine Quelle verfügt, die das ROD-Dokument darstellt, und ein Ziel, das das X12-Dokument
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: ROD-TO-EDI_DICT,
und wählen Sie DTROD-TO-EDI_ROD aus.
- Erweitern Sie den Eintrag Paket: N/A und
Protokoll: X12V5R1, und wählen Sie Dokumentenfluss: 850 aus.
- Wählen Sie in der Liste Transformationszuordnung den Eintrag
S_DT_ROD_TO_EDI aus.
- Wählen Sie in der Liste Aktion die Option ROD konvertieren und EDI
validieren aus.
- Klicken Sie auf Speichern.
Diese Interaktion stellt die Transformation eines ROD-Dokuments in eine X12-Standardtransaktion dar, und daher müssen Sie eine
Transformationszuordnung auswählen.
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: N/A und
Protokoll: EDI-X12, und wählen Sie Dokumentenfluss: ISA aus.
- Erweitern Sie den Eintrag Paket: None und
Protokoll: EDI-X12, und wählen Sie Dokumentenfluss: ISA aus.
- Wählen Sie in der Liste Aktion die Option Pass-Through aus.
Anmerkung: In dieser
Interaktion findet keine Transformation statt. In dieser Interaktion wird der EDI-Austausch mit einem Umschlag versehen.
- Klicken Sie auf Speichern.
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 das ROD-Dokument von
Community Manager und wird dem Teilnehmer (TP1) übermittelt.
- 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 (Manager).
- Klicken Sie auf B2B-Funktionalität.
- Aktivieren Sie zwei Funktionalitätsgruppen für den Quellenteilnehmer.
- Aktivieren Sie zuerst die Dokumentenflussdefinition, die das ROD-Dokument 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: ROD-TO-EDI_DICT (ALL).
- Erweitern Sie Protokoll: ROD-TO-EDI_DICT (ALL).
- Klicken Sie auf das Symbol Rolle ist nicht aktiv unter Quelle festlegen für
Dokumentenfluss: DTROD-TO-EDI_ROD (ALL).
- Aktivieren Sie als Nächstes die Dokumentenflussdefinition, die den EDI-Umschlag 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: 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).
- 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 (TP1).
- Klicken Sie auf B2B-Funktionalität.
- Aktivieren Sie zwei Funktionalitätsgruppen für den Zielteilnehmer.
- Aktivieren Sie zuerst die Dokumentenflussdefinition, die die EDI-850-Transaktion darstellt:
- 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: X12V5R1 (ALL).
- Erweitern Sie Protokoll: X12V5R1 (ALL).
- Klicken Sie auf das Symbol Rolle ist nicht aktiv unter
Ziel festlegen für Dokumentenfluss: 850 (ALL).
- Aktivieren Sie als Nächstes die Dokumentenflussdefinition, die den Umschlag 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: 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).
Das Umschlagsprofil erstellen
Sie erstellen als Nächstes das Profil für den Umschlag, der die transformierte 850-Transaktion enthalten wird:
- Klicken Sie auf Hubadmin > Hubkonfiguration > EDI > Umschlagsprofil.
- Klicken Sie auf Erstellen.
- Geben Sie den Namen des Profils ein: UmschProf1.
- Wählen Sie in der Liste EDI-Standard die Option X12 aus.
- Die Schaltfläche Allgemein ist standardmäßig ausgewählt.
Geben Sie die folgenden Werte für die allgemeinen Attribute des Umschlags ein:
- INTCTLLEN: 9
- GRPCTLLEN: 9
- TRXCTLLEN: 9
- MAXDOCS: 1000
- Klicken Sie auf die Schaltfläche Austausch, und geben Sie die folgenden Werte für die Austauschattribute ein:
- ISA01: 01
- ISA02: ISA0000002
- ISA03: 02
- ISA04: ISA0000004
- ISA11: \
- ISA12: 00501
- ISA15: T
- Klicken Sie auf Speichern.
Die Verbindungen aktivieren
Gehen Sie wie folgt vor, um die Verbindungen zu aktivieren:
- Klicken Sie auf Kontenadmin > Teilnehmerverbindungen.
- Wählen Sie Manager in der Liste Quelle aus.
- Wählen Sie TP1 in der Liste Ziel aus.
- Klicken Sie auf Suchen.
- Klicken Sie auf Aktivieren für die Verbindung, die die Verbindung vom ROD-Dokument zur EDI-Transaktion darstellt:
Tabelle 34. Verbindung für ROD zu EDI
Quelle |
Ziel |
Paket: N/A (N/A)
Protokoll: ROD-TO-EDI_DICT (ALL) Dokumentenfluss: DTROD-TO-EDI_ROD (ALL) |
Paket: None (N/A)
Protokoll: X12V5R1 (ALL)
Dokumentenfluss: 850 |
- Klicken Sie auf Aktivieren für die Verbindung, die den Umschlag darstellt:
Tabelle 35. 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) |
Attribute konfigurieren
Gehen Sie wie folgt vor, um Attribute für das Umschlagsprofil anzugeben:
- Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer, und klicken Sie auf
Suchen.
- Wählen Sie TP1 in der Liste aus.
- Klicken Sie auf B2B-Funktionalität.
- Klicken Sie auf das Symbol Erweitern neben Paket: N/A.
- Klicken Sie auf das Symbol Bearbeiten neben Protokoll: X12V5R1.
- Geben Sie die folgenden Attribute an:
- Wählen Sie in der Zeile Umschlagsprofil den Eintrag UmschProf1 in der Liste aus.
- Geben Sie in der Zeile Qualifikationsmerkmal für Austausch den Wert 01 ein.
- Geben Sie in der Zeile Kennung für Austausch den Wert 000000001 ein.
- Geben Sie in der Zeile Nutzungsanzeiger für Austausch den Buchstaben T ein.
- Klicken Sie auf Speichern.
Wenn Community Manager jetzt ein ROD-Dokument an den Hub sendet, würde das Dokument in eine 850-Transaktion
transformiert werden, welche dann mit einem Umschlag versehen und an das Gateway des Teilnehmers gesendet würde.
