Zum Inhalt springen

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

Einführung

Eine EDI for Cloud v2 Get Document-Aktivität verwendet ihre EDI for Cloud v2-Verbindung zum Abrufen aller Dokumente (von einem bestimmten Partner) aus Jitterbit EDI und dient als Quelle zum Bereitstellen von Daten in einem Prozess.

Jedes Mal, wenn die Aktivität ausgeführt wird, protokolliert Jitterbit EDI eine Nachricht, die den Namen des Prozesses enthält, von dem sie ausgeführt wurde. Um diese Nachrichten zu finden, suchen Sie nach diesem Namen auf der Seite Messaging von Jitterbit EDI. Bei einem privaten Agent ist Agent-Version 12.6 oder später erforderlich.

Wichtig

Dieser Connector erfordert ein Abonnement für Jitterbit EDI. Kontaktieren Sie Ihren Customer Success Manager (CSM) für weitere Informationen.

EDI for Cloud v2 Get Document-Aktivität erstellen

Eine Instanz einer EDI for Cloud v2 Get Document-Aktivität wird aus einer EDI for Cloud v2-Verbindung mithilfe ihres Aktivitätstyps Get Document erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Leinwand oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Leinwand ein. Weitere Informationen finden Sie unter Aktivitäts- oder Tool-Instanz erstellen in Komponenten-Wiederverwendung.

Eine bestehende EDI for Cloud v2 Get Document-Aktivität kann von diesen Speicherorten aus bearbeitet werden:

EDI for Cloud v2 Get Document-Aktivität konfigurieren

Befolgen Sie diese Schritte, um eine EDI for Cloud v2 Get Document-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Partner auswählen

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.

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, 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, 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 Get Document-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Partner auswählen: Dieser Abschnitt zeigt die Partner an, die im EDI for Cloud v2-Endpunkt verfügbar sind.

    • Ausgewählter Partner: Nach Auswahl eines Partners wird dieser hier aufgelistet.

    • Suche: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Partner zu filtern. Die Suche erfolgt ohne Berücksichtigung der Groß-/Kleinschreibung. Wenn Partner bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Partner vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie die Seite wie nachfolgend beschrieben.

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

  • 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-Endpunkt 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 Testen fügen Sie mindestens einen EDI-Partner hinzu.

  • Speichern und beenden: Falls aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt temporär zu speichern und zum nächsten Schritt zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt 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 2: Dokumenttyp auswählen

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

  • Dokumenttyp auswählen: Dieser Abschnitt zeigt Dokumenttypen, die im EDI for Cloud v2-Endpunkt verfügbar sind.

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

    • Ausgewählter Dokumenttyp: Nach der Auswahl eines Dokumenttyps 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ß- und Kleinschreibung nicht berücksichtigt. Wenn Dokumenttypen bereits in der Tabelle angezeigt werden, werden die Tabellenabfragen mit jedem Tastendruck in Echtzeit gefiltert. Um Dokumenttypen vom Endpunkt neu zu laden, wenn Sie suchen, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Dokumenttypen vom EDI for Cloud v2-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Dokumenttypen zu Jitterbit EDI hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der angezeigten Dokumenttyptabelle 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-Endpunkt 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 Inbound-Dokumentworkflow hinzufügen. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen. Nach dem Testen fügen Sie einen Inbound-Workflow für den Partner hinzu.

  • Max. Dokumente aktivieren: Aktivieren Sie dieses Kontrollkästchen, um die Anzahl der pro Operationsausführung abgerufenen Dokumente zu begrenzen. Falls nicht aktiviert, ruft die Aktivität alle heruntergeladenen Dokumente für den ausgewählten Partner und Dokumenttyp ab. Falls aktiviert, wird ein zusätzliches Feld (Max. Dokumente) angezeigt:

    • Max. Dokumente: Geben Sie die maximale Anzahl der Dokumente ein, die pro Operationsausführung abgerufen werden sollen. Die Aktivität ruft Dokumente in der Reihenfolge des Transaktionsdatums ab, beginnend mit dem frühesten verfügbaren. Nachfolgende Operationsausführungen rufen automatisch alle verbleibenden heruntergeladenen Dokumente ab. Der Standardwert ist 100. Der Mindestwert ist 1 und der Maximalwert ist 1000.

  • 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 wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen in einem beliebigen Schritt zu speichern. Eine Nachricht 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 nachfolgend beschrieben.

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

    Wichtig

    Der Wert eiCloudID kann für die Felder docInfo in den Aktivitäten Status abrufen und Status festlegen oder für das Feld docsysno in der Aktivität Transaction Raw Data verwendet werden.

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

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder 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, wie z. B. 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: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen in einem beliebigen Schritt zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach dem Konfigurieren einer EDI for Cloud v2-Aktivität Dokument abrufen schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich im gleichen oder in verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Designoberfläche verfügbar. Weitere Informationen finden Sie unter Aktionsmenü für Aktivitäten in Connector-Grundlagen.

Aktivitäten des Typs EDI for Cloud v2 Dokument abrufen können mit diesen Vorgangsmustern als Quelle verwendet werden:

Wenn Sie die Aktivität mit Scripting-Funktionen verwenden möchten, schreiben Sie die Daten in einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort in der Scripting-Funktion.

Wenn Sie fertig sind, stellen Sie bereit und führen Sie den Vorgang aus und validieren Sie das Verhalten durch Überprüfung der Vorgangsprotokolle.