Variable Schreibaktivität
Einführung
Eine Variable-Schreib-Aktivität, die ihre Variablenverbindung verwendet, schreibt Daten in eine Variable und ist als Ziel zum Verbrauchen von Daten in einer Operation oder zum Aufrufen in einem Script vorgesehen.
Weitere Informationen zur Verwendung von Variablen in Scripts, Transformations und Verbindungs-/Aktivitätskonfigurationsbildschirmen finden Sie unter Variablen.
Erstellen einer Variablenschreibaktivität
Eine Instanz der Aktivität „Variable schreiben“ wird aus einer Variablenverbindung erstellt mithilfe des Aktivitätstyps Schreiben.
Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie ihn und fügen Sie ihn dort ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Tool-Instanz in Komponentenwiederverwendung.
Eine vorhandene Variable-Schreib-Aktivität kann an diesen Stellen bearbeitet werden:
-
Die Design-Canvas (siehe Aktionsmenü in Design-Leinwand).
-
Die Tab Komponenten im Projektbereich (siehe Aktionsmenü im Projektbereich Tab Komponenten).
Konfigurieren einer Variablenschreibaktivität
Führen Sie die folgenden Schritte aus, um eine Variable-Schreib-Aktivität zu konfigurieren:
Schritt 1: Geben Sie einen Namen ein und geben Sie ein Schema an
-
Name: Geben Sie einen Namen zur Identifizierung der Variablen-Schreib-Aktivität ein. Der Name muss für jede Variablen-Schreib-Aktivität eindeutig sein und darf keine Schrägstriche enthalten (
/
) oder Doppelpunkte (:
). -
Schema bereitstellen: Das Schema definiert die Datenstruktur, die von der Aktivität „Variable schreiben“ verwendet wird. 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 & Beenden: 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 Änderungen an einem Schritt zu speichern. Sie werden in einer Meldung aufgefordert, das Verwerfen der Änderungen zu bestätigen.
Schritt 2: Überprüfen der Datenschemata
-
Datenschema: Sofern während der Aktivitätskonfiguration angegeben, wird das Schema angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemata 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 Schemata auch direkt in einer Transformation definieren.
-
Plugin(s) hinzufügen: Plugins sind Jitterbit- oder benutzerdefiniert bereitgestellte Anwendungen, die die nativen Funktionen von Harmony erweitern. Um ein Plugin auf die Aktivität anzuwenden, klicken Sie auf diesen Abschnitt, um ihn 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 vom Plugin verwendeten Variablen, finden Sie unter Plugins, die einer Aktivität hinzugefügt werden.
-
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 Änderungen an den Schritten zu speichern. Sie werden in einer Meldung aufgefordert, das Verwerfen der Änderungen zu bestätigen.
Nächste Schritte
Nachdem Sie eine Variable-Schreib-Aktivität konfiguriert haben, können Sie sie wie unten beschrieben innerhalb einer Operation oder eines Script verwenden.
Schließen Sie den Operation
Nachdem Sie eine Variable Write-Aktivität konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie andere Aktivitäten oder Tools hinzufügen und konfigurieren als Operation. Sie können auch die Operation eines Vorgangs konfigurieren, darunter die Möglichkeit, Vorgänge im selben oder in verschiedenen Workflows miteinander zu verketten.
Sobald eine Variable Schreiben-Aktivität erstellt wurde, sind die Menüaktionen für diese Aktivität im Projektbereich auf den Registerkarten Workflows oder Komponenten sowie auf der Design-Canvas zugänglich. Siehe Aktionsmenü für weitere Details.
Variablenschreibaktivitäten können mit diesen Operation als Ziel verwendet werden:
- Archivmuster
- Script
- Transformation
- Zwei-Ziel-Archivmuster (nur als zweites Ziel)
- HTTP-Archivmuster mit zwei Zielen (nur als zweites Ziel)
- Zwei-Transformationsmuster (nur als zweites Ziel)
- Salesforce-Massenquellenmuster
Andere Muster sind bei Variablenschreibaktivitäten nicht gültig. Siehe Validierungsmuster unter Operationsgültigkeit Seite.
Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie diesen temporären Speicherort dann 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 benutzerdefinierte API konfiguriert sind, sind nicht in den Operation EnableLogging=true
im [APIoperation]
Abschnitt der privaten Agentenkonfigurationsdatei.
- Cloud-Agenten: Für API Operationen auf einem Cloud-Agenten Operation debuggen Protokollierung muss für die Operation aktiviert sein.
- Private Agenten: Für API Operationen auf einem privaten Agenten muss entweder Operation debuggen Protokollierung muss für den Operation aktiviert sein oder Sie müssen aufgenommen, unabhängig davon, ob die oben genannten Einstellungen aktiviert sind oder nicht.