Variable Write-Aktivität in Jitterbit Studio
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 des Aktivitätstyps Write 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
-
Endpunktmenü: Wenn Sie mehrere Endpunkte desselben Connector-Typs konfiguriert haben, wird ein Menü oben auf dem Bildschirm angezeigt, das den aktuellen Endpunktnamen anzeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirmen.
- Endpunkt bearbeiten: Wird angezeigt, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungs-Konfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.
-
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. -
Anforderungs-Schema bereitstellen: Das Anforderungs-Schema definiert die Struktur der Daten, die von der Variable Write-Aktivität verwendet werden. Ob ein Anforderungs-Schema erforderlich ist, hängt davon ab, ob die Aktivität als Ziel einer Transformation verwendet wird (siehe Schema-Nutzung). Für Anweisungen zum Ausfüllen dieses Abschnitts der Aktivitätskonfiguration siehe In einer Aktivität definierte Schemata.
-
Speichern & Beenden: Wenn aktiviert, klicken Sie, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.
-
Weiter: 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 Fertig im letzten Schritt klicken.
-
Änderungen verwerfen: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Schritt 2: Überprüfen der Datenschemata
-
Datenschema: Wenn während der Aktivitätskonfiguration bereitgestellt, wird das Anforderungs-Datenschema angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemata später während des Transformations-Mappings Prozesses erneut angezeigt, wo Sie Ziel-Felder mit Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen können. Sie können auch Schemata direkt in einer Transformation definieren.
-
Plugin(s) hinzufügen: Plugins sind von Jitterbit oder Benutzern 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 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 erforderlicher Variablen, die vom Plugin verwendet werden, siehe Plugins, die zu einer Aktivität hinzugefügt wurden.
-
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: Nach Änderungen klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.
Nächste Schritte
Nachdem Sie eine Variable Schreiben-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 Schreiben-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 zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.
Sobald eine Variable Schreiben-Aktivität erstellt wurde, sind Menüaktionen für diese Aktivität im Projektbereich entweder in den Registerkarten Workflows oder Komponenten sowie von der Entwurfskanvas aus zugänglich. Siehe Aktivitätsaktionsmenü für Details.
Variable Schreiben-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 Betriebsvalidität.
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 und führen Sie den Betrieb aus und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.
Wichtig
Von einem API-Manager ausgelöste Operationen benutzerdefinierte API haben zusätzliche Protokollierung, die aktiviert werden kann. Für Details darüber, was in den Betriebsprotokollen erscheint und wie man zusätzliche Protokollierung aktiviert, siehe API-Anforderungs- und Antwortdaten in Betriebsprotokollen.