Anleitung für die ersten Schritte mit Jitterbit EDI

Einführung

Diese Anleitung zeigt dir, wie du Jitterbit EDI einrichtest, um eine X12 850 4010-Transaktion zu verarbeiten. (Du kannst ein anderes Dokument oder einen anderen Standard verwenden, aber die Einstellungen unterscheiden sich.)

Diese Anleitung führt dich durch die folgenden Aufgaben:

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

1. Informationen sammeln

Du solltest dich mit jedem deiner Handelspartner abstimmen, um Tests zu planen und deren Implementierungsleitfäden, Kommunikationspräferenzen und Testdateien zu erhalten.

Dies sind die wichtigsten Dinge, die du benötigst:

• Der EDI-Implementierungsleitfaden deines Handelspartners.

• Die FTP-Verbindungsinformationen deines Handelspartners. (AS2- und VAN-Verbindungen werden in dieser Anleitung nicht behandelt. Falls du diese verwenden musst, siehe Kommunikationseinstellungen, oder kontaktiere den Jitterbit-Support oder deinen Customer Success Manager (CSM).)

• Ein EDI-Testdokument.

2. Eine EDI-ID generieren und einen Partner hinzufügen

Standardmäßig sind in Jitterbit EDI keine Partner eingerichtet. Wenn du den ersten hinzufügst, wirst du aufgefordert, eine EDI-ID zu generieren.

Um deinen ersten Partner hinzuzufügen und deine EDI-ID zu generieren, führe diese Schritte aus:

1. Wähle EDI > Trading Partners aus dem Harmony-Portalmenü. Die Seite Trading Partners wird geöffnet:

   

2. Klicke auf New > Partner. Die Schublade Add trading partner wird geöffnet:

   

3. Diese Seite listet über 1000 Partner auf, die deiner Umgebung hinzugefügt werden können. Um den gewünschten Partner zu finden, gib seinen Namen oder seine ID in die Suchleiste ein. (Falls der gewünschte Partner nicht im System vorhanden ist, musst du ihn selbst erstellen.)

4. Wenn du den gewünschten Partner gefunden hast, fahre mit der Maus darüber und klicke auf seine Schaltfläche Add:

   

5. Da dies dein erstes Mal ist, dass du Jitterbit EDI in der ausgewählten Umgebung einrichtest, wird das Dialogfeld Generating Your EDI ID geöffnet. Gib den Qualifizierer-Code und die EDI-ID deiner Organisation ein.

   Tipp

   Du wirst dies nicht erneut sehen, es sei denn, du richtest Jitterbit EDI in einer neuen Umgebung ein.

   Wichtig

   Verwende deine Produktions-ID nicht in einer QA- oder Testumgebung.

6. Wenn du dir deiner Codes sicher bist, klicke auf die Schaltfläche Save.

7. Um die Schublade Add trading partner zu schließen, klicke auf das Symbol Close.

8. Wählen Sie den neuen Partner aus, um die Schublade mit der Registerkarte Workflows verwalten zu öffnen:

   

3. Ein oder mehrere Workflows erstellen

Nachdem ein Partner hinzugefügt wurde, können Sie ein oder mehrere Workflows für diesen Partner definieren.

Gehen Sie wie folgt vor, um einen Workflow zu erstellen:

1. Klicken Sie mit dem neuen Partner ausgewählt auf Neu > Workflow. Eine leere Zeile wird zur Liste der Workflows hinzugefügt, wobei Map-Verarbeitung standardmäßig auf EDIXml eingestellt ist:

   

2. Legen Sie die folgenden Felder fest:

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

     Tipp

     Wenn die Richtung Outbound ist, gibt es auch einen Validierungs-Schalter. Wenn Sie diesen aktivieren, wird das Format des Dokuments vor dem Versand überprüft.

   • EDI-Standard: X12

   • Dokumenttyp: 850 (Hinweis: Verwenden Sie für diese Einrichtung X12 als EDI-Standard und beziehen Sie sich auf den Implementierungsleitfaden oder fragen Sie Ihren Handelspartner nach dem Qualifier und der EDI-ID.)

   • Version: 4010

   • Aktiv: Ein

   

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 EDI-Standard verwendet haben (in diesem Fall X12) für den ersten Workflow, der in der Registerkarte Workflows verwalten aufgeführt ist. (Bis Sie Ihren ersten Workflow erstellen, ist die Registerkarte EDI-Einstellungen leer.) Diese Felder sind die EDI-Umschlageinstellungen, die für die Verarbeitung ausgehender EDI-Dokumente verwendet werden.

Gehen Sie wie folgt vor, um die EDI-Umschlageinstellungen zu konfigurieren (beziehen Sie sich auf den Implementierungsleitfaden Ihres Partners für Hinweise zu Werten und den Referenzabschnitt zu EDI-Umschlägen für Details zu jedem Feld):

1. Wählen Sie mit dem neuen Partner ausgewählt die Registerkarte EDI-Einstellungen aus, und klicken Sie dann auf das Symbol Erweitern, um die Schublade zu erweitern.

2. Öffnen Sie jeden Abschnitt in der erweiterten Schublade, und überprüfen oder ändern Sie die Werte gemäß den Details im EDI-Implementierungsleitfaden des Partners:

   

3. Klicken Sie auf die Schaltfläche Speichern.

5. Eine EDI-Datei vorbereiten

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

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

6. Kommunikation konfigurieren

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

Führen Sie diese Schritte aus, um eine FTP-Verbindung einzurichten:

1. Wählen Sie mit dem neuen Partner die Registerkarte Kommunikationseinstellungen aus:

   

2. Klicken Sie auf das Symbol Erweitern, um die Schublade zu erweitern.

3. Klicken Sie auf die Schaltfläche Erstellen und wählen Sie dann FTP-Verbindung aus. Das Fenster Neue FTP-Verbindung erstellen wird angezeigt:

   

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

   

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

5. Aktivieren Sie den Schalter Aktiv.

6. Erweitern Sie die Registerkarte Zusätzliche Optionen und aktivieren Sie dann den Schalter Download aktiv.

7. Erweitern Sie die Registerkarte Automatisierung.

8. Öffnen Sie auf der Registerkarte Automatisierung das Menü Häufigkeit und wählen Sie dann 15 Minuten aus.

9. Klicken Sie auf der Registerkarte Automatisierung auf das Symbol Kalender im Feld Nächste Ausführung und wählen Sie dann ein Datum und eine Uhrzeit für die Ausführung der Verbindung aus.

10. Erstellen Sie im Stammordner des FTP-Servers zwei Unterordner: Download und Upload. Wenn Sie die Testdatei in dieser Anleitung oder eine Testdatei von Ihrem Handelspartner verwenden, platzieren Sie diese im Ordner Download.

7. Überprüfung

Um zu überprüfen, ob Ihr Dokument gesendet wurde und die Testtransaktion erfolgreich verarbeitet wurde, suchen Sie auf der Seite „Transaktionen" danach:

Wenn Sie sie nicht sehen, öffnen Sie die Seite „Messaging", auf der die Transaktion und der Grund für ihren Fehler angezeigt werden sollten:

8. Integration

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

Führen Sie diese Schritte aus, um ein EDI-Integrationsprojekt zu erstellen:

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 Studio > Projekte aus dem Harmony-Portalmenü aus.

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 Mit dem Entwerfen beginnen.

5. Geben Sie in der Suchleiste der Design-Komponentenpalette des offenen Projekts EDI for Cloud v2 ein und wählen Sie den gefundenen Connector aus.

6. Geben Sie in der Endpunktkonfiguration von EDI for Cloud v2 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 dann die Aktivität Dokument abrufen per Drag-and-Drop auf einen Vorgang auf der Design-Canvas.

8. Konfigurieren Sie die Get Document-Aktivität:

   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. Überprüfen Sie in Schritt 3 das Datenschema und klicken Sie auf die Schaltfläche Fertig.

Fehlerbehebung

Weitere Informationen zur Fehlerbehebung finden Sie in den folgenden Abschnitten im EDI-Fehlerbehebungsleitfaden:

• EDI-Zugriffstoken deaktiviert verursacht INVALID_TOKEN-Fehler

• EDI for Cloud v2-Aktivität schlägt auf einem privaten Agent hinter einer Firewall oder einem Proxy fehl