Les chaînes de votre espace de travail peuvent être exportées vers un fichier .chain et partagées avec les utilisateurs d'un autre espace de travail, d'un autre environnement ou d'une autre organisation. Le destinataire du fichier peut alors importer le fichier dans son propre espace de travail, configurer les paramètres et l'exécuter en grande partie tel quel.
En lieu et place des modèles de chaînes , les fichiers d'exportation sont recommandés lorsque les chaînes doivent être rapidement transférées d'un espace de travail à l'autre avec un minimum de modifications. Les modèles sont préférables lorsqu'il s'agit de stocker ou de partager largement des modèles de données avec d'autres personnes.
Exigences
- Le rôle Edit est nécessaire pour exporter une chaîne.
- Le rôle Create est nécessaire pour importer une chaîne.
Exporter une chaîne
Pour exporter une chaîne :
- Dans Chain Builder, allez dans l'onglet Chains .
- Recherchez la chaîne que vous souhaitez exporter, sélectionnez le menu à trois pointssur le côté droit, et cliquez sur Export.
- Enregistrez le fichier .chain sur votre ordinateur.
Exportation de chaînes comprenant un événement Run Chain
L'événement Run Chain permet d'enchaîner plusieurs chaînes de sorte qu'une chaîne de départ active d'autres sous-chaînes plus tard dans le processus. Lorsque les chaînes sont reliées entre elles de cette manière, vous pouvez exporter soit l'ensemble de la chaîne, soit une partie seulement. Vous pouvez exporter une chaîne jusqu'à cinq niveaux de profondeur.
Par exemple, supposons que vous ayez cinq chaînes :
| Si vous exportez... | |
| Chaîne 1 | Toutes les chaînes seront incluses |
| Chaîne 2 | Seules les chaînes 2 à 5 seront incluses |
| Chaîne 3 | Seules les chaînes 3 à 5 seront incluses |
| Chaîne 4 | Seules les chaînes 4-5 seront incluses |
| Chaîne 5 | Seule la chaîne 5 sera incluse |
Note: Si votre exportation comprend un événement Run Chain, vous devez avoir l'autorisation Edit pour la chaîne d'origine et toutes les sous-chaînes incluses.
Importer une chaîne
Pour importer une chaîne :
- Dans Chain Builder, allez dans l'onglet Chains .
- Cliquez sur le bouton Import en haut à droite.
- Dans le navigateur de fichiers, sélectionnez le fichier .chain sur votre ordinateur.
Une fois téléchargée, vous devrez configurer la nouvelle chaîne avant qu'elle ne puisse être exécutée dans votre espace de travail.
Importation de chaînes avec un événement Run Chain
Comme indiqué dans la section Export a chain, un événement Run Chain vous permet d'exécuter séquentiellement plusieurs chaînes. Lors de l'importation de ces chaînes en plusieurs parties dans votre espace de travail, seule la première chaîne de la séquence est affichée :
Une fois cette chaîne de premier niveau configurée, vous pourrez également visualiser et gérer les sous-chaînes.
Note : Bien que les sous-chaînes soient configurées en même temps que votre chaîne de premier niveau, elles ne sont pas publiées automatiquement. Vous devrez publier manuellement chaque chaîne avant qu'elle ne puisse être exécutée.
Configurer une chaîne
Si vous avez déjà travaillé avec des modèles de chaînes, la création d'une nouvelle chaîne est très similaire.
Voici comment cela fonctionne :
- Dans l'onglet Chains , trouvez votre chaîne importée et cliquez sur Configure sur le côté droit.
- Entrez un nom unique pour identifier la chaîne.
- Par défaut, -- Import est ajouté au nom de la chaîne exportée.
- Si la chaîne comporte des variables qui diffèrent de l'espace de travail d'origine, définissez chacune d'entre elles :
- Pour chaque connexion utilisée dans la chaîne, sélectionnez le connecteur et le programme d'exécution pour exécuter ses commandes, puis cliquez sur Submit.
FAQ
Dois-je utiliser des modèles d'exportation ou de chaîne ?
Cela dépend en grande partie de votre objectif de départ, car les deux dispositifs remplissent en grande partie les mêmes fonctions.
Les fichiers d'exportation expirent après 14 jours et ne peuvent être partagés qu'en envoyant le fichier .chain directement à un autre utilisateur. Ils constituent un instantané dans le temps ; ils ne sont pas destinés à être distribués à grande échelle ou à stocker des modèles de chaînes.
Les modèles, cependant, sont conçus comme un point de départ pour de futures personnalisations. Ils sont particulièrement efficaces lorsque vous avez conçu un modèle de chaîne qui doit être partagé à plusieurs reprises avec d'autres personnes.
En savoir plus sur l'utilisation des modèles de chaînes.
Les fichiers .chain sont-ils sécurisés ?
Oui, les fichiers .chain sont cryptés lors de l'exportation et ne peuvent être ouverts qu'au sein de la plateforme Workiva.
Que contient un fichier .chain ?
Un fichier .chain contient la structure de la chaîne elle-même, mais aucune information spécifique à l'espace de travail, comme les détails de configuration de votre connecteur (comme votre OAuth ou votre secret client), l'historique des exécutions ou l'historique des versions.
Puis-je savoir quand les chaînes sont exportées ou importées ?
Oui, ces actions déclencheront un événement Export ou Import dans vos journaux d'audit.
Si votre chaîne comprend un événement Run Chain, des événements d'audit distincts seront créés pour la chaîne de premier niveau et pour chaque sous-chaîne de l'exportation.
En savoir plus sur le suivi des événements dans Chain Builder.
Les fichiers .chain expirent-ils ?
Les fichiers en chaîne expirent après 14 jours.
Y a-t-il une limite au nombre d'événements de la chaîne d'exécution que je peux exporter ?
Les événements en chaîne sont limités à un maximum de cinq niveaux de profondeur. Il s’agit en fait de la chaîne racine (chaîne 1 dans l’illustration ci-dessus), plus un maximum de quatre chaînes subordonnées.
Si une chaîne a plus de quatre chaînes subordonnées, vous ne pourrez pas l’exporter.