Jitterbit App Builder Delete-Aktivität in Jitterbit Studio

Einführung

Eine Jitterbit App Builder Delete-Aktivität löscht mit ihrer Jitterbit App Builder-Verbindung ein vorhandenes Element eines Objekts in der Jitterbit App Builder-Anwendung und dient als Ziel zum Verarbeiten von Daten in einem Vorgang.

Falls die Datenquelle der Anwendung rollenbasierte Autorisierung nutzt, muss der App Builder-Benutzer, unter dem sich die Verbindung authentifiziert, die Delete-Rollenberechtigung für das ausgewählte Objekt haben.

Erstelle eine Jitterbit App Builder Delete-Aktivität

Eine Instanz einer Jitterbit App Builder Delete-Aktivität wird aus einer Jitterbit App Builder-Verbindung mithilfe ihres Delete-Aktivitätstyps erstellt.

Um eine Aktivitätsinstanz zu erstellen, ziehe den Aktivitätstyp auf die Entwurfsfläche oder kopiere den Aktivitätstyp und füge ihn auf der Entwurfsfläche ein. Nähere Informationen findest du unter Aktivitäts- oder Tool-Instanz erstellen in Komponentenwiederverwendung.

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

Die Entwurfsfläche (siehe Komponenten-Aktionsmenü in Entwurfsfläche).
Die Registerkarte Komponenten des Projektbereichs (siehe Komponenten-Aktionsmenü in Projektbereich – Registerkarte „Komponenten").

Konfiguriere eine Jitterbit App Builder Delete-Aktivität

Führe diese Schritte aus, um eine Jitterbit App Builder Delete-Aktivität zu konfigurieren:

Schritt 1: Gib einen Namen ein und wähle ein Objekt
Gib einen Namen für die Aktivität ein und wähle ein Objekt.
Schritt 2: Wähle einen Vorgang
Wähle einen Vorgang und aktiviere optional Bei Fehler fortfahren.
Schritt 3: Überprüfe die Datenschemas
Alle Anfrage- oder Antwortschemas werden angezeigt.

Schritt 1: Gib einen Namen ein und wähle ein Objekt

Gib in diesem Schritt einen Namen für die Aktivität ein und wähle ein Objekt. Alle Elemente der Benutzeroberfläche in diesem Schritt sind nachfolgend beschrieben.

Endpunkt-Menü: Falls du mehrere Endpunkte desselben Connector-Typs konfiguriert hast, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicke auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen findest du unter Weise den Endpunkt neu zu in Konfigurationsbildschirme.
- Endpunkt bearbeiten: Wird angezeigt, wenn du den Cursor über dem aktuellen Endpunktnamen positionierst. Klicke, um die Verbindungskonfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.
Name: Gib einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Jitterbit App Builder Delete-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.
Wähle ein Objekt: Dieser Abschnitt zeigt die Objekte an, die in der Jitterbit App Builder-Anwendung verfügbar sind, entnommen aus ihrem veröffentlichten OpenAPI-Dokument. Ein Objekt, das nach einer Ressource und einem Ereignis benannt wird (z. B. Department(Approve)), stellt ein benutzerdefiniertes Ereignis dar, das über die REST-API der Anwendung bereitgestellt wird. Um ein Ereignis aufzurufen, nutze 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. Die Suche ist nicht case-sensitive. Wenn Objekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit bei jedem Tastendruck gefiltert.
Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Objekte aus dem OpenAPI-Dokument der Anwendung neu zu laden. Dies kann hilfreich sein, wenn der Anwendung neue 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 nicht mit verfügbaren Objekten gefüllt wird, 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 der Änderung, 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: Operation auswählen

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

Operation auswählen: Dieser Bereich zeigt die verfügbaren Operationen für das ausgewählte Objekt an. Für eine Löschen-Aktivität ist eine Operation verfügbar, die ein vorhandenes Element für das Objekt löscht (z. B. "Löschen Sie ein '\
'-Element.").
- Klicken Sie auf eine beliebige Stelle in einer Zeile, um eine Operation auszuwählen. Es kann nur eine Operation 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 ausgewählt, und die Operation stoppt beim ersten fehlgeschlagenen Element und meldet die Fehlermeldung des Anbieters. Wenn diese Option ausgewählt 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 (wird 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 erst gespeichert, wenn Sie auf die Schaltfläche Fertig im letzten Schritt klicken.

Änderungen verwerfen: Klicken Sie nach der Änderung, 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 nachfolgend beschrieben.
- Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen übernommen und werden erneut während der Transformationszuordnung angezeigt. Die Schemas deleteRequest und deleteResponse werden automatisch aus dem OpenAPI-Dokument der Anwendung generiert.
- Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas aus dem OpenAPI-Dokument der Anwendung neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen auf das gleiche 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. Der Editor ermöglicht es Ihnen, Knoten und Felder hinzuzufügen, zu löschen und neu zu ordnen sowie deren Datentypen zu ändern. Alle neu hinzugefügten Knoten und Felder werden auf die Kardinalität [0, 1] eingestellt. Ä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 selbst vorgenommen werden. Nach dem Bearbeiten von Schemas wird oben im entsprechenden Schema ein Datum der letzten Bearbeitung angezeigt, um anzuzeigen, dass das Schema manuelle Bearbeitungen hat. Wenn Sie die Schemas aktualisieren, werden die Schemas auf ihre Standardstrukturen zurückgesetzt.
- Zurück: Klicken, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.
- Fertig: Klicken, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.
- Änderungen verwerfen: Nach Änderungen klicken, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert zur Bestätigung auf, dass die Änderungen verworfen werden sollen.
Nächste Schritte

Nachdem eine Jitterbit App Builder Delete-Aktivität konfiguriert wurde, vervollständigen Sie die Konfiguration des Vorgangs, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, mit denen Vorgänge verkettet werden können, die sich in denselben oder verschiedenen Workflows befinden.

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

Jitterbit App Builder Delete-Aktivitäten können als Ziel mit diesen Vorgangsmustern verwendet werden:
Um die Aktivität mit Skriptfunktionen zu verwenden, nutzen Sie die Aktivität als Ziel in einer Transformation, die von einem temporären Speicherort aus zuordnet.

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