Portail de support Workiva

Pour faciliter leur utilisation en tant qu'entrées de commande dans une chaîne, vous pouvez appliquer des transformations à une variable ou à une sortie de commande. Vous pouvez appliquer plusieurs transformations à une entrée de commande, par exemple pour transformer davantage ses données ou la sortie de sa transformation.

Transformations

Note : Lorsque vous utilisez une sortie JSON comme propriété d'une autre commande, vous pouvez sélectionner un élément spécifique de la sortie au lieu de sa chaîne JSON complète. Si vous sélectionnez un élément au lieu de la chaîne complète, appliquez la transformation Get Value from JSON pour convertir son type de données.

Analyse du texte en JSON

Pour convertir une variable ou une sortie texte en JSON, appliquez la transformation Parse Text as JSON:

1. Dans la chaîne, sélectionnez le nœud de la commande avec l'entrée à transformer, et cliquez sur Editercréer.
2. Sous Command Properties, cliquez sur la variable ou la sortie à transformer.
3. Sélectionnez Parse text as JSON, et cliquez sur Addadd.

   Note : Pour extraire également un élément du JSON, sélectionnez Get Value from JSON et cliquez sur Addadd pour appliquer une transformation supplémentaire.

4. Cliquez sur Acceptez.

Mettre à jour la capitalisation d'une chaîne de caractères

Pour convertir une variable ou une sortie de texte en majuscules ou en minuscules, appliquez la transformation Uppercase ou Lowercase:

1. Dans la chaîne, sélectionnez la commande dont l'entrée doit être transformée et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez la transformation à appliquer :
   • Pour mettre en majuscule la première lettre de chaque mot de la chaîne, sélectionnez Titrer.
   • Pour convertir les caractères de la chaîne en majuscules, sélectionnez Majuscules ou Capitales.
   • Pour convertir les caractères de la chaîne en minuscules, sélectionnez Minuscules.

   Note : Pour transformer la chaîne, sélectionnez la transformation supplémentaire à appliquer et cliquez sur Addadd.

3. Cliquez sur Acceptez.

Ajouter ou supprimer les espaces de fin ou de début d'une chaîne de caractères

Pour ajouter ou supprimer des espaces au début ou à la fin d'une variable ou d'une sortie de chaîne de texte, appliquez une transformation Pad ou Trim:

1. Dans la chaîne, sélectionnez la commande dont l'entrée doit être transformée et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez la transformation à appliquer, puis cliquez sur Addadd:
   • Pour ajouter des espaces au début de la chaîne, sélectionnez Pad Left et entrez la longueur totale de la chaîne.
   • Pour ajouter des espaces à la fin de la chaîne, sélectionnez Pad Right et entrez la longueur totale de la chaîne.
   • Pour supprimer les espaces au début de la chaîne, sélectionnez Trim Prefixe.
   • Pour supprimer les espaces à la fin de la chaîne, sélectionnez Trim Suffixe.
   • Pour supprimer les espaces au début et à la fin de la chaîne, sélectionnez Découper.

   Note : Pour transformer la sortie de la chaîne, sélectionnez la transformation supplémentaire à appliquer et cliquez sur Addadd.

3. Sélectionner Accepter.

Diviser une chaîne de caractères

Pour diviser une variable ou une sortie de chaîne de texte en fonction d'une valeur de délimitation, appliquez la transformation Fractionner :

1. Dans la chaîne, sélectionnez la commande dont l'entrée doit être transformée et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez Fractionner, puis cliquez sur Ajouterajouter.
3. Pour Délimiteur, entrez la valeur du texte à laquelle couper la chaîne.

   Note : Pour transformer la sortie de la chaîne, sélectionnez la transformation supplémentaire à appliquer et cliquez sur Addadd.

4. Sélectionner Accepter.

Remplacer une valeur dans une chaîne de caractères

Pour remplacer une valeur à l'intérieur d'une variable texte ou d'une sortie par une autre valeur, appliquez la transformation Replace:

1. Dans la chaîne, sélectionnez la commande dont l'entrée doit être transformée et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez Remplacer, puis cliquez sur Ajouterajouter.
3. Dans Rechercher, entrez les critères de la valeur à remplacer dans la chaîne sous la forme d'un texte exact ou d'une expression régulière.
4. Dans Remplacement, entrez la valeur qui remplacera le texte correspondant aux critères Rechercher.
5. Dans Match Type, sélectionnez si les critères Find doivent être recherchés au moyen d'une correspondance exacte ou d'une expression régulière (RegEx).

   Note : Pour transformer la sortie de la chaîne, sélectionnez la transformation supplémentaire à appliquer et cliquez sur Addadd.

6. Cliquez sur Acceptez.

Ajouter, soustraire, multiplier, diviser ou arrondir des nombres

Pour effectuer une opération mathématique sur une valeur numérique, appliquez une transformation Ajouter, Soustraire, Multiplier, Diviser, ou Arrondir.

Conseil : Pour effectuer une opération mathématique sur une valeur numérique, appliquez d'abord une transformation Parse number.

• Pour une transformation Ajouter ou Soustraire, entrez de combien il faut augmenter ou diminuer le nombre.
• Pour une transformation Multiplier ou Diviser, entrez par combien il faut multiplier ou diviser le nombre.
• Pour une transformation Round, entrez le nombre de décimales à arrondir.

Analyse une date ou un horodatage sous forme de chaîne de caractères.

Pour convertir une variable ou une sortie de date ou d'horodatage dans un format et un fuseau horaire spécifiques, appliquez la transformation Parse Date/Time:

1. Dans la chaîne, sélectionnez la commande dont l'entrée doit être transformée et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez Parse Date/Time, puis cliquez sur Addadd.
3. Sélectionnez si vous souhaitez utiliser le format standard de l'Organisation internationale de normalisation (ISO) ou une mise en forme personnalisée pour la date ou l'horodatage.
4. Saisissez comment mettre en forme des valeurs de date ou d'heure en utilisant strftime formats et des séparateurs tels que ., ,, :, ou /. Par exemple, %m-%d-%Y pour 01-30-2020, ou %H:%M pour 21:08.
5. Pour modifier le fuseau horaire de la date ou de l'horodatage, sélectionnez les fuseaux horaires des valeurs d'entrée et de sortie.

   Note : Pour transformer la sortie de la chaîne, sélectionnez la transformation supplémentaire à appliquer et cliquez sur Addadd.

6. Cliquez sur Acceptez.

Ajouter ou soustraire une date ou un horodatage

Pour ajouter ou soustraire une valeur d'intervalle à une variable ou à une sortie de date ou d'horodatage, appliquez la transformation Add/Subtract Date and Time:

1. Dans la chaîne, sélectionnez la commande dont l'entrée doit être transformée et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez Ajouter/Soustraire la date et l'heure, puis cliquez sur Ajouterajouter.
3. Sélectionner l'utilisation de la norme de l'Organisation internationale de normalisation (ISO) ou un format personnalisé.
4. Pour l'opération , sélectionnez l'option Ajouter ou Soustraire l'horodatage.
5. Saisissez l'incrément à ajouter ou à soustraire à l'horodatage, par exemple 1 jour.

   Note : Pour mettre en forme l'horodatage, sélectionnez Parse Date/Time et cliquez sur Addadd pour appliquer une transformation supplémentaire.

6. Cliquez sur Acceptez.

Trier les éléments d'une liste

Pour trier les éléments d'une variable de liste ou d'une sortie par ordre croissant ou décroissant, appliquez la transformation Sort List:

1. Dans la chaîne, sélectionnez la commande dont l'entrée doit être transformée et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez Liste de tri, puis cliquez sur Ajouterajouter.
3. Sélectionnez si la liste doit être triée par ordre croissant ou décroissant.

   Note : Pour sélectionner un élément de la liste, sélectionnez Pick from List et cliquez sur Addadd pour appliquer une transformation supplémentaire.

4. Cliquez sur Acceptez.

Choisir des éléments dans une liste

Pour extraire un élément individuel d'une variable de liste ou d'une sortie, appliquez la transformation Pick from List:

1. Dans la chaîne, sélectionnez la commande dont l'entrée doit être transformée et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez Pick from List, puis cliquez sur Addadd.
3. Pour la valeur , entrez le numéro d'index de l'élément à sélectionner ; 0 pour le premier élément, -1 pour le dernier.

   Note : Pour transformer l'élément de la chaîne, sélectionnez la transformation supplémentaire à appliquer et cliquez sur Addadd.

4. Cliquez sur Acceptez.

Obtenir des valeurs à partir de JSON

Pour convertir un élément individuel d'une variable ou d'une sortie JSON en chaîne, liste ou JSON, appliquez la transformation Get Value from JSON. Lors de l'utilisation de la transformation. les éléments d'une liste dans le JSON utilisent un index basé sur zéro, où la première valeur a un index de 0.

Note : Pour déterminer l'index et le nom de l'élément à analyser avec la transformation, cliquez sur Monitorflight_takeoff, et affichez la sortie JSON de la commande.

1. Dans la chaîne, sélectionnez la commande dont l'entrée doit être transformée et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez Get Value from JSON, puis cliquez sur Addadd.
   
3. Sélectionnez si l'élément doit être sorti sous forme de texte title, de liste list, ou de JSON code.
4. Pour Valeur, entrez :
   • Si le JSON inclut plusieurs objets, l'index de l'objet à extraire, en commençant par 0. Par exemple, pour le deuxième objet, entrez 1.

     Note : N'entrez l'index que si le JSON inclut plusieurs objets.

   • Le nom de l'élément à sélectionner, par exemple id.

   Note : Pour transformer la sortie de la transformation, par exemple pour mettre en forme une chaîne de dates ou trier une liste, sélectionnez la transformation supplémentaire à appliquer et cliquez sur Addadd.

5. Cliquez sur Acceptez.