Utilisation des gabarits de chaîne

Lors de la création d'un modèle, vous pouvez utiliser une chaîne publiée comme base ou créer une nouvelle séquence de commandes et d'événements à partir de zéro.

Ces modèles vous permettront de créer une séquence préétablie de commandes et d'événements à utiliser dans d'autres chaînes. Par exemple, avec les modèles, vous pouvez :

Fournir une longueur d'avance pour faciliter la création de chaînes.
Normaliser les flux de travail communs, par exemple pour extraire des données de votre système d'archivage.

Remarque : Vous pouvez utiliser un modèle avec plusieurs chaînes, espaces de travail et environnements dans Chain Builder.

Créer un modèle à partir d'une chaîne existante

La création d'un modèle à partir d'une chaîne existante présente un certain nombre d'avantages :

Vous pouvez utiliser la première chaîne comme point de départ pour créer d'autres chaînes.
Vous pouvez partager la chaîne avec d'autres personnes à l'aide de Chain Builder- y compris avec d'autres organisations, comme la communauté Workiva.

Pour créer un modèle à partir d'une chaîne existante :

A partir de Chains, cliquez sur Chain Builder.
Sélectionnez l'onglet Chains device_hub , puis sélectionnez Edit create for the chain.
Dans le menu à trois points de la chaîne, en haut à droite, sélectionnez Créer un modèle.
Saisissez un nom et une description uniques pour identifier le modèle.
Sous Folders, sélectionnez l'endroit où vous souhaitez enregistrer le modèle.
Cliquez sur Enregistrer.
Si la chaîne comporte des variables, définissez chaque variable du modèle :
- Saisissez le nom par défaut de la variable modèle.
  
  Conseil : Pour faciliter l'identification de la valeur à utiliser avec une variable, nous vous recommandons d'inclure un préfixe à son nom. Par exemple, WSV- pour une variable d'espace de travail, CV- pour une variable de chaîne, DCV- pour une variable de chaîne dynamique, ou Resource- pour une ressource d'espace de travail.
- Pour faciliter la portabilité et la réutilisation, supprimez les valeurs par défaut.
- Sélectionnez si une variable de chaîne dynamique ou une ressource de l'espace de travail fournira la valeur.
  
  Note : Si une variable de chaîne, une variable d’espace de travail ou une variable d’exécution fournit la valeur, ne sélectionnez ni Dynamic ni Resource.
Cliquez sur Enregistrer et Publier.

Créer un modèle à partir de zéro

Pour créer une nouvelle séquence de commandes et d'événements en tant que cadre réutilisable pour les chaînes, suivez les étapes suivantes.

Étape 1 : Ajouter le modèle

Dans Chain Builder, sous l'onglet Templates dynamic_feed , cliquez sur Create => Template en haut à droite.
Pour créer le modèle ailleurs que dans le dossier Default, cliquez sur Modifier modifier pour son dossier, sélectionnez le dossier dans lequel vous souhaitez enregistrer le modèle et cliquez sur Move.
Saisissez un nom et une description uniques pour aider à identifier le modèle et son intention.

Conseil : Pour savoir si un modèle fournit une séquence pour une chaîne complète ou partielle, ajoutez un préfixe à son nom. Par exemple, Full- pour une chaîne complète, ou Part- pour une chaîne partielle ou un extrait.

Étape 2 : Configurer les variables du modèle

Pour faciliter la personnalisation et la réutilisation, les modèles contiennent des variables qui servent d'espaces réservés aux valeurs requises pour les variables de ses commandes ou les ressources de l'espace de travail. Lorsque vous créez une chaîne à partir du modèle, les variables et les ressources de la chaîne remplacent les variables du modèle.

Pour chaque variable à inclure dans le modèle :

Sous Template Variables, cliquez sur Add.
Saisissez le nom de la variable et sa valeur par défaut.

Conseil : Pour faciliter l'identification de la valeur à utiliser avec une variable de modèle, nous vous recommandons d'inclure un préfixe dans son nom. Par exemple, WSV- pour une variable d'espace de travail, CV- pour une variable de chaîne, DCV- pour une variable de chaîne dynamique, ou Resource- pour une ressource d'espace de travail.
Sous Type, sélectionnez si une variable de chaîne dynamique ou une ressource d'espace de travail fournira la valeur de la variable.

Note : Si une variable de chaîne, une variable d’espace de travail ou une variable d’exécution fournit la valeur, ne sélectionnez ni Dynamic ni Resource.

Après avoir ajouté toutes les variables du modèle, cliquez sur enregistrer.

Remarque : Pour supprimer une variable du modèle, cliquez sur son X sous Actions.

Étape 3 : Définir les nœuds du modèle

Lorsque vous construisez un modèle, mettez en place et reliez les nœuds dans l'ordre :

Commandes ou tâches exécutées par des chaînes créées à partir du modèle, par exemple pour interagir avec la plateforme Workiva ou une autre source de données.
Événements qui se produisent dans le modèle, par exemple pour activer un flux de travail d'approbation ou le téléchargement manuel de fichiers.
Événements déclencheurs, tels que runtime inputs pour définir des variables (comptes, régions ou périodes spécifiques, par exemple) lorsque vous exécutez des chaînes créées à partir du modèle, ou pour démarrer automatiquement la chaîne en fonction des modifications apportées aux sources connectées.

Note : Pour permettre la personnalisation et la réutilisation, les commandes d'un modèle n'utilisent pas les connexions, les exécutants ou les variables définies dans la chaîne ou l'espace de travail ; vous les spécifierez lorsque vous créerez une chaîne à partir du modèle.

Ajout de nœuds

Lorsque vous ajoutez un nœud, déplacez-le à l'endroit où il se trouve dans la séquence et reliez-le aux étapes suivantes et précédentes.

Pour ajouter le premier nœud du modèle, déplacez-le vers Start.
Pour ajouter un nœud au début d'une nouvelle branche d'un arbre logique, reliez l'étape précédente du modèle au premier nœud des branches multiples.
Pour exécuter des commandes en parallèle les unes avec les autres ou ensemble dans le cadre d'un processus en série, crée un groupe de commandes en tant qu'étape.

Note : par défaut, un nœud s’exécute lorsque le nœud lié précédent réussit. Pour activer la logique conditionnelle, par exemple pour exécuter un nœud uniquement lorsque le nœud précédent échoue, double-cliquez sur le lien et sélectionnez sa condition - succès check_circle, échec error, avertissement warning, ou n’importe quelle check_circle.

Après avoir défini les nœuds du modèle, cliquez sur Publier.

Modifier les paramètres d'un modèle

Pour ajuster le nom ou la description d'un modèle, ou pour gérer ses variables :

Dans Chain Builder, sous l'onglet Templates dynamic_feed, cliquez sur le nom du modèle et Template Settings.
Modifiez le nom, la description ou les variables du modèle si nécessaire.
Cliquez sur Enregistrer et Publier.

Voir les chaînes qui utilisent un modèle

Pour voir quelles chaînes sont créées à partir d'un modèle, allez dans l'ongletTemplates dynamic_feed, puis cliquez sur View pour le modèle sous Chains Using.

Dans le panneau In Use, les chaînes créées à partir du modèle apparaissent. Pour ouvrir une chaîne, cliquez sur son nom.

Conseil : Pour trouver une chaîne spécifique, effectuez une recherche par son nom.

Modèles de copie

Pour utiliser un modèle comme point de départ d'un nouveau modèle, créez-en une copie. Dans Chain Builder, dans l'onglet Templates dynamic_feed, cliquez sur Copy file_copy pour le modèle.

Partager des modèles avec d'autres

Pour aider les autres à créer des chaînes, vous pouvez partager des liens vers des modèles publiés avec d'autres utilisateurs de Chain Builder- y compris ceux d'autres organisations, comme la communauté Workiva.

Dans Chain Builder, à partir de l'onglet Templates dynamic_feed, cliquez sur Get shareable link open_in_new.
Cliquez sur Copier dans le presse-papiers file_copy et Fermer.
Collez et partagez le lien avec d'autres personnes si nécessaire.

N'oubliez pas que les modèles dépendent de l'accès des deux espaces de travail aux mêmes connecteurs et commandes. Lors du partage d'un modèle avec un autre espace de travail, la chaîne importée ne fonctionnera pas si tous les connecteurs requis ne sont pas activés.

Lors de l'importation d'une chaîne, vous aurez la possibilité de configurer les connecteurs manquants :

Révoquer l'accès à un modèle partagé

Pour révoquer l'accès d'autres personnes à un modèle partagé, actualisez son URL pour créer un nouveau lien :

Dans Chain Builder, dans l'onglet Templates dynamic_feed, cliquez sur Get shareable link open_in_new pour le modèle.
Cliquez sur Régénérer le jeton rafraîchir et Fermer.

Modèles d'archives

Si vous n'avez plus besoin d'un modèle, vous pouvez l'archiver. Dans Chain Builder, cliquez sur Templates dynamic_feed, et cliquez sur Archive archive pour le modèle.

Note : Pour visualiser un modèle archivé à partir de Modèles, cliquez sur Archivé.

Support

Communauté

Portail de support Workiva