Portail de support Workiva

Les commandes sont les tâches exécutées au sein de la chaîne, sur la base d'une connexion avec une source de données. Pour les chaînes plus complexes, cela peut inclure des commandes déclenchées par diverses conditions.

Note : Avant d'ajouter une chaîne, assurez-vous que votre organisation définit les connexions nécessaires pour activer les commandes avec ses sources de données.

Pour exécuter des commandes spécifiques en série- l'une après l'autre, chacune attendant la fin de la commande précédente - ou simultanément en parallèle, ou pour faire échouer une chaîne en cas d'échec d'une commande parmi plusieurs, les regrouper.

Ajouter une commande à une chaîne

1. Dans la chaîne, sélectionnez la commande à exécuter :
   • Pour ajouter une nouvelle commande à la chaîne, sous Available Connectors, cliquez sur sa connexion, puis déplacez la commande à l'endroit où elle doit se trouver dans la chaîne.
   • Pour dupliquer une commande existante, sélectionnez son nœud, cliquez sur Copy  file_copy , et déplacez le nouveau nœud à l'endroit où il doit se trouver dans la chaîne.

   Conseil : Pour ajouter une commande en tant que premier nœud de la chaîne, déplacez-la vers Démarrez.

2. Pour lier la commande à ses nœuds précédents et suivants dans la chaîne, cliquez et faites glisser des lignes entre les ports de leurs nœuds.

   Note : Pour modifier la position d'un nœud dans la chaîne, détachez-le des autres nœuds, puis déplacez-le à l'endroit où il doit se trouver. Pour déplacer plusieurs nœuds à la fois, maintenez SHIFT pendant que vous les sélectionnez.

3. Sélectionnez le nouveau nœud et cliquez sur Editer  créer.
4. Saisissez les paramètres de la commande :
   • Sous Basic Info, saisissez un nom et une description uniques pour aider à identifier la commande et son objectif.
   • Faites basculer l'icône de l'œil si vous souhaitez masquer les données sensibles sorties.
   • Pour exécuter la commande plusieurs fois, pour chaque élément de la liste, activez Iterator repeat, et entrez les valeurs d'itération.
   • Sous Propriétés de la commande, entrez les entrées de la commande, sur la base du connecteur.
5. Cliquez sur Enregistrer.

Exécuter une seule commande ou un seul groupe de commandes

Pour faciliter les tests et les itérations rapides lors de la construction des chaînes, vous pouvez exécuter une seule commande ou un seul groupe de commandes au sein d'une chaîne.

1. Dans Chain Builder, sous l'onglet Chaînes , sélectionnez Execute  flight_takeoff dans le menu de la chaîne.
2. Pour la commande ou le groupe de commandes à exécuter, cliquez sur Exécuter cette commande  play_circle_outline.
3. Cliquez sur Exécuter la chaîne.

Sauter une commande

Pour développer une logique de branchement, ou dans le cadre de l'élaboration d'une chaîne, vous pouvez avoir besoin de sauter une commande pour forcer un résultat spécifique. Vous pouvez également mettre en place une logique conditionnelle qui renvoie automatiquement un résultat spécifique en fonction de règles définies.

1. Dans la chaîne, sélectionnez le nœud de la commande, cliquez sur Edit  create , et sélectionnez Skip skip_next.
2. Choisissez de renvoyer automatiquement un résultat de info  check_circle, warning  warning, ou error  error pour la commande lorsqu'elle est ignorée.
3. Pour ne passer la commande que si des critères spécifiques sont remplis, spécifiez quand. Construisez la logique conditionnelle comme un groupe auquel vous ajoutez des règles et d'autres groupes de règles, chacun étant joint par un booléen ET ou OU.
   • Si toutes les conditions doivent être vraies pour passer, sélectionner ET.
   • Si une seule condition doit être vraie pour passer, sélectionnez OR.

   Vous pouvez ajouter des règles basées sur différents types de données :

   Type de données	Description
   Chaîne	Deux caractères ou plus
   Entier	Toute valeur numérique entière non décimale
   Date	Toute chaîne de date ou variable Date
   Flotteur	Toute valeur numérique
   JSON	JavaScript Object Notation ; utiliser Variable Transformation pour analyser les objets

   Pour vérifier si les données répondent aux critères permettant d'ignorer la commande, associez-les à un opérateur et à une valeur :

   • Est vide ou N'est pas vide
   • Contient
   • Correspond à RegExp, pour l'expression régulière
   • Commence par ou Finit par
   • = ou !=
   • < ou >
   • <= ou >=
4. Cliquez sur Enregistrer.

Gérer les erreurs d'une commande

Pour détecter ou ignorer les erreurs pour une commande :

1. Dans la chaîne, cliquez sur le nœud de la commande, cliquez sur Editer  créer, et sélectionnez Gestion des erreurs  avertissement.
2. Sous Error actions  repeat, sélectionnez ce qu'il faut faire en cas d'échec de la commande.
   
   • Pour suivre la logique de ramification de la chaîne, sélectionnez Continuer avec la chaîne.
   • Pour arrêter temporairement la chaîne, par exemple pour remédier au problème, sélectionnez Pause de la chaîne. Pour reprendre la chaîne une fois le problème résolu, sélectionnez la commande dans la chaîne et cliquez sur Reprendre.
   • Pour arrêter complètement la chaîne, sélectionnez Quitter la chaîne.
3. Pour arrêter la commande si elle prend plus de temps que prévu, sous Timeout conditions  alarm, entrez sa durée maximale en secondes.
   
4. Pour réessayer une commande si sa source de données est intermittente ou indisponible, saisissez le nombre de réessais à effectuer et le nombre de secondes d'attente entre les tentatives.
5. Sous Error conditions  priority_high, sélectionnez les erreurs à ignorer, par exemple lorsque vous créez un dossier qui existe déjà.
6. Pour définir l'état de la commande en fonction de sa sortie, cliquez sur Ajouter sous Interprétation de la sortie, et définissez la règle ou le groupe de commandes qui interprétera son état.Par exemple, avec la variable Status de la sortie Command Details , vous pouvez définir une règle pour qu'un avertissement s'affiche lorsque la commande réussit.
   
7. Sous Log interpretation, sélectionnez si la commande doit être rejetée en fonction des sorties qu'elle génère.
   • Pour ne pas faire échouer la commande en fonction de sorties spécifiques, sélectionnez Ne pas interpréter.
   • Pour faire échouer la commande lorsque des sorties spécifiques sont recherchées, sélectionnez Echouer si sortie(s) trouvée(s) et entrez les sorties à rechercher.
   • Pour faire échouer la commande lorsque des sorties spécifiques ne sont pas saisies en , sélectionnez Fail if output(s) not found, et entrez la sortie à rechercher.
   • Les lignes de texte multiples devront être séparées par .
8. Cliquez sur Enregistrer.

Affichage de la sortie d'une commande

À partir de Monitor flight_takeoff, vous pouvez prévisualiser la sortie d'une commande exécutée via le CloudRunner. 

1. Dans Chain Builder, à partir de Monitor, ouvrez l'exécution avec la sortie à prévisualiser, et sélectionnez la commande.
2. Dans l'onglet Sorties , cliquez sur Aperçu de la sortie visibilité pour l'affichage de la sortie.
   

Note : Vous pouvez uniquement prévisualiser les sorties des commandes exécutées via le CloudRunner, et non un GroundRunner.

Supprimer une commande d'une chaîne

Pour supprimer une commande d'une chaîne, cliquez sur son nœud, cliquez sur Supprimer  supprimer, puis cliquez sur Supprimer.

Note : Pour aider à assurer la logique de la chaîne, vous ne pouvez pas supprimer une commande si son parent a plusieurs frères et sœurs ou branches au même niveau.