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 la 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 texte ou une sortie 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 Modifierer créer.
2. Sous Command Properties, cliquez sur la variable ou la sortie à transformer.
3. Sélectionnez Parse text as JSON, et cliquez sur Add add.

   Note : Pour extraire un élément du JSON, sélectionnez Get Value from JSON et cliquez sur Add add 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 chaîne de texte en majuscules ou en minuscules, appliquez la transformation Uppercase ou Lowercase:

To title-case a text string variable or output or convert its characters to all uppercase or lower-case:-->

1. Dans la chaîne, sélectionnez la commande avec l'entrée à transformer et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
<!--
2. Select whether to convert the string to Uppercase or Lowercase, and click Add&nbsp;&nbsp;add.
-->
3. 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 Add add.

4. 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 avec l'entrée à transformer et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez la transformation à appliquer et cliquez sur Add add:
   • 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 Découper le préfixe.
   • Pour supprimer les espaces à la fin de la chaîne, sélectionnez Découper le 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 Add add.

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 avec l'entrée à transformer et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez Split, puis cliquez sur Add add.
3. Pour Délimiteur, entrez la valeur du texte à partir de laquelle la chaîne doit être divisée.

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

4. Sélectionner Accepter.

Remplacer une valeur dans une chaîne

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 avec l'entrée à transformer et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez Remplacer, puis cliquez sur Ajouter ajouter.
3. Dans Find, saisissez 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 Replacement, entrez la valeur qui remplacera le texte correspondant aux critères Find.
5. Dans Match Type, choisissez de rechercher les critères Find par une correspondance exacte ou 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 Add add.

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 Add ou Subtract, indiquez de combien il faut augmenter ou diminuer le nombre.
• Pour une transformation Multiplier ou Diviser, indiquez par combien multiplier ou diviser le nombre.
• Pour une transformation Round, indiquez 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 un résultat 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 avec l'entrée à transformer et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez Parse Date/Time, puis cliquez sur Add add.
3. Choisissez d'utiliser le format standard de l'Organisation internationale de normalisation (ISO) ou un format personnalisé pour la date ou l'horodatage.
4. Entrez comment formater 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 Add add.

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 avec l'entrée à transformer 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 Add add.
3. Choisissez d'utiliser le format standard de l'Organisation internationale de normalisation (ISO) ou un format personnalisé.
4. Pour Operation, choisissez d'ajouter ou de soustraire l'horodatage.
5. Saisissez l'incrément à ajouter ou à soustraire à l'horodatage, par exemple 1 jour.

   Remarque : Pour modifier le format de l'horodatage, sélectionnez Parse Date/Time et cliquez sur Add add 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 dans l'ordre croissant ou décroissant, appliquez la transformation Sort List:

1. Dans la chaîne, sélectionnez la commande avec l'entrée à transformer et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez Liste de tri, puis cliquez sur Add add.
3. Choisissez de trier la liste par ordre croissant ou décroissant.

   Remarque : Pour sélectionner un élément de chaîne dans la liste, sélectionnez Pick from List et cliquez sur Add add 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 avec l'entrée à transformer et, sous Command Properties, cliquez sur la variable ou la sortie à transformer.
2. Sélectionnez Pick from List, puis cliquez sur Add add.
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 Add add.

4. Cliquez sur Acceptez.

Obtenir des valeurs à partir de JSON

Pour convertir un élément individuel d'une variable JSON ou d'une sortie 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 Monitor flight_takeoff, et affichez la sortie JSON de la commande.

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

     Remarque : N'entrez l'index que si le JSON comprend plusieurs objets.

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

   Note : Pour transformer le résultat de la transformation, par exemple pour formater une chaîne de dates ou trier une liste, sélectionnez la transformation supplémentaire à appliquer et cliquez sur Add add.

5. Cliquez sur Acceptez.