Um Werte für Eingänge zu setzen, die in mehreren Ketten oder Befehlen innerhalb einer einzelnen Kette wiederholt vorkommen, können Sie Variablen verwenden. Anstatt denselben Wert in mehrere Ketten oder Befehle einzugeben, können Sie ihn als Variable definieren und seinen Wert an einer Stelle verwalten.
- Arbeitsbereichsvariablen definieren Werte, die in mehreren Ketten erscheinen.
- Kettenvariablen definieren Werte, die in mehreren Befehlen einer Kette erscheinen und sich häufig ändern können.
- Dynamische Variablen definieren Werte, die bei der Ausführung einer Kette oder während der Ausführung einer Kette gesetzt werden, z. B. auf der Grundlage der Ausgabe eines früheren Befehls.
Zusätzliches Training verfügbar
Sie können die Macht der Ketten mit unserem Kurs zum Selbststudium im Workiva Learning Hub erlernen. Dieser umfassende Kurs führt Sie durch den Prozess der Erstellung einer Kette von Anfang bis Ende und vermittelt Ihnen praktische Erfahrungen und ein tiefes Verständnis der Chain-Generator-Plattform.
Besuchen Sie den Workiva Learning Hub
Verwalten Sie die Variablen Ihres Arbeitsbereichs
In Ihrem Arbeitsbereich können Sie die von mehreren Ketten verwendeten Variablen definieren:
- In Chain Builder wählen Sie Einstellungen oben links.
- Klicken Sie rechts neben Variablen auf Hinzufügen.
- Um die Variable zu identifizieren, geben Sie ihren Namen und, falls erforderlich, ihren Standardwert und ihre Beschreibung ein. Diese Standardwerte können später für einzelne Ketten angepasst werden.
- Für zusätzliche Sicherheit wählen Sie Verschlüsseln - dadurch werden alle sensiblen Werte wie Passwörter verborgen.
- Klicken Sie auf Speichern.
Nachdem Sie eine Variable zu Ihrem Arbeitsbereich hinzugefügt haben, können Sie ihren Namen, Wert oder ihre Verschlüsselung nach Bedarf bearbeiten. Um eine Variable aus dem Arbeitsbereich zu entfernen, klicken Sie auf Löschen.
Verwalten der Variablen einer Kette
Für Werte, die in mehreren Befehlen innerhalb einer Kette erscheinen und sich häufig ändern, fügen Sie sie als Variablen für die Kette hinzu. Es gibt keine feste Grenze für die Anzahl der Variablen in einer Kette, aber es wurde festgestellt, dass sich die Reaktionsfähigkeit verschlechtert, wenn die Ketten 1000 Variablen erreichen.
- Klicken Sie in der Kette auf Ketteneinstellungen.
- Unter Variablen, klicken Sie auf Hinzufügen.
- Geben Sie einen eindeutigen Namen und eine Beschreibung ein, um die Variable und ihren Zweck zu identifizieren.
- Geben Sie den Standardwert für die Variable ein.
- Damit nur Administratoren den Wert der Variablen sehen können, z. B. für Passwörter, wählen Sie Encrypt.
- Klicken Sie auf Speichern.
Um eine Variable zu aktualisieren, klicken Sie auf Bearbeiten für die Kette, und passen Sie den Wert unter Variablen an.
Um eine nicht mehr benötigte Variable zu entfernen, klicken Sie auf Löschen.
Verwalten der dynamischen Variablen einer Kette
Um Werte zu setzen, wenn die Kette läuft, oder um Werte auf die Ausgabe eines anderen Befehls zu stützen, fügen Sie sie als dynamische Variablen für die Kette hinzu.
Hinweis: Um aufeinanderfolgende Läufe zu erleichtern, behalten die dynamischen Variablen die Werte bei, die beim letzten Lauf der Kette eingestellt wurden.
- Klicken Sie in der Kette auf Ketteneinstellungen.
- Unter Dynamische Variablen, klicken Sie auf Hinzufügen.
- Geben Sie einen eindeutigen Namen ein, um die Variable und ihren Zweck zu identifizieren.
Hinweis: Das Feld Anfangswert ist hier nicht anwendbar und sollte leer gelassen werden.
- Klicken Sie auf Speichern.
Hinweis: Um die Werte der dynamischen Variablen zu setzen, wenn eine Kette zu laufen beginnt, starten Sie sie mit einem Runtime Inputs Trigger Event. Um eine Kette anzuhalten, um den Wert einer dynamischen Variable zu definieren, bevor Sie mit dem nächsten Schritt fortfahren, fügen Sie ein Setze dynamische Kettenvariablen Ereignis hinzu.
Um eine nicht mehr benötigte Variable zu entfernen, klicken Sie auf Löschen.
Variablen als Befehlseingaben verwenden
Um Variablen als textbasierte Eingaben für einen Befehl zu verwenden:
- Wählen Sie in der Kette den Befehl aus, der die Variablen verwenden soll.
- Klicken Sie in der textbasierten Eingabe, um eine Variable zu verwenden, auf Variable und wählen Sie die Variable aus.
Hinweis: Um mehrere Variablen innerhalb einer Eingabe zu verketten, wählen Sie die zu verwendenden Variablen aus und geben dann einen beliebigen Text ein, der vor oder nach den einzelnen Variablen erscheinen soll.
- Klicken Sie auf Speichern.
Hinweis: Um eine Variable für die Verwendung als Befehlseingabe zu ändern oder zu formatieren, wenden Sie eine Variablentransformation an.
Laufzeitvariablen
Um Daten über den Zeitpunkt der Ausführung einer Kette einzubeziehen, können Sie mehrere Laufzeitvariablen verwenden.
| Variabel | Beschreibung |
|---|---|
| Chain.Environment | Die Umgebung der aktuell laufenden Kette |
| Chain.ExecutionDateTime | Datum und Uhrzeit, zu der die Kette beginnt |
| Chain.ExecutorId | Die numerische ID der aktuell laufenden Kette |
| Kette.Id | Die numerische ID einer Kette im Zustand non-running |
| Kette.Name | Der Name der aktuell laufenden Kette |
| Chain.PreviousExecutionDateTime | Datum und Uhrzeit der letzten Ausführung der Kette |
| Kette.URL | Die eindeutige URL der aktuell laufenden Kette |
| Chain.Workspace | Der Arbeitsbereich der aktuell laufenden Kette |
| Befehl.ExecutorId | Die numerische ID des aktuell ausgeführten Befehls |
| Befehl.Id | Die numerische ID eines Befehls im Zustand non-running |
| Befehl.Name | Der Name des aktuell ausgeführten Befehls |
| Befehl.URL | Die eindeutige URL des aktuell ausgeführten Befehls |
| Runner.InstallationDirectory | Das Installationsverzeichnis für den GroundRunner der Kette; null, wenn ein CloudRunner verwendet wird |
| System.Datum | Das aktuelle Systemdatum |
| System.DateTime | Das aktuelle Systemdatum und die Uhrzeit |
| Benutzer.E-Mail | Die E-Mail-Adresse des Mitarbeiters, der die Kette erstellt hat |
| Benutzer.Id | Die ID des Mitarbeiters, der die Kette ausgeführt hat |
| Benutzer.Name | Der Name des Mitarbeiters, der die Kette leitete |