Zum Inhalt springen

Jitterbit App Builder Read-Aktivität in Jitterbit Studio

Einführung

Eine Jitterbit App Builder Read-Aktivität ruft mit ihrer Jitterbit App Builder-Verbindung ein oder mehrere Elemente aus einem Objekt in der Jitterbit App Builder-Anwendung ab und ist dazu gedacht, als Quelle zur Bereitstellung von Daten in einem Vorgang zu dienen.

Falls die Datenquelle der Anwendung rollenbasierte Autorisierung nutzt, muss der App Builder-Benutzer, für den die Verbindung authentifiziert wird, die Read-Rollenberechtigung für das ausgewählte Objekt haben.

Eine Jitterbit App Builder Read-Aktivität erstellen

Eine Instanz einer Jitterbit App Builder Read-Aktivität wird aus einer Jitterbit App Builder-Verbindung mit ihrem Read-Aktivitätstyp erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Tool-Instanz in Komponentenwiederverwendung.

Eine vorhandene Jitterbit App Builder Read-Aktivität kann von folgenden Orten aus bearbeitet werden:

Eine Jitterbit App Builder Read-Aktivität konfigurieren

Führen Sie diese Schritte aus, um eine Jitterbit App Builder Read-Aktivität zu konfigurieren:

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

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie ein Objekt aus. Alle Elemente der Benutzeroberfläche dieses Schritts werden nachfolgend beschrieben.

  • Endpunkt-Menü: Falls mehrere Endpunkte des gleichen 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 Den 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 Jitterbit App Builder Read-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Wählen Sie ein Objekt aus: Dieser Abschnitt zeigt die in der Jitterbit App Builder-Anwendung verfügbaren Objekte, die aus ihrem veröffentlichten OpenAPI-Dokument stammen. Ein Objekt, das nach einer Ressource und einem Event benannt ist (z. B. Department(Approve)), stellt ein benutzerdefiniertes Event dar, das über die REST-API der Anwendung verfügbar gemacht wird. Um ein Event aufzurufen, verwenden Sie stattdessen eine Create-Aktivität.

    • Ausgewähltes Objekt: Nach Auswahl eines Objekts wird es hier aufgelistet.

  • Suche: Geben Sie den Namen eines Objekts in das Suchfeld ein, um die Objektliste zu filtern. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden. Wenn Objekte bereits in der Tabelle angezeigt werden, werden die Tabellenelemente in Echtzeit mit jedem Tastendruck gefiltert.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Objekte aus dem OpenAPI-Dokument der Anwendung neu zu laden. Dies kann hilfreich sein, wenn der Anwendung Objekte hinzugefügt wurden.

  • Objekt auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Objekt auszuwählen. Es kann nur ein Objekt ausgewählt werden. Der Name jedes Objekts wird aus dem OpenAPI-Dokument der Anwendung abgerufen.

Tipp

Wenn die Tabelle sich nicht mit verfügbaren Objekten füllt, ist die Jitterbit App Builder-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

  • 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: Klicken Sie nach Änderungen, um die Konfiguration ohne Speicherung von Änderungen an einem beliebigen Schritt zu schließen. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Wählen Sie einen Vorgang aus

Wählen Sie in diesem Schritt einen Vorgang für das im vorherigen Schritt ausgewählte Objekt aus. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Vorgang auswählen: In diesem Bereich werden die Vorgänge angezeigt, die für das ausgewählte Objekt verfügbar sind. Bei einer Read-Aktivität sind zwei Vorgänge verfügbar: einer, der ein einzelnes Element nach Bezeichner abruft (z. B. „Rufen Sie ein Element „\" ab."), und einer, der die vollständige Elementsammlung des Objekts abruft (z. B. „Rufen Sie die Sammlung „\" ab.").

    • Klicken Sie auf eine beliebige Stelle in einer Zeile, um einen Vorgang auszuwählen. Es kann nur ein Vorgang ausgewählt werden.

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

    • Bei Fehler fortfahren: Wählen Sie diese Option, um die Verarbeitung der verbleibenden Elemente in einem Batch fortzusetzen, wenn ein Element fehlschlägt. Standardmäßig ist diese Option nicht aktiviert und der Vorgang stoppt beim ersten fehlgeschlagenen Element und meldet die Fehlermeldung des Anbieters. Wenn diese Option aktiviert ist, wird jedes fehlerhafte Element mit der Fehlermeldung des Anbieters markiert, und die anderen Elemente geben ihre normalen Ergebnisse zurück. Jedes Element in der Antwort enthält ein isSuccess-Feld, ein status-Feld (zurückgegeben als leere Zeichenfolge) und für ein fehlgeschlagenes Element errors.cause- und errors.detailedMessage-Felder, die den Fehler beschreiben.

  • 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: Klicken Sie nach Änderungen, um die Konfiguration ohne Speicherung von Änderungen an einem beliebigen Schritt zu schließen. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

    • Schritt 3: Überprüfen Sie die Datenschemas

    Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

    • Datenschemas: Diese Datenschemas werden von benachbarten Transformationen geerbt und werden während der Datenzuordnung in Transformationen erneut angezeigt. Die Schemas mit den Namen readRequest und readResponse werden automatisch aus dem OpenAPI-Dokument der Anwendung generiert.

      Nur der Sammlungsvorgang gibt mehr als ein Element zurück, und er gibt einen Seitenumbruch von Elementen pro Aufruf zurück. Der Connector ruft zusätzliche Seiten nicht automatisch ab. Die Felder $limit, $offset und $count werden neben $filter und $sort in den Schemas angezeigt und Sie können sie wie jedes andere Feld zuordnen. Um jedes Element in einer großen Sammlung abzurufen, rufen Sie die Aktivität in einer Schleife auf: Erhöhen Sie $offset nach jedem Aufruf um $limit, und stoppen Sie, wenn ein Aufruf weniger Elemente als $limit zurückgibt oder $count zeigt, dass keine Elemente verbleiben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Schemas aus dem OpenAPI-Dokument der Anwendung neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer benachbarten Transformation.

    • Bearbeiten: Klicken Sie auf das Bearbeitungssymbol über jedem Datenschema, um den Editor für dieses Datenschema zu öffnen. Im Editor können Sie Knoten und Felder hinzufügen, löschen und neu organisieren sowie deren Datentypen ändern. Alle neu hinzugefügten Knoten und Felder sind auf [0, 1] Kardinalität eingestellt. Änderungen an den Datenschemas müssen mit dem OpenAPI-Dokument der Anwendung kompatibel sein und sollten nur nach Rücksprache mit der eigenen API-Dokumentation der Anwendung vorgenommen werden. Nach der Bearbeitung von Schemas wird oben im entsprechenden Schema ein Datum der letzten Bearbeitung angezeigt, um anzuzeigen, dass das Schema manuelle Änderungen aufweist. Das Aktualisieren der Schemas setzt die Schemas auf ihre Standardstrukturen zurück.

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

    • Fertig: Klicken Sie hier, 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 hier, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung bittet Sie, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

    Nächste Schritte

    Schließen Sie nach der Konfiguration einer Jitterbit App Builder-Aktivität Lesen die Konfiguration des Vorgangs ab, indem Sie andere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit umfassen, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

    Menüaktionen für eine Aktivität sind vom Projektbereich und vom Design Canvas aus zugänglich. Details finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

    Jitterbit App Builder-Aktivitäten Lesen können als Quelle mit diesen Vorgangsmustern verwendet werden:

    Um die Aktivität mit Scripting-Funktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann in der Scripting-Funktion.

    Wenn alles bereit ist, stellen Sie den Vorgang bereit und führen ihn aus und überprüfen Sie das Verhalten durch Prüfung der Vorgangsprotokolle.