Anleitung zum Einstieg in Jitterbit EDI

Einführung

Diese Anleitung zeigt Ihnen, wie Sie Jitterbit EDI einrichten, um eine X12 850 4010-Transaktion zu verarbeiten. (Sie können ein anderes Dokument oder einen anderen Standard verwenden, aber die Einstellungen sind unterschiedlich.)

Diese Anleitung führt Sie durch die folgenden Aufgaben:

1. Informationen sammeln
2. Eine ISA-ID generieren und einen Partner hinzufügen
3. Einen oder mehrere Workflows erstellen
4. EDI-Einstellungen konfigurieren
5. Eine EDI-Datei vorbereiten
6. Kommunikation konfigurieren
7. Überprüfen
8. EDI integrieren

1. Informationen sammeln

Sie sollten mit jedem Ihrer Handelspartner koordinieren, um Tests zu planen und deren Implementierungsleitfäden, Kommunikationspräferenzen und Testdateien zu erhalten.

Dies sind die wichtigsten Dinge, die Sie benötigen:

• Der EDI-Implementierungsleitfaden Ihres Handelspartners.

• Die FTP-Verbindungsinformationen Ihres Handelspartners. (AS2- und VAN-Verbindungen werden in dieser Anleitung nicht behandelt. Wenn Sie diese verwenden müssen, siehe Kommunikationseinstellungen, oder kontaktieren Sie Jitterbit-Support oder Ihren Customer Success Manager (CSM).)

• Ein EDI-Testdokument.

2. Generieren Sie eine ISA-ID und fügen Sie einen Partner hinzu

Out of the box sind in Jitterbit EDI keine Partner eingerichtet. Beim ersten Hinzufügen eines Partners werden Sie aufgefordert, eine ISA-ID zu generieren.

Um Ihren ersten Partner hinzuzufügen und Ihre ISA-ID zu generieren, befolgen Sie diese Schritte:

1. Wählen Sie EDI > Admin aus dem Menü des Harmony-Portals. Die Admin-Seite öffnet sich (mit einem leeren Trading Partners-Bereich):

   

2. Klicken Sie auf das Hinzufügen-Symbol im Trading Partners-Bereich (links) oder auf die Schaltfläche Trading Partner hinzufügen (Mitte). Der Bereich Einen Trading Partner hinzufügen öffnet sich:

   

3. Diese Seite listet über 1000 Partner auf, die bereit sind, in Ihre Umgebung hinzugefügt zu werden. Um nach dem gewünschten Partner zu suchen, geben Sie den Namen oder die ID des Partners in die Suchleiste ein. (Wenn der gewünschte Partner nicht im System vorhanden ist, müssen Sie ihn selbst erstellen.)

4. Wenn Sie den gewünschten Partner gefunden haben, fahren Sie mit der Maus darüber und klicken Sie auf die Schaltfläche Hinzufügen:

   

5. Da dies Ihr erstes Mal ist, dass Sie Jitterbit EDI in der ausgewählten Umgebung einrichten, öffnet sich der folgende Bildschirm:

   

   Tipp

   Sie werden dies nicht wiedersehen, es sei denn, Sie richten Jitterbit EDI in einer neuen Umgebung ein.

6. Wählen Sie den Qualifier-Code Ihrer Organisation aus und geben Sie Ihre Unternehmens-ISA-ID ein.

   Wichtig

   Verwenden Sie Ihre Produktions-ID nicht in einer QA- oder Testumgebung.

7. Wenn Sie sich Ihrer Codes sicher sind, klicken Sie auf die Schaltfläche Speichern.

8. Um den Bildschirm Einen Trading Partner hinzufügen zu schließen, klicken Sie auf das Schließen-Symbol.

9. Wählen Sie den neuen Partner im Trading Partners-Bereich (links) aus. Im Hauptbereich ist die Registerkarte Workflows verwalten ausgewählt:

   

3. Erstellen Sie einen oder mehrere Workflows

Sobald ein Partner hinzugefügt wurde, können Sie (mindestens einen, aber normalerweise viele) Workflows für den Partner definieren.

Um einen Workflow zu erstellen, befolgen Sie diese Schritte:

1. Wählen Sie den neuen Partner aus und klicken Sie auf die Schaltfläche Neuen Workflow hinzufügen. Eine leere Zeile wird zur Liste der Workflows hinzugefügt:

   

2. Klicken Sie auf das Menü Verarbeitung zuordnen und wählen Sie dann EDIXml. Dadurch werden weitere Felder angezeigt. Stellen Sie diese wie folgt ein:

   • Richtung: Inbound. (Bestätigen Sie dies mit dem Implementierungsleitfaden oder mit Ihrem Handelspartner.)

     Tipp

     Wenn die Richtung Outbound ist, gibt es auch einen Schalter für die Validierung. Wenn Sie diesen aktivieren, wird das Format des Dokuments vor dem Senden überprüft.

   • EDI-Standard: X12

   • Dokumenttyp: 850 (Hinweis: Verwenden Sie für dieses Setup X12 als Ihren EDI-Standard und beziehen Sie sich auf Ihren Implementierungsleitfaden oder fragen Sie Ihren Handelspartner nach dem Qualifikator und der ISA-ID.)

   • Version: 4010

   • Aktiv: Aktiviert

   

3. Klicken Sie auf die Schaltfläche Speichern.

4. EDI-Einstellungen konfigurieren

Wenn Sie einen Workflow hinzufügen, zeigt die Registerkarte EDI-Einstellungen Felder an, die für die Einstellung gelten, die Sie für den EDI-Standard (in diesem Fall X12) für den ersten Workflow in der Registerkarte Workflows verwalten verwendet haben. (Bis Sie Ihren ersten Workflow erstellen, ist die Registerkarte EDI-Einstellungen leer.) Diese Felder sind die EDI Umschlagseinstellungen, die für die Verarbeitung von ausgehenden EDI-Dokumenten verwendet werden.

Um die EDI-Umschlagseinstellungen zu konfigurieren, befolgen Sie diese Schritte (siehe das Implementierungsleitfaden Ihres Partners für Hinweise zu Werten und den Referenzbereich für EDI-Umschläge für Details zu jedem Feld):

1. Wählen Sie den neuen Partner im Bereich Admin > Handelspartner aus und wählen Sie die Registerkarte EDI-Einstellungen:

   

2. Erweitern Sie alle Abschnitte und überprüfen oder ändern Sie die Werte gemäß den Angaben im EDI-Implementierungsleitfaden des Partners:

   

3. Klicken Sie auf die Schaltfläche Speichern.

5. Bereiten Sie eine EDI-Datei vor

Für diesen Schritt müssen Sie eine Testdatei von Ihrem Handelspartner erhalten. Wenn Sie keine erhalten können, verwenden Sie das Beispiel 850 4010, aber stellen Sie sicher, dass Sie die IDs der Datei ändern, um mit Ihren EDI-Einstellungen übereinzustimmen.

Dieses Beispiel erklärt, wie Sie den richtigen Header für Ihre Testdatei erstellen. Die Partner-ID und die Unternehmens-ID befinden sich im Abschnitt Bevorzugte IDs der Registerkarte EDI-Einstellungen:

6. Konfigurieren Sie die Kommunikation

Der Implementierungsleitfaden Ihres Partners sollte beschreiben, wie Dateien mit dem Partner gesendet und empfangen werden. Jitterbit EDI unterstützt die Kommunikation über FTP (File Transfer Protocol), AS2 (Applicability Statement 2) oder über Jitterbits eigenes VAN (Value-Added Network).

Befolgen Sie diese Schritte, um eine FTP-Verbindung einzurichten:

1. Mit dem ausgewählten neuen Partner wählen Sie die Registerkarte Kommunikationseinstellungen:

   

2. Klicken Sie auf die Schaltfläche Erstellen , und wählen Sie dann FTP-Verbindung. Das Panel Neue FTP-Verbindung erstellen erscheint:

   

3. Geben Sie Werte für die folgenden Felder ein:

   

   • Name: Ein Name für die Verbindung.
   • Login: Der Benutzername für den FTP-Server.
   • Passwort: Das Passwort für den FTP-Server. Leer lassen, wenn kein Passwort festgelegt wurde.
   • Adresse: Die IP-Adresse oder der Hostname des FTP-Servers.
   • Port: Die Portnummer. (Ihre Firewall muss den Datenverkehr auf dem Port zulassen.)
   • Protokoll: Wählen Sie FTP.
   • Sicherheit: Wählen Sie den Sicherheitstyp, einen von Explizit, Implizit oder Keine.
   • Modus: Wählen Sie den FTP-Modus, Aktiv oder Passiv.

4. Schalten Sie den Schalter Aktiv ein.

5. Erweitern Sie die Registerkarte Zusätzliche Optionen, und schalten Sie den Schalter Aktiven Download ein.

6. Erweitern Sie die Registerkarte Automatisierung.

7. Wählen Sie in der Registerkarte Automatisierung das Menü Häufigkeit und wählen Sie dann 15 Minuten.

8. Klicken Sie in der Registerkarte Automatisierung auf das Kalendersymbol im Feld Nächster Lauf, und wählen Sie ein Datum und eine Uhrzeit für den Verbindungsstart.

9. Erstellen Sie im Stammordner Ihres FTP-Servers zwei Unterordner, Download und Upload. Wenn Sie die Testdatei in diesem Einrichtungsleitfaden oder eine Testdatei von Ihrem Handelspartner verwenden, legen Sie sie in den Ordner Download.

7. Überprüfen

Um zu überprüfen, ob Ihr Dokument gesendet wurde und die Testtransaktion erfolgreich verarbeitet wurde, suchen Sie es auf der Transaktionsseite:

Wenn Sie es nicht sehen, öffnen Sie die Messaging-Seite, wo Sie die Transaktion und den Grund für deren Fehler sehen sollten:

8. Integrieren

Sobald Jitterbit EDI erfolgreich mit Partnern kommuniziert und Dokumente verarbeitet, können Sie Integration Studio verwenden, um die anderen Prozesse zu automatisieren, die Sie möglicherweise nach dem Senden oder Empfangen eines EDI-Dokuments durchführen müssen.

Um ein EDI-Integrationsprojekt zu erstellen, befolgen Sie diese Schritte:

1. Erstellen Sie ein Zugriffstoken für EDI und wählen Sie die gleiche Umgebung aus, die für Ihre Jitterbit EDI-Konfigurationen verwendet wird.

2. Wählen Sie Integration Studio > Projekte aus dem Menü des Harmony-Portals.

3. Klicken Sie auf die Schaltfläche Neues Projekt.

4. Geben Sie einen Projektnamen ein, wählen Sie die gleiche Umgebung aus, die für Ihre Jitterbit EDI-Konfigurationen verwendet wird, und klicken Sie dann auf die Schaltfläche Design starten.

5. Geben Sie in der Suchleiste der Design-Komponentenpalette des geöffneten Projekts EDI für Cloud v2 ein und wählen Sie den gefundenen Connector aus.

6. Geben Sie in der Konfiguration des EDI für Cloud v2-Endpunkts das Zugriffstoken ein und klicken Sie dann auf die Schaltfläche Änderungen speichern.

7. Klicken Sie in der Design-Komponentenpalette unter Verfügbare Endpunkte auf den Endpunkt Jitterbit EDI V2 und ziehen Sie die Aktivität Dokument abrufen auf eine Operation auf der Design-Leinwand.

8. Konfigurieren Sie die Aktivität Dokument abrufen:

   1. Wählen Sie in Schritt 1 den Handelspartner aus und klicken Sie auf die Schaltfläche Weiter.

   2. Wählen Sie in Schritt 2 das Dokument aus und klicken Sie auf die Schaltfläche Weiter.

   3. Wählen Sie in Schritt 3 das Datenschema aus und klicken Sie auf die Schaltfläche Fertig.