Zum Inhalt springen

Jitterbit App Builder Create-Aktivität in Jitterbit Studio

Einführung

Eine Jitterbit App Builder Create-Aktivität verwendet die zugehörige Jitterbit App Builder-Verbindung und erstellt ein neues Element für ein Objekt in der Jitterbit App Builder-Anwendung. Sie soll als Ziel zum Verarbeiten von Daten in einem Vorgang verwendet werden.

Wenn die Datenquelle der Anwendung rollenbasierte Autorisierung nutzt, muss der App Builder-Benutzer, unter dem die Verbindung authentifiziert wird, über die Insert-Rollenberechtigung für das ausgewählte Objekt verfügen.

Jitterbit App Builder Create-Aktivität erstellen

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

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

Eine vorhandene Jitterbit App Builder Create-Aktivität kann an folgenden Orten bearbeitet werden:

Jitterbit App Builder Create-Aktivität konfigurieren

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

Schritt 1: Namen eingeben und Objekt auswählen

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

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben 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 Zugeordneten Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie mit der Maus über den aktuellen Endpunktnamen fahren. 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 Create-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Objekt auswählen: In diesem Bereich werden die in der Jitterbit App Builder-Anwendung verfügbaren Objekte angezeigt, die dem veröffentlichten OpenAPI-Dokument entnommen sind. Jedes benutzerdefinierte Ereignis, das über die REST-API der Anwendung verfügbar gemacht wird, wird als eigenes Objekt aufgeführt und nach der Ressource und dem Ereignis benannt (z. B. Department(Approve)). Wählen Sie das Objekt eines Ereignisses aus, um dieses Ereignis für einen Datensatz aufzurufen.

    • Ausgewähltes Objekt: Nach Auswahl eines Objekts wird es hier aufgeführt.

    • Suche: Geben Sie den Namen eines Objekts in das Suchfeld ein, um die Liste der Objekte zu filtern. Die Suche berücksichtigt keine Groß- und Kleinschreibung. Wenn Objekte bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse mit 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 hilfreich sein, wenn der Anwendung Objekte hinzugefügt wurden.

  • Ein 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 nicht gespeichert, bis Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach Vornahme 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.

Schritt 2: Einen Vorgang auswählen

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

  • Einen Vorgang auswählen: Dieser Bereich zeigt die für das ausgewählte Objekt verfügbaren Vorgänge. Bei einer Create-Aktivität ist ein Vorgang verfügbar. Für eine Ressource erstellt sie ein neues Element (z. B. „Element einfügen"). Für ein Ereignis wird das Ereignis aufgerufen (z. B. „Ereignis ‚Genehmigen' aufrufen").

    • 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 aus, 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 fehlgeschlagene Element mit der Fehlermeldung des Anbieters als fehlgeschlagen gekennzeichnet, 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 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 Vornahme 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.

Schritt 3: Die Datenschemas überprüfen

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

  • Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden während der Transformationszuordnung erneut angezeigt. Die Schemas mit den Namen createRequest und createResponse werden automatisch aus dem OpenAPI-Dokument der Anwendung generiert.

    Bei einem Ereignisobjekt enthält das Anforderungsschema ein einzelnes identifier-Feld unter params > path, das den Datensatz identifiziert, für den das Ereignis aufgerufen werden soll.

    Wenn das Objekt Audit Lite-Spalten wie addedBy und changedBy enthält, legt App Builder deren Werte fest, und alle auf sie zugeordneten 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, wo das gleiche Schema referenziert 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 anordnen sowie ihre Datentypen ändern. Alle neu hinzugefügten Knoten und Felder erhalten die Kardinalität [0, 1]. Änderungen an den Datenschemen 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 dem Bearbeiten der Schemas wird oben im betreffenden Schema ein letztes Bearbeitungsdatum angezeigt, um anzuzeigen, dass das Schema manuelle Bearbeitungen aufweist. Das Aktualisieren der Schemas setzt diese auf ihre Standardstrukturen zurück.

  • 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 Jitterbit App Builder Create-Aktivität ist die Konfiguration des Vorgangs durch das Hinzufügen und Konfigurieren weiterer Aktivitäten oder Tools als Vorgangsschritte abzuschließen. 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 Design-Canvas zugänglich. Weitere Informationen finden Sie unter Aktivitätsmenü „Aktionen" in Connector-Grundlagen.

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

Um die Aktivität mit Scripting-Funktionen zu verwenden, nutzen Sie die Aktivität als Ziel in einer Transformation, die von einem temporären Speicherort aus abbildet.

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