Leitfaden für die ersten Schritte mit Jitterbit EDI

Einführung

In diesem Leitfaden erfahren Sie, wie Sie Jitterbit EDI für die Verarbeitung einer X12 850 4010-Transaktion einrichten. (Sie können ein anderes Dokument oder einen anderen Standard verwenden, aber die Einstellungen unterscheiden sich.)

Dieser Leitfaden führt Sie durch die folgenden Aufgaben:

1. Informationen sammeln
2. Generieren Sie eine EDI-ID und fügen Sie einen Partner hinzu
3. Erstellen Sie einen oder mehrere Workflows
4. Konfigurieren Sie EDI-Einstellungen
5. Bereiten Sie eine EDI-Datei vor
6. Konfigurieren Sie die Kommunikation
7. Verifizieren
8. Integrieren Sie EDI

1. Informationen sammeln

Koordinieren Sie sich mit jedem Handelspartner, um Tests zu planen und deren Implementierungsleitfäden, Kommunikationseinstellungen 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 diesem Leitfaden nicht behandelt. Wenn Sie diese verwenden müssen, siehe Kommunikation, oder kontaktieren Sie den Jitterbit Support oder Ihren Customer Success Manager (CSM).)

• Ein EDI-Testdokument.

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

Standardmäßig sind in Jitterbit EDI keine Partner eingerichtet. Wenn Sie das erste Mal einen Partner hinzufügen, werden Sie aufgefordert, eine EDI-ID zu generieren.

Führen Sie diese Schritte aus, um Ihren ersten Partner hinzuzufügen und Ihre EDI-ID zu generieren:

1. Wählen Sie EDI > Trading Partners im Harmony-Portalmenü. Die Seite Trading Partners wird geöffnet:

   

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

   

3. Auf dieser Seite werden über 1000 Partner aufgelistet, die Ihrer Umgebung hinzugefügt werden können. Um den gewünschten Partner zu suchen, geben Sie seinen Namen oder seine ID in die Suchleiste ein. (Falls der gewünschte Partner im System nicht vorhanden ist, müssen Sie ihn selbst erstellen.)

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

   

5. Da dies das erste Mal ist, dass Sie Jitterbit EDI in der ausgewählten Umgebung einrichten, wird das Dialogfeld Generating Your EDI ID geöffnet. Geben Sie den Qualifizierer-Code und die EDI-ID Ihrer Organisation ein.

   Tipp

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

   Wichtig

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

6. Wenn Sie sich Ihrer Codes sicher sind, klicken Sie auf die Schaltfläche Save.

7. Um die Schublade Add trading partner zu schließen, klicken Sie 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 einen oder mehrere Workflows für diesen Partner definieren.

Führen Sie diese Schritte aus, um einen Workflow zu erstellen:

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

   

2. Legen Sie die folgenden Felder fest:

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

     Tip

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

   • EDI-Standard: X12

   • Dokumenttyp: 850 (Hinweis: Verwenden Sie für diese Einrichtung X12 als EDI-Standard und konsultieren Sie 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, werden auf der Registerkarte EDI-Einstellungen Felder angezeigt, die für die Einstellung gelten, die Sie für EDI-Standard verwendet haben (X12 in diesem Fall) für den ersten Workflow, der auf der Registerkarte Workflows verwalten aufgeführt ist. (Bis Sie Ihren ersten Workflow erstellen, ist die Registerkarte EDI-Einstellungen leer.) Diese Felder sind die EDI-Envelope-Einstellungen, die für die Verarbeitung von ausgehenden EDI-Dokumenten verwendet werden.

Führen Sie diese Schritte aus, um die EDI-Envelope-Einstellungen zu konfigurieren (konsultieren Sie den Implementierungsleitfaden Ihres Partners für Hinweise zu Werten und den Referenzabschnitt für EDI-Envelopes für Details zu jedem Feld):

1. Wählen Sie bei ausgewähltem neuem Partner 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 benötigen Sie eine Testdatei von Ihrem Handelspartner. Wenn Sie keine erhalten können, verwenden Sie die Beispiel 850 4010, achten Sie aber darauf, die IDs der Datei so zu ändern, dass sie Ihren EDI-Einstellungen entsprechen.

In diesem Beispiel wird erläutert, wie Sie die richtige Kopfzeile 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. Nutzen Sie das Harmony-Portalmenü, um EDI > Kommunikation auszuwählen:

   

2. Klicken Sie auf die Schaltfläche Neu, und wählen Sie dann FTP-Verbindung. Die Schublade Neue FTP-Verbindung wird geöffnet:

   

3. 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 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.

4. Aktivieren Sie im Bereich Zusätzliche Optionen das Kontrollkästchen Download aktiv.

5. Öffnen Sie im Bereich Automatisierung das Menü Häufigkeit, und wählen Sie dann 15 Minuten.

6. Klicken Sie im Bereich Automatisierung auf das Kalendersymbol im Feld Nächste Ausführung, und wählen Sie dann ein Datum und eine Uhrzeit für die Ausführung der Verbindung.

7. Klicken Sie auf die Schaltfläche Speichern.

8. Wählen Sie die neue Verbindung aus. Schalten Sie in der Schublade auf der Registerkarte Handelspartner den Schalter Zuweisen für den neuen Partner ein, und klicken Sie dann auf Speichern.

9. Erstellen Sie im Stammordner des FTP-Servers zwei Unterordner: Download und Upload. Wenn Sie die Testdatei aus dieser Installationsanleitung oder eine Testdatei von Ihrem Handelspartner verwenden, legen Sie diese im Ordner Download ab.

7. Überprüfung

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

Falls Sie sie nicht sehen, öffnen Sie die Seite „Nachrichten", wo Ihnen die Transaktion und der Grund für ihren Fehler angezeigt werden:

8. Integration

Wenn Jitterbit EDI erfolgreich mit Partnern kommuniziert und Dokumente verarbeitet, können Sie Studio nutzen, um die anderen 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 im Harmony-Portalmenü Studio > Projekte.

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 Entwurf beginnen.

5. Geben Sie in der Suchleiste der Paletten der Entwurfskomponenten Ihres offenen Projekts EDI for Cloud v2 ein, und wählen Sie dann 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 Paletten der Entwurfskomponenten unter Verfügbare Endpunkte auf den Endpunkt Jitterbit EDI V2, und ziehen Sie die Aktivität Dokument abrufen per Drag-and-Drop zu einem Vorgang auf der Entwurfsleinwand.

8. Konfigurieren Sie die Aktivität „Dokument abrufen":

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

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

11. Überprüfen Sie in Schritt 3 das Datenschema, und klicken Sie dann auf die Schaltfläche Fertig.

Fehlerbehebung

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

• Deaktiviertes EDI-Zugriffstoken verursacht Fehler INVALID_TOKEN

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