Zum Inhalt springen

EDI for Cloud v2 Send Document-Aktivität in Jitterbit Studio

Einführung

Eine EDI for Cloud v2 Send Document-Aktivität verwendet ihre EDI for Cloud v2-Verbindung zum Senden von Dokumenten an Jitterbit EDI und dient als Ziel zum Verarbeiten von Daten in einem Vorgang.

Wichtig

Dieser Connector erfordert ein Abonnement für Jitterbit EDI. Wenden Sie sich an Ihren Customer Success Manager (CSM), um weitere Informationen zu erhalten.

Erstellen einer EDI for Cloud v2 Send Document-Aktivität

Eine EDI for Cloud v2 Send Document-Aktivität wird aus einer EDI for Cloud v2-Verbindung mit ihrem Aktivitätstyp Send Document erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Designoberfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Designoberfläche ein. Einzelheiten finden Sie unter Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

Eine vorhandene EDI for Cloud v2 Send Document-Aktivität kann an diesen Stellen bearbeitet werden:

Konfigurieren einer EDI for Cloud v2 Send Document-Aktivität

Führen Sie die folgenden Schritte aus, um eine EDI for Cloud v2 Send Document-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und wählen Sie einen Partner aus

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie einen Partner aus. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Endpunktmenü: Falls Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, zeigt ein Menü oben im Bildschirm den aktuellen Endpunktnamen an. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie hier, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.
  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede EDI for Cloud v2 Send Document-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Partner auswählen: Dieser Bereich zeigt die im EDI for Cloud v2-Endpunkt verfügbaren Partner an.

    • Ausgewählter Partner: Nachdem ein Partner ausgewählt wurde, wird er hier aufgelistet.

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Partnerliste zu filtern. Die Suche unterscheidet nicht zwischen Groß- und Kleinschreibung. Falls Partner bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Partner vom Endpunkt bei der Suche neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie nachfolgend beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Partner vom EDI for Cloud v2-Endpunkt neu zu laden. Dies kann hilfreich sein, falls Partner zu Jitterbit EDI hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Partnertabelle verwendet werden, die in der Konfiguration angezeigt wird.

  • Partner auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um einen Partner auszuwählen. Es kann nur ein Partner ausgewählt werden. Die für jeden Partner verfügbaren Informationen werden vom EDI for Cloud v2-Endpoint abgerufen:

    • Name: Der Name des Partners.

    • Beschreibung: Die Beschreibung des Partners.

Tipp

Wenn die Tabelle nicht mit verfügbaren Partnern gefüllt wird, ist die EDI for Cloud v2-Verbindung möglicherweise nicht erfolgreich, oder Sie müssen möglicherweise einen EDI-Partner hinzufügen. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen. Nach dem Test fügen Sie mindestens einen EDI-Partner hinzu.

  • Speichern und Beenden: Klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen (falls aktiviert).

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Stufe auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach vorgenommenen Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie Änderungen verwerfen möchten.

Schritt 2: Dokumenttyp und alternative Kommunikationsmethode auswählen

Wählen Sie in diesem Schritt einen Dokumenttyp und eine alternative Kommunikationsmethode aus. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Dokumenttyp auswählen: In diesem Bereich werden Dokumenttypen angezeigt, die im EDI for Cloud v2-Endpoint verfügbar sind.

    • Ausgewählter Partner: Der im vorherigen Schritt ausgewählte Partner wird hier aufgelistet.

    • Ausgewählter Dokumenttyp: Nachdem ein Dokumenttyp ausgewählt wurde, wird er hier aufgelistet.

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Dokumenttypen zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht berücksichtigt. Wenn Dokumenttypen bereits in der Tabelle angezeigt werden, werden die Tabellergebnisse bei jedem Tastendruck in Echtzeit gefiltert. Um Dokumenttypen vom Endpoint neu zu laden, wenn Sie suchen, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie nachfolgend beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Dokumenttypen vom EDI for Cloud v2-Endpoint neu zu laden. Dies kann hilfreich sein, wenn Dokumenttypen zu Jitterbit EDI hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Tabelle mit Dokumenttypen verwendet werden.

    • Dokumenttyp auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um einen Dokumenttyp auszuwählen. Es kann nur ein Dokumenttyp ausgewählt werden. Die für jeden Dokumenttyp verfügbaren Informationen werden vom EDI for Cloud v2-Endpoint abgerufen:

      • Name: Der Name des Dokumenttyps.

      • Beschreibung: Die Beschreibung des Dokumenttyps.

Tipp

Wenn die Tabelle nicht mit verfügbaren Dokumenttypen gefüllt wird, ist die EDI for Cloud v2-Verbindung möglicherweise nicht erfolgreich, oder Sie müssen möglicherweise einen neuen Outbound-Dokumentworkflow hinzufügen. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen. Nach dem Test fügen Sie einen Outbound-Workflow für den Partner hinzu.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • Alternative Kommunikationsmethode verwenden: Wählen Sie diese Option, um eine andere Verbindung als die dem ausgewählten Partner in Jitterbit EDI zugewiesene zu verwenden. Wenn diese Option aktiviert ist, wird eine Verbindungstabelle angezeigt, in der bestehende Verbindungen aufgelistet sind, die Ihrer aktuellen Harmony-Umgebung zugeordnet sind.

    • Verbindung auswählen: Wenn Alternative Kommunikationsmethode verwenden aktiviert ist, werden in diesem Bereich Verbindungen angezeigt, die Ihrer aktuellen Harmony-Umgebung zugeordnet sind und im EDI for Cloud v2-Endpoint verfügbar sind. Informationen zum Hinzufügen weiterer Verbindungen finden Sie unter Kommunikation in Jitterbit EDI.

  • Ausgewählte Verbindung: Nach der Auswahl einer Verbindung wird diese hier aufgelistet. Der zuvor ausgewählte Partner wird darüber angezeigt.

  • Suche: Geben Sie einen beliebigen Wert aus einer Spalte in das Suchfeld ein, um die Liste der Verbindungen zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Wenn Verbindungen bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Verbindungen vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Verbindungen vom EDI for Cloud v2-Endpunkt neu zu laden. Dies kann hilfreich sein, wenn Verbindungen zu Jitterbit EDI hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der angezeigten Verbindungstabelle in der Konfiguration verwendet werden.

  • Eine Verbindung auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um eine Verbindung auszuwählen. Es kann nur eine Verbindung ausgewählt werden. Die für jede Verbindung verfügbaren Informationen werden vom EDI for Cloud v2-Endpunkt abgerufen.

    • Name: Der Name der Verbindung.

    • Typ: Der Typ der Verbindung.

    • Status: Der Status der Verbindung.

Tipp

Wenn eine Verbindung nicht wie erwartet in der Tabelle angezeigt wird, kann dies auf einen der folgenden Gründe zurückzuführen sein:

  • Die EDI for Cloud v2-Verbindung ist möglicherweise nicht erfolgreich, oder Sie müssen möglicherweise Verbindungen zu Jitterbit EDI in Ihrer aktuellen Harmony-Umgebung hinzufügen. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen. Fügen Sie nach dem Testen mindestens eine Verbindung hinzu.

  • Das erneute Öffnen der Aktivitätskonfiguration kann dazu führen, dass eine zuvor angezeigte Verbindung aus der Tabelle verschwindet. Klicken Sie auf Aktualisieren, um sie anzuzeigen.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt zu gelangen. Die Konfiguration wird nicht gespeichert, bis Sie auf dem letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 3: Datenschemas überprüfen

Alle Request- oder Response-Schemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

  • Datenschemas: Diese Datenschemas werden von benachbarten Transformationen geerbt und werden während der Transformationszuordnung erneut angezeigt.

    Der EDI for Cloud v2-Connector verwendet eine benutzerdefinierte Jitterbit-API.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Schemas vom EDI for Cloud v2-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf das gleiche Schema verwiesen wird, beispielsweise in einer benachbarten Transformation.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem beliebigen Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer EDI for Cloud v2-Aktivität vom Typ Send Document schließen Sie die Konfiguration des Vorgangs ab, indem Sie andere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangeinstellungen konfigurieren, die die Möglichkeit beinhalten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktivitätsaktionsmenü in Connector-Grundlagen.

EDI for Cloud v2 Send Document Aktivitäten können als Ziel mit diesen Operationsmustern verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Skriptfunktion.

Wenn fertig, stellen Sie die Operation bereit und führen Sie sie aus und validieren Sie das Verhalten durch Überprüfung der Operationsprotokolle.