Portail de support Workiva

Pour créer une variable à partir de la sortie d'une commande, utilisez les sorties dynamiques. Les sorties dynamiques sont des règles permettant d'extraire une valeur ou une liste de valeurs de la sortie d'une commande, par exemple pour une utilisation ultérieure dans la chaîne. Vous pouvez ajouter plusieurs sorties dynamiques à une commande en utilisant :

• Une correspondance exacte, basée sur un texte spécifique au début ou à la fin des valeurs à extraire
• Expression régulière (regex), pour faire correspondre des valeurs sur la base d'un motif ou d'une séquence spécifique

Par exemple, si une commande produit un fichier texte contenant des valeurs utilisées par des commandes ultérieures dans la chaîne, extrayez ces valeurs via une sortie dynamique pour la commande List File Content du connecteur File Utils.

Note: Les sorties dynamiques ont une taille maximale de 1024 caractères. Si la correspondance dépasse cette longueur, rien n'est renvoyé.

Test d'une sortie dynamique

Pour vous assurer qu'une édition dynamique produit le résultat souhaité, testez ses critères à l'aide de valeurs types avant de la créer. Par exemple, vous pouvez tester une sortie dynamique avec des données de numéro de téléphone :

(381) 782-5259 (511) 545-6132 (220) 476-8339 (837) 516-4312 

1. Dans la chaîne, sélectionnez la commande avec la sortie à extraire, et cliquez sur Editer créer.
2. Sélectionnez Dynamic Outputs flash_on, et cliquez sur Test.
3. Dans Value to test, entrez un exemple de contenu indiquant la sortie de commande utilisée avec la sortie dynamique.
4. Saisissez les critères de correspondance exacts à utiliser pour la sortie dynamique. Par exemple, pour extraire les indicatifs régionaux des numéros de téléphone de l'échantillon :
   • Comme Correspondance exacte:
     • Dans Start et End, entrez les parenthèses d'ouverture et de fermeture, ( et ), respectivement.
     • Pour inclure les parenthèses dans la valeur extraite, sélectionnez Inclure le début et Inclure la fin.
   • Comme Expression régulière (regex) match :
     • Dans Match type, entrez l'expression régulière \(([0-9]*)\), qui correspond aux chiffres entre parenthèses.
     • Dans Résultat de la correspondance, entrez $0 pour afficher la totalité de la valeur correspondante y compris les parenthèses, ou $1 pour afficher uniquement les chiffres correspondants sans les parenthèses.
5. Cliquez sur Submit, et vérifiez que les résultats correspondent à la sortie souhaitée.

Créer une sortie dynamique basée sur une correspondance exacte

1. Dans la chaîne, sélectionnez la commande avec la sortie à extraire, et cliquez sur Editer créer.
2. Sélectionnez Dynamic Outputs flash_on, et cliquez sur Add Dynamic Output.
3. Saisissez un nom unique pour identifier la sortie dynamique.
4. Dans Original output, sélectionnez la sortie de la commande à extraire.
5. Dans Match, tapez et sélectionnez Exact.
6. Saisissez le texte indiquant le début ou la fin des chaînes à extraire et choisissez d'inclure ou non le texte correspondant dans la valeur extraite.
7. Pour que le texte ne corresponde qu'à des chaînes spécifiques de l'édition, saisissez les lignes à vérifier.
   • Pour inclure une série de lignes, utilisez un tiret -, comme 1-10 pour les lignes 1 à 10.
   • Pour séparer les lignes ou les plages, utilisez une virgule ,, comme 1-10,13 pour les lignes 1 à 10 et la ligne 13.
8. Dans Output type, choisissez d'extraire une seule valeur ou plusieurs valeurs.

   Remarque : Le type de sortie Multiple crée un tableau JSON contenant jusqu'à 1 000 éléments, que vous pouvez utiliser avec des itérations de commandes ou de groupes de commandes.

9. Pour tenir compte de la casse des caractères lors de la recherche de texte, sélectionnez Respect de la casse.
10. Pour supprimer les espaces blancs en début ou en fin de texte, sélectionnez Trim matches.
11. Cliquez sur Enregistrer.

Créer une sortie dynamique basée sur une expression régulière

1. Dans la chaîne, sélectionnez la commande avec la sortie à extraire, et cliquez sur Editer créer.
2. Sélectionnez Dynamic Outputs flash_on, et cliquez sur Add Dynamic Output.
3. Saisissez un nom unique pour identifier la sortie dynamique.
4. Dans Original output, sélectionnez la sortie de la commande à extraire.
5. Dans Match type, sélectionnez Regular Expression (regex).
   
6. Dans Match text, saisissez la syntaxe regex à utiliser pour faire correspondre les valeurs à extraire.
7. Dans Match result, entrez la syntaxe pour l'affichage de la valeur correspondante. Par exemple :
   • Pour l'ensemble de la valeur correspondante, entrez $0.
   • Pour la valeur correspondante entre parenthèses, entrez $1.
8. Pour que le texte ne corresponde qu'à des chaînes spécifiques de l'édition, saisissez les lignes à vérifier.
   • Pour inclure une série de lignes, utilisez un tiret -, comme 1-10 pour les lignes 1 à 10.
   • Pour séparer les lignes ou les plages, utilisez une virgule ,, comme 1-10, 13 pour les lignes 1 à 10 et ligne 13.
9. Dans Output type, choisissez d'extraire une seule valeur ou plusieurs valeurs.

   Remarque : Le type de sortie Multiple crée un tableau JSON contenant jusqu'à 1 000 éléments, que vous pouvez utiliser avec des itérations de commandes ou de groupes de commandes.

10. Cliquez sur Enregistrer.

Supprimer une sortie dynamique

Pour supprimer une sortie dynamique d'une commande :

1. Dans la chaîne, sélectionnez la commande contenant la sortie à extraire, cliquez sur Edit create, et sélectionnez Dynamic Outputs flash_on.
2. Pour la sortie dynamique à supprimer, cliquez sur Delete delete.