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.

  1. Öffnen Sie ein Befehlsfenster.
  2. Geben Sie den folgenden Befehl bzw. das folgende Script ein:

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:

  1. Klicken Sie auf Hubadmin > Hubkonfiguration > Zuordnungen > Transformationszuordnungen.

    Die Zuordnung S_DT_ROD_TO_EDI wird angezeigt.

  2. 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:

  1. Klicken Sie auf Hubadmin > Hubkonfiguration > Ziele, und klicken Sie dann auf Ziel erstellen.
  2. Geben Sie als Zielname den Namen RODDateiziel ein.
  3. Wählen Sie in der Liste Transport die Option Dateiverzeichnis aus.
  4. Geben Sie als Stammverzeichnispfad /Data/Manager/rodtarget ein.
  5. Wählen Sie in der Liste Konfigurationspunkt die Option Vorverarbeitung aus.
  6. 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.
  7. Wählen Sie com.ibm.bcg.edi.receiver.preprocesshandler.RODSplitterHandler in der Konfigurationsliste aus, und klicken Sie auf Konfigurieren.
  8. 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
  9. Klicken Sie auf Festlegen.
  10. 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.

  1. Klicken Sie auf Hubadmin > Hubkonfiguration > Dokumentenflussdefinition.
  2. Klicken Sie auf Interaktionen verwalten und dann auf Interaktion erstellen.
  3. Erweitern Sie den Eintrag Paket: None und Protokoll: ROD-TO-EDI_DICT, und wählen Sie DTROD-TO-EDI_ROD aus.
  4. Erweitern Sie den Eintrag Paket: N/A und Protokoll: X12V5R1, und wählen Sie Dokumentenfluss: 850 aus.
  5. Wählen Sie in der Liste Transformationszuordnung den Eintrag S_DT_ROD_TO_EDI aus.
  6. Wählen Sie in der Liste Aktion die Option ROD konvertieren und EDI validieren aus.
  7. 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.

  1. Klicken Sie auf Hubadmin > Hubkonfiguration > Dokumentenflussdefinition.
  2. Klicken Sie auf Interaktionen verwalten und dann auf Interaktion erstellen.
  3. Erweitern Sie den Eintrag Paket: N/A und Protokoll: EDI-X12, und wählen Sie Dokumentenfluss: ISA aus.
  4. Erweitern Sie den Eintrag Paket: None und Protokoll: EDI-X12, und wählen Sie Dokumentenfluss: ISA aus.
  5. 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.
  6. 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:

  1. Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer, und klicken Sie auf Erstellen.
  2. Geben Sie als Anmeldename des Unternehmens Folgendes ein: ComManager.
  3. Geben Sie als Anzeigename des Teilnehmers Folgendes ein: Manager.
  4. Wählen Sie als Teilnehmertyp Folgendes aus: Community Manager.
  5. 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.
  6. Klicken Sie erneut auf Neu für die Geschäfts-ID, und geben Sie 01-000000000 als unformatierte ID ein.
  7. Klicken Sie auf Speichern.

Erstellen Sie den zweiten Teilnehmer:

  1. Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer, und klicken Sie auf Erstellen.
  2. Geben Sie als Anmeldename des Unternehmens Folgendes ein: TP1.
  3. Geben Sie als Anzeigename des Teilnehmers Folgendes ein, TP1.
  4. Wählen Sie als Teilnehmertyp Folgendes aus: Community-Teilnehmer.
  5. 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.
  6. Klicken Sie erneut auf Neu für die Geschäfts-ID, und geben Sie 01-000000001 als unformatierte ID ein.
  7. 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.

  1. Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer, und klicken Sie auf Suchen.
  2. Klicken Sie auf das Symbol Details anzeigen neben dem Profil Manager.
  3. Klicken Sie auf Gateways und dann auf Erstellen.
  4. 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.
    1. Geben Sie als Name Managerdateigateway ein.
    2. Wählen Sie in der Liste Transport die Option Dateiverzeichnis aus.
    3. Geben Sie als Adresse Folgendes ein: file:///Data/Manager/filegateway
    4. Klicken Sie auf Speichern.
  5. Klicken Sie auf Liste, um alle Gateways für Community Manager aufzulisten.
  6. Klicken Sie auf Standardgateways anzeigen.
  7. Wählen Sie in der Liste Produktion das Gateway aus, das Sie in Schritt 4 erstellt haben.
  8. Klicken Sie auf Speichern.

Erstellen Sie als Nächstes ein Gateway für den Teilnehmer.

  1. Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer, und klicken Sie auf Suchen.
  2. 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.
  3. Klicken Sie auf Gateways und dann auf Erstellen.
  4. Geben Sie die folgenden Werte für das Gateway ein. Denken Sie daran, dass das Dateiverzeichnis (der vollständige Pfad) schon vorhanden sein muss.
    1. Geben Sie als Name TP1Dateigateway ein.
    2. Wählen Sie in der Liste Transport die Option Dateiverzeichnis aus.
    3. Geben Sie als Adresse Folgendes ein: file:///Data/TP1/filegateway
    4. Klicken Sie auf Speichern.
  5. Klicken Sie auf Liste, um alle Gateways für den Teilnehmer aufzulisten.
  6. Klicken Sie auf Standardgateways anzeigen.
  7. Wählen Sie in der Liste Produktion das Gateway aus, das Sie in Schritt 4 erstellt haben.
  8. 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.

  1. Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer, und klicken Sie auf Suchen.
  2. Klicken Sie auf das Symbol Details anzeigen für den Quellenteilnehmer dieses Beispiels (Manager).
  3. Klicken Sie auf B2B-Funktionalität.
  4. Aktivieren Sie zwei Funktionalitätsgruppen für den Quellenteilnehmer.
    1. Aktivieren Sie zuerst die Dokumentenflussdefinition, die das ROD-Dokument darstellt:
      1. Klicken Sie zum Aktivieren auf das Symbol Rolle ist nicht aktiv unter Quelle festlegen für Paket: None.
      2. Erweitern Sie Paket: None.
      3. Klicken Sie auf das Symbol Rolle ist nicht aktiv unter Quelle festlegen für Protokoll: ROD-TO-EDI_DICT (ALL).
      4. Erweitern Sie Protokoll: ROD-TO-EDI_DICT (ALL).
      5. Klicken Sie auf das Symbol Rolle ist nicht aktiv unter Quelle festlegen für Dokumentenfluss: DTROD-TO-EDI_ROD (ALL).
    2. Aktivieren Sie als Nächstes die Dokumentenflussdefinition, die den EDI-Umschlag darstellt:
      1. Klicken Sie zum Aktivieren auf das Symbol Rolle ist nicht aktiv unter Quelle festlegen für Paket: N/A.
      2. Erweitern Sie Paket: N/A.
      3. Klicken Sie auf das Symbol Rolle ist nicht aktiv unter Quelle festlegen für Protokoll: EDI-X12 (ALL).
      4. Erweitern Sie Protokoll: EDI-X12 (ALL).
      5. Klicken Sie auf das Symbol Rolle ist nicht aktiv unter Quelle festlegen für Dokumentenfluss: ISA (ALL).
  5. Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer, und klicken Sie auf Suchen.
  6. Klicken Sie auf das Symbol Details anzeigen für den Zielteilnehmer dieses Beispiels (TP1).
  7. Klicken Sie auf B2B-Funktionalität.
  8. Aktivieren Sie zwei Funktionalitätsgruppen für den Zielteilnehmer.
    1. Aktivieren Sie zuerst die Dokumentenflussdefinition, die die EDI-850-Transaktion darstellt:
      1. Klicken Sie zum Aktivieren auf das Symbol Rolle ist nicht aktiv unter Ziel festlegen für Paket: N/A.
      2. Erweitern Sie Paket: N/A.
      3. Klicken Sie auf das Symbol Rolle ist nicht aktiv unter Ziel festlegen für Protokoll: X12V5R1 (ALL).
      4. Erweitern Sie Protokoll: X12V5R1 (ALL).
      5. Klicken Sie auf das Symbol Rolle ist nicht aktiv unter Ziel festlegen für Dokumentenfluss: 850 (ALL).
    2. Aktivieren Sie als Nächstes die Dokumentenflussdefinition, die den Umschlag darstellt:
      1. Klicken Sie zum Aktivieren auf das Symbol Rolle ist nicht aktiv unter Ziel festlegen für Paket: None.
      2. Erweitern Sie Paket: None.
      3. Klicken Sie auf das Symbol Rolle ist nicht aktiv unter Ziel festlegen für Protokoll: EDI-X12 (ALL).
      4. Erweitern Sie Protokoll: EDI-X12 (ALL).
      5. 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:

  1. Klicken Sie auf Hubadmin > Hubkonfiguration > EDI > Umschlagsprofil.
  2. Klicken Sie auf Erstellen.
  3. Geben Sie den Namen des Profils ein: UmschProf1.
  4. Wählen Sie in der Liste EDI-Standard die Option X12 aus.
  5. Die Schaltfläche Allgemein ist standardmäßig ausgewählt. Geben Sie die folgenden Werte für die allgemeinen Attribute des Umschlags ein:
  6. Klicken Sie auf die Schaltfläche Austausch, und geben Sie die folgenden Werte für die Austauschattribute ein:
  7. Klicken Sie auf Speichern.

Die Verbindungen aktivieren

Gehen Sie wie folgt vor, um die Verbindungen zu aktivieren:

  1. Klicken Sie auf Kontenadmin > Teilnehmerverbindungen.
  2. Wählen Sie Manager in der Liste Quelle aus.
  3. Wählen Sie TP1 in der Liste Ziel aus.
  4. Klicken Sie auf Suchen.
  5. 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
  6. 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:

  1. Klicken Sie auf Kontenadmin > Profile > Community-Teilnehmer, und klicken Sie auf Suchen.
  2. Wählen Sie TP1 in der Liste aus.
  3. Klicken Sie auf B2B-Funktionalität.
  4. Klicken Sie auf das Symbol Erweitern neben Paket: N/A.
  5. Klicken Sie auf das Symbol Bearbeiten neben Protokoll: X12V5R1.
  6. Geben Sie die folgenden Attribute an:
    1. Wählen Sie in der Zeile Umschlagsprofil den Eintrag UmschProf1 in der Liste aus.
    2. Geben Sie in der Zeile Qualifikationsmerkmal für Austausch den Wert 01 ein.
    3. Geben Sie in der Zeile Kennung für Austausch den Wert 000000001 ein.
    4. Geben Sie in der Zeile Nutzungsanzeiger für Austausch den Buchstaben T ein.
  7. 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.

Copyright IBM Corp. 2003, 2005