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.

  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_EDI_TO_XML wird angezeigt.

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

  1. Klicken Sie auf Hubadmin > Hubkonfiguration > Ziele, und klicken Sie dann auf Ziel erstellen.
  2. Geben Sie als Zielname den Namen EDIDateiziel ein.
  3. Wählen Sie in der Liste Transport die Option Dateiverzeichnis aus.
  4. Geben Sie als Stammverzeichnispfad /Data/Manager/editarget ein.
  5. 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.

  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: EDI-X12, und wählen Sie Dokumentenfluss: ISA aus.
  4. Erweitern Sie den Eintrag Paket: N/A und Protokoll: EDI-X12, und wählen Sie Dokumentenfluss: ISA aus.
  5. 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.
  6. 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.

  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: X12V5R1, und wählen Sie Dokumentenfluss: 879 aus.
  4. Erweitern Sie den Eintrag Paket: None und Protokoll: FVT-XML-TEST, und wählen Sie Dokumentenfluss: WWRE_ITEMCREATIONINTERNAL aus.
  5. Wählen Sie in der Liste Transformationszuordnung den Eintrag S_DT_EDI_TO_XML aus.
  6. Wählen Sie in der Liste Aktion die Option EDI validieren und EDI konvertieren aus.
  7. 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:

  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 der EDI-Austausch vom Community-Teilnehmer (TP1) und wird Community Manager zugestellt.

  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 (TP1).
  3. Klicken Sie auf B2B-Funktionalität.
  4. Aktivieren Sie zwei Funktionalitätsgruppen für den Quellenteilnehmer.
    1. Aktivieren Sie zuerst 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: None.
      2. Erweitern Sie Paket: None.
      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).
    2. Aktivieren Sie danach die Dokumentenflussdefinition, die die Transaktion 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: X12V5R1 (ALL).
      4. Erweitern Sie Protokoll: X12V5R1 (ALL).
      5. Klicken Sie auf das Symbol Rolle ist nicht aktiv unter Quelle festlegen für Dokumentenfluss: 879.
  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 (Manager).
  7. Klicken Sie auf B2B-Funktionalität.
  8. Aktivieren Sie zwei Funktionalitätsgruppen für den Zielteilnehmer.
    1. Aktivieren Sie zuerst die Dokumentenflussdefinition:
      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: 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).
    2. Aktivieren Sie als Nächstes die Dokumentenflussdefinition, die das transformierte Dokument 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: FVT-XML-TEST (ALL).
      4. Erweitern Sie Protokoll: FVT-XML-TEST (ALL).
      5. 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:

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

Copyright IBM Corp. 2003, 2005