Die Ketten in Ihrem Arbeitsbereich können in eine .chain-Datei exportiert und für Benutzer in einem anderen Arbeitsbereich, einer anderen Umgebung oder Organisation freigegeben werden. Der Dateiempfänger kann die Datei dann in seinen eigenen Arbeitsbereich importieren, die Einstellungen konfigurieren und die Datei weitgehend unverändert ausführen.
Als Alternative zu Kettenvorlagen werden Exportdateien empfohlen, wenn Ketten schnell und mit minimalen Änderungen zwischen Arbeitsbereichen übertragen werden sollen. Vorlagen werden bevorzugt, wenn Datenmodelle gespeichert oder in großem Umfang mit anderen geteilt werden sollen.
Anforderungen
- Die Rolle Bearbeiten ist erforderlich, um eine Kette zu exportieren.
- Die Rolle Create ist erforderlich, um eine Kette zu importieren.
Eine Kette exportieren
Um eine Kette zu exportieren:
- Gehen Sie im Chain Builder auf die Registerkarte Chains .
- Suchen Sie die Kette, die Sie exportieren möchten, wählen Sie das Drei-Punkte-Menüauf der rechten Seite und klicken Sie auf Exportieren.
- Speichern Sie die .chain-Datei auf Ihrem Computer.
Exportieren von Ketten, die ein Kettenlaufereignis enthalten
Mit einem Kettenlauf-Ereignis können Sie mehrere Ketten aneinanderreihen, so dass eine Anfangskette im weiteren Verlauf andere Unterketten aktiviert. Wenn Ketten auf diese Weise aneinandergereiht werden, können Sie entweder die gesamte Kette oder nur einen Teil davon exportieren. Sie können eine Kette mit bis zu fünf Ebenen exportieren.
Nehmen wir zum Beispiel an, Sie haben fünf Ketten:
| Wenn Sie exportieren... | |
| Kette 1 | Alle Ketten werden einbezogen |
| Kette 2 | Es werden nur die Ketten 2-5 berücksichtigt. |
| Kette 3 | Es werden nur die Ketten 3-5 berücksichtigt. |
| Kette 4 | Es werden nur die Ketten 4-5 berücksichtigt. |
| Kette 5 | Es wird nur Kette 5 berücksichtigt |
Hinweis: Wenn Ihr Export ein "Run Chain"-Ereignis enthält, müssen Sie über die Berechtigung Edit sowohl für die ursprüngliche Kette als auch für alle enthaltenen Unterketten verfügen.
Eine Kette importieren
Um eine Kette zu importieren:
- Gehen Sie im Chain Builder auf die Registerkarte Chains .
- Klicken Sie oben rechts auf die Schaltfläche Import .
- Wählen Sie im Dateibrowser die Datei .chain auf Ihrem Computer aus.
Nach dem Hochladen müssen Sie die neue Kette unter konfigurieren, bevor sie in Ihrem Arbeitsbereich ausgeführt werden kann.
Importieren von Ketten mit einem Kettenlaufereignis
Wie im Abschnitt Exportieren einer Kette erwähnt, können Sie mit dem Ereignis Kette ausführen mehrere Ketten nacheinander ausführen. Wenn Sie diese mehrteiligen Ketten in Ihren Arbeitsbereich importieren, wird nur die erste Kette der Sequenz angezeigt:
Sobald diese oberste Kette konfiguriert ist, können Sie auch die Unterketten anzeigen und verwalten.
Hinweis: Obwohl Unterketten gleichzeitig mit der Hauptkette konfiguriert werden, werden sie nicht automatisch veröffentlicht. Sie müssen jede Kette manuell veröffentlichen, bevor sie ausgeführt werden kann.
Konfigurieren Sie eine Kette
Wenn Sie in der Vergangenheit mit Kettenvorlagen gearbeitet haben, ist die Einrichtung einer neuen Kette sehr ähnlich.
So funktioniert es:
- Suchen Sie auf der Registerkarte Chains Ihre importierte Kette und klicken Sie auf Configure auf der rechten Seite.
- Geben Sie einen eindeutigen Namen ein, um die Kette zu identifizieren.
- Standardmäßig wird -- Import dem Namen der exportierten Kette hinzugefügt.
- Wenn die Kette Variablen enthält, die sich vom ursprünglichen Arbeitsbereich unterscheiden, richten Sie jede einzelne ein:
- Wählen Sie für jede in der Kette verwendete Verbindung den Verbinder und den Läufer aus, um seine Befehle auszuführen, und klicken Sie auf Senden.
FAQ
Sollte ich Exporte oder Kettenvorlagen verwenden?
Dies hängt weitgehend von Ihrem Ziel ab, da beide Funktionen viele der gleichen Aufgaben erfüllen.
Exportdateien laufen nach 14 Tagen ab und können nur weitergegeben werden, indem die .chain-Datei direkt an einen anderen Benutzer gesendet wird. Sie stellen eine Momentaufnahme dar; sie sind nicht für eine weite Verbreitung oder für die Speicherung von Kettenmodellen gedacht.
Vorlagen sind jedoch als Ausgangspunkt für zukünftige Anpassungen gedacht. Sie eignen sich besonders gut, wenn Sie ein Kettenmodell entwickelt haben, das wiederholt mit anderen geteilt werden muss.
Erfahren Sie mehr über die Verwendung von Kettenvorlagen.
Sind .chain-Dateien sicher?
Ja, .chain-Dateien werden beim Export verschlüsselt und können nur innerhalb der Workiva-Plattform geöffnet werden.
Was ist in einer .chain-Datei enthalten?
Eine .chain-Datei enthält die Struktur der Kette selbst, aber keine arbeitsbereichsspezifischen Informationen, wie z. B. Details zur Konfiguration Ihres Connectors (z. B. Ihr OAuth oder Client Secret), den Verlauf der Ausführung oder die Versionsgeschichte.
Kann ich verfolgen, wann Ketten exportiert oder importiert werden?
Ja, diese Aktionen lösen ein Export oder Import Ereignis in Ihren Audit-Protokollen aus.
Wenn Ihre Kette ein Ereignis "Kette ausführen" enthält, werden sowohl für die übergeordnete Kette als auch für jede Unterkette im Export separate Prüfungsereignisse erstellt.
Erfahren Sie mehr über die Verfolgung von Ereignissen in Chain Builder.
Verfallen .chain-Dateien?
Verkettete Dateien verfallen nach 14 Tagen.
Gibt es eine Begrenzung für die Anzahl der Laufkettenereignisse, die ich exportieren kann?
Run-Chain-Ereignisse sind auf maximal fünf Levels begrenzt. Es handelt sich dabei um die Stammkette (Kette 1 in der obigen Abbildung) und bis zu vier untergeordnete Ketten.
Wenn eine Kette mehr als vier untergeordnete Ketten hat, können Sie sie nicht exportieren.