Zum Inhalt springen

Jitterbit App Builder Update-Aktivität in Jitterbit Studio

Einführung

Eine Jitterbit App Builder Update-Aktivität aktualisiert mit ihrer Jitterbit App Builder-Verbindung ein vorhandenes Element für ein Objekt in der Jitterbit App Builder-Anwendung und soll als Ziel zum Verarbeiten von Daten in einem Vorgang verwendet werden.

Falls die Datenquelle der Anwendung rollengestützte Autorisierung verwendet, muss der App Builder-Benutzer, der die Verbindung authentifiziert, die Update-Rollenberechtigung für das ausgewählte Objekt haben.

Erstellen einer Jitterbit App Builder Update-Aktivität

Eine Instanz einer Jitterbit App Builder Update-Aktivität wird über eine Jitterbit App Builder-Verbindung mit dem Aktivitätstyp Update erstellt.

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

Eine vorhandene Jitterbit App Builder Update-Aktivität kann über diese Speicherorte bearbeitet werden:

Konfigurieren einer Jitterbit App Builder Update-Aktivität

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

Schritt 1: Name eingeben und Objekt auswählen

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

  • Endpunktmenü: Wenn mehrere Endpunkte des gleichen Connectortyps konfiguriert sind, zeigt ein Menü oben auf dem 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 Jitterbit App Builder Update-Aktivität eindeutig sein und darf keinen Schrägstrich / oder Doppelpunkt : enthalten.

  • Objekt auswählen: Dieser Bereich zeigt die in der Jitterbit App Builder-Anwendung verfügbaren Objekte an, entnommen aus dem veröffentlichten OpenAPI-Dokument. Ein Objekt, das nach einer Ressource und einem Ereignis benannt ist (zum Beispiel Department(Approve)), stellt ein benutzerdefiniertes Ereignis dar, das über die REST-API der Anwendung bereitgestellt wird. Um ein Ereignis aufzurufen, verwenden Sie stattdessen eine Create-Aktivität.

    • Ausgewähltes Objekt: Nach der 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 die Groß-/Kleinschreibung nicht beachtet. Wenn Objekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse bei jedem Tastendruck in Echtzeit 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 nützlich 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 nicht gespeichert, bis Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

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

Schritt 2: Einen Vorgang auswählen

Wählen Sie in diesem Schritt einen Vorgang für das im vorherigen Schritt ausgewählte Objekt aus. Nachfolgend werden die einzelnen Elemente der Benutzeroberfläche dieses Schritts beschrieben.

  • Vorgang auswählen: Dieser Abschnitt zeigt die für das ausgewählte Objekt verfügbaren Vorgänge an. Für eine Update-Aktivität sind zwei Vorgänge verfügbar: einer, der die Daten eines vorhandenen Elements vollständig ersetzt (z. B. „Ein Element ersetzen."), und einer, der nur die bereitgestellten Felder für ein vorhandenes Element aktualisiert (z. B. „Ein Element aktualisieren.").

    • 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. Diese Option ist standardmäßig nicht aktiviert, und der Vorgang stoppt beim ersten fehlgeschlagenen Element und meldet die Fehlermeldung des Anbieters. Wenn diese Option aktiviert ist, wird jedes fehlgeschlagene Element als fehlgeschlagen 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 (als leere Zeichenkette zurückgegeben) und für ein fehlgeschlagenes Element die Felder errors.cause und errors.detailedMessage, 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 nicht gespeichert, bis Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

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

Schritt 3: Die Datenschemas überprüfen

Alle Anfrage- oder Antwortschemas werden angezeigt. Nachfolgend werden die einzelnen Elemente der Benutzeroberfläche dieses Schritts beschrieben.

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

    Wenn das Objekt Audit Lite-Spalten enthält, z. B. addedBy und changedBy, legt App Builder deren Werte fest, und alle auf sie abgebildeten Werte werden ignoriert. Die Werte identifizieren den App Builder-Benutzer, der die Anmeldedaten in den Authentifizierungseinstellungen der Verbindung besitzt, sodass alle Änderungen unter diesem einen Benutzer aufgezeichnet werden.

  • 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 angrenzenden Transformation.

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

  • 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 Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Jitterbit App Builder-Aktivität Aktualisieren müssen Sie die Konfiguration des Vorgangs abschließen, indem Sie andere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, mit denen Sie Vorgänge verknüpfen können, die sich im selben oder in verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Designoberfläche verfügbar. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" unter Connector-Grundlagen.

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

Um die Aktivität mit Skriptfunktionen zu verwenden, müssen Sie die Aktivität als Ziel in einer Transformation verwenden, die von einem temporären Speicherort aus zugeordnet wird.

Wenn alles bereit ist, stellen Sie den Vorgang bereit und führen Sie ihn aus, und überprüfen Sie das Verhalten, indem Sie die Vorgangsprotokolle kontrollieren.