Après avoir publié une chaîne, vous pouvez l'exécuter pour exécuter ses commandes :
- Pour faire fonctionner une chaîne sans programme défini, il faut la faire fonctionner manuellement.
- Pour qu'une chaîne s'exécute automatiquement, définissez sa programmation.
- Pour exécuter automatiquement une chaîne en fonction d'un événement dans une solution connectée, utilisez un événement déclencheur.
- Pour lancer une chaîne après la fin d'une autre chaîne, utilisez l'événement Run Chain pour les enchaîner.
Formation complémentaire disponible
Débloquez la puissance des chaînes grâce à notre cours autodidacte dans le Workiva Learning Hub ! Ce cours complet vous guide tout au long du processus de création d’une chaîne, du début à la fin, en vous offrant une expérience pratique et une compréhension approfondie de la plateforme Générateur de chaînes.
Visitez le centre d’apprentissage Workiva
Faire fonctionner manuellement une chaîne
Pour exécuter manuellement une chaîne, sélectionnez-la dans votre espace de travail, puis cliquez sur Execute et Run Chain.
Remarque : Pour arrêter l'exécution d'une chaîne, cliquez sur Stop. Lorsque vous arrêtez une chaîne qui comprend des événements Run Chain, vous arrêtez également toutes les exécutions de chaînes lancées par ces événements.
Programmer l'exécution automatique d'une chaîne
Les programmes de chaînes vous permettent d'exécuter automatiquement une chaîne sur une base régulière, à une heure spécifique ou pendant une période donnée. Toutes vos chaînes programmées peuvent être visualisées par environnement à partir de l'onglet Schedules dans Chain Builder.
Pour programmer une chaîne :
- Ouvrez la chaîne et cliquez sur Settings.
- Sous Schedules , cliquez sur Add.
-
Sous Frequency, sélectionnez la fréquence de fonctionnement de la chaîne, par exemple toutes les quelques heures ou une fois par mois.
Note : Vos options de programmation ultérieures varieront en fonction de la fréquence choisie. En sélectionnant un programme hebdomadaire, par exemple, vous aurez la possibilité de spécifier un jour de la semaine pour l'exécution de votre chaîne.
-
Sous Run Time, choisissez la durée spécifique pendant laquelle votre chaîne fonctionnera.
Note : En fonction de la fréquence choisie, il peut vous être demandé de choisir un jour ou une période particulière pour votre chaîne.
-
Sous Duration, choisissez la durée de cette programmation.
Note : Les horaires des chaînes doivent être saisis en nombres entiers. Par exemple, vous ne pouvez pas programmer l'exécution d'une chaîne tous les 1,5 jours.
- Cliquez sur enregistrer pour créer votre emploi du temps.
- Enregistrez et Publiez votre chaîne pour que la programmation prenne effet.
Une fois programmée, une chaîne continuera à s'exécuter jusqu'à ce que la programmation soit modifiée ou supprimée. Ils ne sont pas automatiquement désactivés lorsque l'utilisateur de planification est supprimé de Workiva.
Vous pouvez visualiser toutes les chaînes programmées à partir de l'écran Schedules.
Modifier et supprimer les chaînes programmées
Après avoir ajouté un horaire, vous pouvez en personnaliser les paramètres :
- Sélectionnez Color pour choisir la façon dont l'horaire apparaît dans l'onglet "Horaires".
- Pour empêcher temporairement une chaîne de démarrer à l’heure prévue, cliquez sur Disable Schedule pour la programmation.
- Pour mettre à jour une fréquence définie, cliquez sur Edit pour l’horaire.
- Pour supprimer une programmation, cliquez sur Delete .
Bon à savoir
- Vous êtes limité à un maximum de 80 horaires par chaîne.
- L’affichage de la programmation peut montrer un maximum de 100 itérations de programmation pour n’importe quelle programmation.
Ainsi, dans l’exemple ci-dessous, la vue Planification des tests A (en beige) est programmée pour s’exécuter toutes les 15 minutes pendant toute la semaine suivant le 6 mars, mais le graphique n’affiche que les 100 premières exécutions, soit 25 heures dans ce cas (4 exécutions par heure x 25 heures = 100 itérations).
Démarrer une chaîne sur la base d'un événement déclencheur
Pour exécuter automatiquement une chaîne en fonction d'un événement dans une solution de connexion, démarrez-la avec un événement déclencheur :
- Pour démarrer une chaîne basée sur un événement du BlackLine® Journal Service, tel qu'une nouvelle entrée de journal certifiée, utilisez l'événement déclencheur BlackLine Journal Service .
- Pour démarrer une chaîne lorsqu'un connecteur File Utils détecte un événement - tel que Créer, Modifier ou Supprimer - dans un répertoire de fichiers, utilisez l'événement déclencheur File Events .
- Pour démarrer une chaîne lorsqu'un connecteur de requête HTTP détecte un événement POST avec une charge utile JSON, utilisez l'événement déclencheur HTTP Webhooks .
Lorsque vous utilisez des événements déclencheurs, gardez à l'esprit les points suivants :
- Les chaînes ne peuvent pas être programmées lorsqu'un événement déclencheur est utilisé.
- Un seul événement déclencheur peut être utilisé par chaîne.
Consulter l'historique d'une chaîne
Pour consulter les versions précédemment publiées d'une chaîne dans Chain Builder, allez dans l'onglet Chains et sélectionnez Versions dans le menu de la chaîne individuelle. Pour chaque version antérieure, vous pouvez voir quand elle a été créée et par qui.
Pour afficher l'historique de l'exécution d'une chaîne, par exemple pour résoudre une erreur :
- A partir de Chain Builder, cliquez sur Monitor .
- Recherchez une chaîne par son nom ou utilisez les filtres en haut de l'écran pour affiner vos résultats :
- État
- Heure
- Date
- Espace de travail/environnement
- Connexions
- Balises
- Pour chaque exécution, vous pouvez consulter les détails de la chaîne, y compris son statut, le nom de la personne qui l'a exécutée et ses heures de début et de fin.
- Pour plus de détails sur l'exécution, cliquez sur sa ligne et examinez chaque commande pendant l'exécution. Pour chaque commande, vous pouvez visualiser ses sorties, ses entrées et le journal des erreurs pendant l'exécution.
- Pour afficher toutes les exécutions de la chaîne, cliquez sur Run History.
Visualiser une chaîne exécutée à l'intérieur d'une autre chaîne
Lorsqu'un événement de la chaîne d'exécution est inclus dans une chaîne parentale, vous pouvez accéder rapidement à la sous-chaîne via l'écran Monitor.
Voici comment :
- A partir de Chain Builder, cliquez sur Monitor .
- Sélectionnez la chaîne que vous souhaitez visualiser.
- Cliquez sur le nœud Run Chain dans votre graphique de chaîne. La chaîne exécutée par ce nœud apparaîtra dans le panneau des résultats sur le côté droit.
- Dans le panneau des résultats sur le côté droit, utilisez votre clavier et votre souris pour ajuster votre vue de la sous-chaîne :
- Faites glisser le canevas: Cliquez et maintenez votre souris dans un espace vide pour faire glisser la toile.
- Zoom avant et arrière: Maintenez la touche CTRL enfoncée et faites défiler avec la molette de la souris pour effectuer un zoom avant ou arrière.
- Double-cliquez sur n'importe quel nœud de votre sous-chaîne pour l'ouvrir dans un nouvel onglet du navigateur. Vous pouvez alors modifier, exécuter et visualiser la chaîne secondaire séparément de votre chaîne source.
Analyser l'utilisation de la chaîne
Pour suivre et analyser l'utilisation et le succès de vos chaînes dans Chain Builder, à partir de Home , sélectionnez la période à analyser.
Remarque : Pour vous concentrer sur les chaînes dans des environnements spécifiques de votre espace de travail, cliquez sur Filter, et sélectionnez les environnements à analyser.
À partir de Home, vous pouvez contrôler :
- Résultats de la chaîne, pour savoir combien de chaînes ont réussi, échoué ou ont donné lieu à un avertissement au cours de la période définie.
- Activity Feed, pour un journal d'audit des mises à jour des chaînes pendant la période définie, avec indication de l'auteur et de la date de la modification.
- Command Stats, pour connaître le nombre de commandes exécutées pendant la période définie.
Pour mettre à jour une mesure avec la dernière activité, cliquez sur Refresh .