Valeur de format (Format Value)

UiPath.Core.Activities.FormatValue

Associe un format spécifique à une valeur générique qui peut être utilisée avec les opérations .ToString et Parse. Les formats disponibles sont Nombre (Number), DateHeure (DateTime), Devise (Currency) et Pourcentage (Percentage).

Propriétés

To

• Valeur (Value) - Valeur à mettre en forme. Ce champ prend en charge uniquement les variables GenericValue.

Entrée

• Format (Format) - Spécifie le format à appliquer à la valeur.

Commun

• NomAffichage (DisplayName) - Nom affiché de l'activité.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Exemple d’utilisation de l’activité Valeur de format (Format Value)

L'exemple ci-dessous explique comment utiliser la valeur de format en traitant les valeurs affectées et en les formatant comme vous le souhaitez.

Voici comment le processus d'automatisation peut être créé :

1. Ouvrez Studio et démarrez un nouveau Processus.

2. Faites glisser un conteneur Séquence vers le concepteur de workflow.

   • Créez la variable suivante :

     Nom de variable	Types de variables	Valeur par défaut
     formattedValue	ValeurGénérique

3. Faites glisser une activité Assign dans le conteneur Sequence.

   • Ajoutez la variable formattedValue dans le champ À.
   • Indiquez l'expression DateTime.Now dans le champ Valeur (Value) pour recevoir la date réelle.

4. Faites glisser une activité Valeur de format (Format Value) sous l’activité Attribuer (Assign).

   • Ajoutez la variable formattedValue dans le champ Valeur (Value).

5. Cliquez sur le bouton Définir le format (Set Format) de l'activité Valeur de format (Format Value) pour configurer le format des données.

   • Sélectionnez l’option Chaîne (String) dans la liste déroulante Type de format (Format Type).
   • Sélectionnez le style de date d'affichage souhaité dans la liste déroulante Modèle (Pattern).
   • Cliquez sur le bouton OK pour fermer le configurateur.

6. Faites glisser une activité Message du journal (Log Message) sous l’activité Format Value (Valeur de format).

   • Sélectionnez l'option Informations (Info) dans le bouton déroulant Niveau (Level).
   • Indiquez l'expression "Today is: "+formattedValue dans le champ Message. Cela affiche le message Nous sommes aujourd'hui le (Today is) et la date réelle, en utilisant le format précédemment sélectionné.

7. Faites glisser une activité Attribuer (Assign) sous l’activité Message du journal (Log Message).

   • Ajoutez la variable formattedValue dans le champ À.
   • Indiquez la valeur 19000.1234 dans le champ Valeur (Value). Cela représente la valeur réelle utilisée pour le formatage.

8. Faites glisser une activité Valeur de format (Format Value) sous l’activité Attribuer (Assign).

   • Ajoutez la variable formattedValue dans le champ Valeur (Value).

9. Cliquez sur le bouton Définir le format (Set Format) de l'activité Valeur de format (Format Value) pour configurer le format des données. Cela formate la valeur ajoutée dans l’activité Attribuer (Assign) précédente et détermine le nombre de décimales utilisé.

   • Sélectionnez l’option Numéro (Number) dans la liste déroulante Type de format (Format Type).
   • Indiquez la valeur 2 dans le champ Chiffres décimaux (Decimal Digits).
   • Sélectionnez l'option . dans la liste déroulante Séparateur décimal (Decimal Separator).
   • Indiquez la valeur , dans le champ Séparateur de groupe (Group Separator).
   • Cliquez sur le bouton OK pour fermer le configurateur.

10. Faites glisser une activité Message du journal (Log Message) sous l’activité Format Value (Valeur de format).

    • Sélectionnez l'option Info dans la liste déroulante Niveau (Level).
    • Indiquez l'expression "This decimal number is: "+formattedValue dans le champ Message. Cela affiche le message Ce nombre décimal est (This decimal number is) et le nombre réel.

11. Faites glisser une activité Attribuer (Assign) sous l’activité Message du journal (Log Message).

    • Ajoutez la variable formattedValue dans le champ À.
    • Indiquez la valeur 1.142 dans le champ Valeur (Value). Cette valeur représente la parité du jour entre l'euro et le dollar.

12. Faites glisser une activité Valeur de format (Format Value) sous l’activité Attribuer (Assign).

    • Ajoutez la variable formattedValue dans le champ Valeur (Value).

13. Cliquez sur le bouton Définir le format (Set Format) de l'activité Valeur de format (Format Value) pour configurer le format des données.

    • Sélectionnez l’option Devise (Currency) dans la liste déroulante Type de format (Format Type).
    • Indiquez la valeur 3 dans le champ Chiffres décimaux (Decimal Digits).
    • Sélectionnez l'option . dans la liste déroulante Séparateur décimal (Decimal Separator).
    • Sélectionnez l'option $ dans la liste déroulante Symbole (Symbol).
    • Indiquez la valeur , dans le champ Séparateur de groupe (Group Separator).
    • Cliquez sur le bouton OK pour fermer le configurateur.

14. Faites glisser une activité Message du journal (Log Message) sous l’activité Format Value (Valeur de format).

    • Sélectionnez l'option Informations (Info) dans le bouton déroulant Niveau (Level).
    • Indiquez l'expression "1 euro is: "+formattedValue dans le champ Message. Cela affiche le message 1 euro correspond à (1 euro is) et la valeur réelle d’un euro convertie en dollars.

15. Faites glisser une activité Attribuer (Assign) sous l’activité Message du journal (Log Message).

    • Ajoutez la variable formattedValue dans le champ À.
    • Indiquez la valeur 0.6666 dans le champ Valeur (Value). Cette valeur est utilisée pour afficher le pourcentage une fois les données formatées.

16. Faites glisser une activité Valeur de format (Format Value) sous l’activité Attribuer (Assign).

    • Ajoutez la variable formattedValue dans le champ Valeur (Value).

17. Cliquez sur le bouton Définir le format (Set Format) de l'activité Valeur de format (Format Value) pour configurer le format des données.

    • Sélectionnez l’option Pourcentage (Percentage) dans la liste déroulante Type de format (Format Type).
    • Indiquez la valeur 2 dans le champ Chiffres décimaux (Decimal Digits).
    • Sélectionnez l'option . dans la liste déroulante Séparateur décimal (Decimal Separator).
    • Ajoutez l’expression % dans le champ Symbole (Symbol).
    • Ajoutez l'expression , dans le champ Séparateur de groupe (Group Separator).
    • Cliquez sur le bouton OK pour fermer le configurateur.

18. Faites glisser une activité Message du journal (Log Message) sous l’activité Format Value (Valeur de format).

    • Sélectionnez l'option Info dans la liste déroulante Niveau (Level).
    • Indiquez l'expression "2/3 is: "+formattedValue dans le champ Message. Cela affiche le message 2/3 correspond à (2/3 is) et son équivalent en pourcentage.

    • Voici à quoi devrait ressembler votre workflow :

      
      

      

      
      

19. Exécutez le processus d'automatisation. Les données fournies sont traitées et affichées selon les paramètres, dans le panneau Sortie (Output).

    Téléchargez l'exemple