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, il peut s'agir de commandes déclenchées par diverses conditions.

Note : Avant d’ajouter une chaîne, assurez-vous que votre organisation établit 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 qu'une chaîne échoue si une commande parmi plusieurs échoue, les regroupe.

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.

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

2. Pour relier la commande aux nœuds précédents et suivants de la chaîne, cliquez et faites glisser des lignes entre les ports de ces nœuds.

   Remarque : Pour modifier la position d'un nœud dans la chaîne, il faut le dissocier des autres nœuds, puis le déplacer à l'endroit où il devrait 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 Modifier create.
4. Entrez 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 Iteratorrepeat, et entrez les valeurs d’itération.
   • Sous Propriétés de la commande, entrez les entrées de la commande, en vous basant sur le 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 création de chaînes, vous pouvez exécuter une seule commande ou un groupe de commandes dans une chaîne.

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

Sauter une commande

Pour développer une logique de branchement, ou dans le cadre de l'élaboration d'une chaîne, il peut être nécessaire 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 Skipskip_next.
2. Choisissez de renvoyer automatiquement un résultat de type 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 associé à un booléen AND ou OR.
   • Si toutes les conditions doivent être vraies pour passer, sélectionnez AND.
   • 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
   Float	Toute valeur numérique
   JSON	Notation d'objets JavaScript ; utiliser Transformation des variables pour analyser des 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 Se termine par
   • = ou !=
   • < ou >
   • <= ou >=
4. Cliquez sur Enregistrer.

Gérer les erreurs d'une commande

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

1. Dans la chaîne, cliquez sur le nœud de la commande, cliquez sur Edit create, et sélectionnez Error handling warning.
2. Sous Error actions repeat, sélectionnez ce qu'il faut faire si la commande échoue.
   
   • 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 redémarrer 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, entrez le nombre de tentatives à effectuer et le nombre de secondes à attendre entre les tentatives.
5. Sous Error conditions priority_high, sélectionnez les erreurs à ignorer, par exemple lors de la création d'un dossier qui existe déjà.
6. Pour définir l'état de la commande en fonction de sa sortie, cliquez sur Add sous Output interpretation, et définissez la règle ou le groupe de règles permettant d'interpréter son état.  Par exemple, avec la variable Status de la sortie Command Details, vous pouvez définir une règle pour obtenir un avertissement lorsque la commande réussit.
   
7. Sous Log interpretation, choisissez de faire échouer la commande en fonction des résultats spécifiques qu'elle génère.
   • Pour ne pas faire échouer la commande sur la base de résultats spécifiques, sélectionnez Ne pas interpréter.
   • Pour faire échouer la commande lorsque des sorties spécifiques sont trouvé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 trouvées, sélectionnez Fail if output(s) not found, et entrez la sortie à rechercher.
   • Les lignes de texte multiples doivent être séparées par le signe \n
8. Cliquez sur Enregistrer.

Visualiser la sortie d'une commande

Depuis Monitorflight_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 Outputs, cliquez sur Preview the outputvisibility pour visualiser 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 garantir 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.