Variable Write-Aktivität
Einführung
Eine Variable Write-Aktivität, die ihre Variable-Verbindung verwendet, schreibt Daten in eine Variable und ist dazu gedacht, als Ziel zum Konsumieren von Daten in einer Operation oder zum Aufrufen in einem Skript verwendet zu werden.
Für weitere Informationen zur Verwendung von Variablen in Skripten, Transformationen und Konfigurationsbildschirmen für Verbindungen/Aktivitäten siehe Variablen.
Erstellen einer Variable Write-Aktivität
Eine Instanz einer Variable Write-Aktivität wird aus einer Variable-Verbindung unter Verwendung ihres Write-Aktivitätstyps erstellt.
Um eine Instanz einer Aktivität 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. Für Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.
Eine vorhandene Variable Write-Aktivität kann von diesen Orten aus bearbeitet werden:
-
Der Entwurfsfläche (siehe Komponentenaktionsmenü in Entwurfsfläche).
-
Der Komponenten-Registerkarte im Projektbereich (siehe Komponentenaktionsmenü in Projektbereich Komponenten-Registerkarte).
Konfigurieren einer Variable Write-Aktivität
Befolgen Sie diese Schritte, um eine Variable Write-Aktivität zu konfigurieren:
Schritt 1: Geben Sie einen Namen ein und stellen Sie ein Anfrage-Schema bereit
-
Name: Geben Sie einen Namen ein, um die Variable Write-Aktivität zu identifizieren. Der Name muss für jede Variable Write-Aktivität eindeutig sein und darf keine Schrägstriche (
/) oder Doppelpunkte (:) enthalten. -
Provide request schema: Das Anforderungsschema definiert die Struktur der Daten, die von der Variable Write-Aktivität verwendet werden. Ob ein Anforderungsschema erforderlich ist, hängt davon ab, ob die Aktivität als Ziel einer Transformation verwendet wird (siehe Schema usage). Für Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration siehe Schemas defined in an activity.
-
Save & Exit: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.
-
Next: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Finished im letzten Schritt klicken.
-
Discard Changes: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.
Schritt 2: Überprüfen Sie die Datenschematas
-
Data Schema: Wenn während der Aktivitätskonfiguration bereitgestellt, wird das Anforderungsdatenschema angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemas später während des transformation mapping-Prozesses erneut angezeigt, wo Sie Zielfelder mithilfe von Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen können. Sie können auch schemas directly in a transformation definieren.
-
Add plugin(s): Plugins sind von Jitterbit oder Benutzern bereitgestellte Anwendungen, die die nativen Fähigkeiten von Harmony erweitern. Um ein Plugin auf die Aktivität anzuwenden, klicken Sie, um diesen Abschnitt zu erweitern, und wählen Sie das Kontrollkästchen neben dem zu verwendenden Plugin aus. Für zusätzliche Anweisungen zur Verwendung von Plugins, einschließlich Details zur Festlegung aller erforderlichen Variablen, die vom Plugin verwendet werden, siehe Plugins added to an activity.
-
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: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.
Nächste Schritte
Nachdem Sie eine Variable Write-Aktivität konfiguriert haben, können Sie sie innerhalb einer Operation oder eines Skripts wie unten beschrieben verwenden.
Operation abschließen
Nachdem Sie eine Variable Write-Aktivität konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie andere Aktivitäten oder Werkzeuge als Operation Schritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen einer Operation konfigurieren, die die Möglichkeit umfassen, Operationen, die sich in denselben oder unterschiedlichen Workflows befinden, miteinander zu verketten.
Sobald eine Variable Write-Aktivität erstellt wurde, sind die Menüaktionen für diese Aktivität im Projektbereich entweder im Tab Workflows oder im Tab Komponenten sowie von der Entwurfskanvas aus zugänglich. Siehe Aktivitätsaktionsmenü für Details.
Variable Write-Aktivitäten können als Ziel mit diesen Betriebsmustern verwendet werden:
- Archivmuster
- Skriptmuster
- Transformationsmuster
- Zwei-Ziel-Archivmuster (nur als zweites Ziel)
- Zwei-Ziel-HTTP-Archivmuster (nur als zweites Ziel)
- Zwei-Transformationsmuster (nur als zweites Ziel)
- Salesforce-Bulk-Quellenmuster
Andere Muster sind bei der Verwendung von Variablen Write-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Seite zur Gültigkeit von Operationen.
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, implementieren Sie die Operation und führen Sie sie aus, und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.
Wichtig
Operationen, die von einem API-Manager benutzerdefinierten API ausgelöst werden, verfügen über zusätzliche Protokollierungsoptionen, die aktiviert werden können. Für Details dazu, was in den Betriebsprotokollen erscheint und wie Sie die zusätzliche Protokollierung aktivieren können, siehe API-Anforderungsdaten in Betriebsprotokollen.