Zum Inhalt springen

Variable Schreibaktivität

Einführung

Eine Variable-Schreibaktivität schreibt Daten an einen Endpoint und soll als Ziel für die Nutzung von Daten in einem Operation verwendet werden. Nachdem Sie eine Variablenverbindung konfiguriert haben, können Sie für jede Variablenverbindung beliebig viele Variablenaktivitäten konfigurieren.

Weitere Informationen zur Verwendung von Variablen in Scripts, Transformations und Verbindungs-/Aktivitätskonfigurationsbildschirmen finden Sie unter Variablen.

Erstellen einer variablen Aktivität

Aus einer Verbindung wird mithilfe eines Aktivitätstyps eine Instanz einer Aktivität 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ätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer variablen Schreibaktivität

Führen Sie die folgenden Schritte aus, um eine Variable-Write-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und geben Sie ein Schema an

Variable Schreibaktivität 1

  • Name: Geben Sie einen Namen ein, der zur Identifizierung der Variablenschreibaktivität verwendet werden soll. Der Name muss für jede Variablenschreibaktivität eindeutig sein und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:).

  • Anforderungsschema bereitstellen: Das Schema definiert die Struktur der Daten, die von der Aktivität „Variable schreiben“ verwendet werden. Ob ein Schema erforderlich ist, hängt davon ab, ob die Aktivität als Ziel einer Transformation verwendet wird (siehe Schemaverwendung). Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration finden Sie unter In einer Aktivität definierte Schemata.

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

  • Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen hier, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen der Datenschemata

Variable Schreibaktivität 2

  • Datenschema: Falls während der Aktivitätskonfiguration angegeben, wird das Anforderungsdatenschema angezeigt. Wenn die Operation eine Transformation verwendet, werden die Schema später während der Transformation erneut angezeigt-Prozess, bei dem Sie mithilfe von Quellobjekten, Scripts, Variablen, benutzerdefinierten Werten und mehr Zielfelder zuordnen können. Sie können auch Schemata direkt in einer Transformation definieren.

  • Plugin(s) hinzufügen: Plugins sind von Jitterbit oder vom Benutzer bereitgestellte Anwendungen, die die nativen Funktionen von Harmony erweitern. Um ein Plugin auf die Aktivität anzuwenden, klicken Sie, um diesen Abschnitt zu erweitern, und aktivieren Sie das Kontrollkästchen neben dem zu verwendenden Plugin. Weitere Anweisungen zur Verwendung von Plugins, einschließlich Details zum Festlegen aller erforderlichen Variablen, die vom Plugin verwendet werden, finden Sie unter Zu einer Aktivität hinzugefügte Plugins.

  • 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 die an einem Schritt vorgenommenen Änderungen zu speichern. In einer Meldung werden Sie aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Variable Write-Aktivität konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation eines Vorgangs konfigurieren, darunter die Möglichkeit, Vorgänge zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Sobald eine Variablenaktivität erstellt wurde, sind Menüaktionen für diese Aktivität über den Projektbereich entweder auf den Registerkarten Workflows oder Komponenten sowie über die Design-Canvas zugänglich. Siehe Aktionsmenü für weitere Einzelheiten.

Variablenschreibaktivitäten können mit diesen Operation als Ziel verwendet werden:

Andere Muster sind bei Variablenschreibaktivitäten nicht gültig. Siehe die Validierungsmuster unter Operationsgültigkeit Seite.

Ein typischer Anwendungsfall ist die Verwendung einer Variablenschreibaktivität im Transformation. In diesem Beispiel stellt die FTP Leseaktivität (Read Request) der Operation Daten zur Verfügung, die dann von der Transformation (FTP to Variable) empfangen werden. Die Variablenschreibaktivität (Write Response) wird als Ziel verwendet und empfängt Daten innerhalb der Operation:

Variable Operation 1

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort in der Skriptfunktion.

Wenn Sie bereit sind, führen Sie den Operation aus und validieren Sie das Verhalten, indem Sie die Operation überprüfen.

Wichtig

Standardmäßig werden erfolgreiche Vorgänge, die für eine Custom API konfiguriert sind, sind nicht in den Operation enthalten, sofern nicht eine dieser Einstellungen aktiviert ist:

  • Cloud-Agenten: Für API Operationen auf einem Cloud-Agenten Operation debuggen muss für die Operation aktiviert sein.
  • Private Agenten: Für API Operationen auf einem privaten Agenten muss entweder Operation debuggen muss für die Operation aktiviert sein oder Sie müssen EnableLogging=true im [APIoperation] Abschnitt der privaten Agentenkonfigurationsdatei.

Nicht erfolgreiche Vorgänge werden in die Operation aufgenommen, ob die oben genannten Einstellungen aktiviert sind oder nicht.