Types de variables

Les variables de type texte

Une variable de Text ou de string est un type de variable qui ne peut stocker que des strings.Ces types de variable peuvent être utilisés pour stocker des informations telles que des noms d'employés, des noms d'utilisateur ou toute autre string.

Remarque :

Les valeurs de chaînes doivent toujours être placées entre guillemets dans UiPath.

Exemple d'utilisation d'une variable de type texte

Pour illustrer les propriétés d'une variable de type texte, nous vous invitons à créer un projet dont l'objectif est de demander le nom de l'utilisateur, de l'enregistrer, puis d'afficher l'initiale de l'utilisateur dans le module Sortie (Output).

1. Créez une séquence.

2. Créez deux chaînes de caractères simples, FullName et FirstLetter.

   

3. Ajouter une activité Boîte de dialogue (Input Dialog) dans le panneauConcepteur (Designer).

4. Dans le champ Libellé d'entrée (Input Label), saisissez « Veuillez saisir votre nom complet. » (Type your full name please.).

5. Dans le champ Titre de la boîte de dialogue (Dialog Title), saisissez « Quel est votre nom ? » (What is your name?).

6. Dans le champ Valeur saisie (Value entered), ajoutez la variable FullName. Cette variable stocke tout ce que l’utilisateur écrit lorsque l’activité Boîte de dialogue (Input Dialog) l'y invite.

7. Ajouter une activité Attribuer (Assign) sous l'activité Boîte de dialogue (Input Dialog).

8. Ajoutez la variable FirstLetter dans le champ À (To) du module Propriétés (Properties).

9. Saisissez FullName.Substring(0,1) dans le champ Valeur (Value) pour enregistrer la valeur créée par l'expression FullName.Substring(0,1) dans la variable FirstLetter.

   Remarque :

   Ce champ utilise la fonction Substring() pour trouver le premier caractère du texte soumis par l'utilisateur dans la Boîte de dialogue (Input Dialog).

10. Ajouter une activité Écrire une ligne (Write Line) sous l'activité Attribuer (Assign).

11. Rendez-vous dans le module Propriétés (Properties) et saisissez la variable FirstLetter dans le champ Texte (Text): grâce à cette action, la premiere lettre du texte renseigné par l'utilisateur dans la Boîte de dialogue (Input Dialog) s'affichera au niveau du module Sortie (Output). Le projet devrait à présent ressembler à l'illustration suivante :

    

12. Appuyez sur la touche F5 : la fenêtre « Quel est votre nom ? » s'ouvre.

13. Saisissez votre nom dans le champ du texte et cliquez sur OK (OK). La première lettre de votre nom s'affiche alors dans le module Sortie (Output) de Studio UiPath (UiPath Studio).

    

Téléchargez l'exemple

Variables de type VRAI ou FAUX

Les variables VRAI/FAUX, également appelées variables de type booléen, n'ont que deux valeurs possibles : vrai (true) ou faux (false). Elles permettent de mieux contrôler le flux, grâce à un mécanisme de décisions.

Exemple d'utilisation d'une variable de type VRAI/FAUX (True/False)

Pour illustrer les propriétés d'une variable VRAI/FAUX (TRUE/FALSE), nous vous invitons à créer un projet d'automatisation dont l'objectif est de demander le nom et le sexe de l'utilisateur, puis d'afficher les résultats obtenus dans une autre fenêtre.

1. Créez un processus et ajoutez un Organigramme (Flowchart).

2. Créez deux variables de type String afin d'enregistrer respectivement le nom de l'utilisateur et son sexe : Name et Gender.

3. Créez une variable de type booléen : Male. Cette variable va être utilisée pour vérifier si l'utilisateur est un homme.

   

4. Ajouter une activité Boîte de dialogue (Input Dialog) au panneau Concepteur (Designer) et la relier au nœud Initial.

5. Dans le module Propriétés (Properties), saisissez "Quel est votre nom ?" dans le champ Intitulé.

6. Ajoutez un titre, puis ajoutez la variable Name dans le champ Résultat (Result).

7. Ajoutez une nouvelle Boîte de dialogue (Input Dialog) et reliez-la à la précédente.

8. Dans le module Propriétés (Properties), saisissez "Quel est votre sexe ?" dans le champ Intitulé.

9. Ajoutez un titre, puis ajoutez la variable Gender dans le champ Résultat (Result).

10. Ajouter une activité Décision (Flow Decision) au panneau Concepteur (Designer) et la relier à la deuxième activité Boîte de dialogue (Input Dialog).

11. Rendez-vous dans le module Propriétés (Properties) et saisissez Gender= "Male" ou Gender = "male" dans le champ Condition (Condition), afin de vérifier si l'utilisateur est de sexe masculin ou féminin.

12. Ajouter deux activités Attribuer (Assign).

13. Reliez une de celles-ci à la branche sortante Vrai (True) de la Décision (Flow Decision).

14. Rendez-vous dans le module Propriétés (Properties) et saisissez la variable Male dans le champ À (To).

15. Dans le champ Valeur (Value), saisissez Vrai (True). Cela assigne la valeur Vrai (True) à la variable Male lorsque la condition Gender = "Male" ou Gender = "male" est remplie.

16. Reliez la deuxième activité de type Attribuer (Assign) à la branche sortante Faux (False) de la Décision (Flow Decision).

17. Rendez-vous dans le module Propriétés (Properties) et saisissez la variable Male dans le champ À (To).

18. Dans le champ Valeur (Value), saisissez Faux (False). Cela assigne la valeur Faux (False) à la variable Male lorsque la condition Gender = "Male" ou Gender = "male" n'est pas remplie.

19. Ajoutez une nouvelle Décision (Flow Decision) et reliez-la aux activités de types Attribuer (Assign) précédentes.

20. Rendez-vous dans le module Propriétés (Properties) et saisissez Male = True dans le champ Condition.

21. Insérer une activité Zone de message (Message Box) et la connecter à la branche Vrai (True) de l'activitéDécision (Flow Decision).

22. Rendez-vous dans le module Propriétés (Properties) et saisissez le message suivant : Name + " est un/une " + Gender + "." dans le champ Texte (Text). Ce message indiquera le nom et le sexe de l'utilisateur si Male est vrai.

23. Insérez une autre activité de type Zone de message (Message Box) et reliez-la à la branche sortante Faux (False) de la Décision (Flow Decision).

24. Rendez-vous dans le module Propriétés (Properties) (Properties) et saisissez le message suivant : Name + " est un/une " + Gender + "." dans le champ Texte (Text). Ce message indiquera le nom et le sexe de l'utilisateur si Male est faux. Le projet final devrait ressembler à l'illustration suivante :

    

25. Appuyez sur la touche F5 pour executer le processus d'automatisation. Remarque : le message s'affiche bien comme prévu dans la dernière Zone de message (Message Box).

    

Téléchargez l'exemple

Variables numériques

Les variables numériques sont également connues sous le nom integer ou Int32 et sont utilisées pour stocker des informations numériques. Elles peuvent être utilisées pour effectuer des équations ou des comparaisons, transmettre des données importantes et bien plus.

Exemple d'utilisation d'une variable numérique

Pour illustrer les propriétés d'une variable numérique, nous vous invitons à créer un projet d'automatisation dont l'objectif est de demander l'année de naissance de l'utilisateur, puis d'afficher son âge dans une fenêtre.

1. Créez une nouvelle séquence.
2. Créez deux variables de type Int32 : BirthYear, Age. La première variable enregistrera l'année de naissance de l'utilisateur, tandis que la seconde enregistrera son âge.
3. Ajouter une activité Boîte de dialogue (Input Dialog) à la séquence.
4. Dans les champs Titre de la boîte de dialogue (Dialog Title) et Libellé d'entrée (Input Label), saisissez un titre et un libellé appropriés.
5. Dans le champ Valeur saisie (Value entered), ajoutez la variable BirthYear.
6. Ajouter une activité Attribuer (Assign) sous l'activité Boîte de dialogue (Input Dialog).
7. Ajoutez la variable Age dans le champ À (To) du module Propriétés (Properties).
8. Indiquez 2022 – BirthYear dans le champ Valeur (Value). Cela attribue la valeur de la soustraction (2022 moins l'année de naissance de l'utilisateur) à la variable Age.
9. Ajouter une activité Zone de message (Message Box) sous l'activité Attribuer (Assign).
10. Rendez-vous dans le module Propriétés (Properties) et saisissez le message suivant : "Félicitations ! Vous avez " + Age.ToString + " ans." dans le champ Texte (Text).
    Remarque :

    La méthode .ToString permet de convertir et d'afficher le nombre entier contenu dans la variable Age sous la forme d'une chaîne de caractères.

Le projet final devrait ressembler à l'illustration suivante :

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-168957-3820f59a.webp)

11. Appuyez sur F5. pour exécuter votre projet d'automatisation. Notez que la boîte de message affiche votre âge, comme prévu.

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-168061-d86823a5.webp)

Téléchargez l'exemple

Variables Tableaux

La variable tableau permet d'enregistrer plusieurs valeurs du même type.

Studio UiPath accepte autant de types de tableaux qu'il y a de types de variables. Il est donc possible de créer un tableau numérique, un tableau de chaînes, un tableau de valeurs booléennes, etc.

Exemple d'utilisation d'une variable de tableau

Pour illustrer le mode d'utilisation des variables du tableau, nous allons créer une automatisation qui demande à l'utilisateur son prénom, son nom et son âge, stocke les informations dans un tableau, puis les écrit dans un fichier .txt.

1. Créez une nouvelle séquence.

2. Créez trois chaînes de caractères pour enregistrer les données obtenues : FirstName, LastName et Age.

3. Créez un tableau de chaînes de caractères nommé NameAge.

   

4. Ajouter une activité Boîte de dialogue (Input Dialog) dans le panneauConcepteur (Designer).

5. Fill in the Dialog Title and Input Label fields to ask for the user’s first name.

6. In the Value entered field, type the FirstName variable. This variable stores the first name of the user.

7. Ajoutez une activité Boîte de dialogue (Input Dialog) sous la précédente.

8. Remplissez les champs Titre de la boîte de dialogue (Dialog Title) et Libellé d'entrée (Input Label) pour demander le nom de famille de l'utilisateur.

9. In the Value entered field, type the LastName variable. This variable is going to store the last name of the user.

10. Ajoutez une activité Boîte de dialogue (Input Dialog) sous la précédente.

11. Fill in the Dialog Title and Input Label fields to ask for the user’s age.

12. Dans le champ Valeur saisie (Value entered), saisissez la variable Age. Cette variable va stocker l’âge de l’utilisateur.

    Remarque :

    L'âge de l'utilisateur est enregistré directement dans une chaîne de caractères (et non dans une variable de type integer) car cela évite de devoir convertir cette donnée plus tard, lors de son ajout à une variable de type tableau de chaînes.

13. Ajouter une activité Attribuer (Assign) sous la dernière activité Boîte de dialogue (Input Dialog).

14. Saisissez la variable NameAge au champ À (To) dans le module Propriétés (Properties).

15. Dans le champ Value , saisissez {FirstName, LastName, Age}. Cette activité Assigner vous permet de stocker toutes les valeurs des variables de chaîne initiales dans celle de NameAge.

16. Ajouter une activité Écrire un fichier texte (Write Text File) sous l'activité Attribuer(Assign).

17. Dans le panneau Propriétés (Properties), champ FileName, entrez le chemin du fichier à écrire entre guillemets, par exemple "%HOMEPATH%\Desktop\array_variable.txt".

    Remarque :

    Le fichier est créé s'il n'existe pas déjà dans le repertoire indiqué.

18. Dans le champ Texte (Text), saisissez NameAge(0) + " " + NameAge(1) + " " +NameAge(2) + " ".

    Remarque :

    L'ajout d'un numéro d'index aux données du tableau permet d'accéder à leurs valeurs et, dans cet exemple, de les enregistrer dans un fichier texte.

Le projet final devrait ressembler à l'illustration suivante :

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-168829-38b653ec.webp)

19. Appuyez sur Ctrl + F5 pour exécuter le projet. 20. Accédez au fichier fourni à l'étape 17 et double-cliquez dessus. Une fenêtre Bloc-notes s'affiche avec les informations que vous avez ajoutées à l'étape 20.

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-168165-a2bd791f.webp)

Téléchargez l'exemple

Variables de type date et heure

La variable de type date et heure est un type de variable qui permet de stocker des informations sur n'importe quelle date et heure. Ce type de variable est disponible dans la fenêtre Rechercher et sélectionner un type .Net (Browse and Select a .Net Type), sous l'espace de noms système System.DateTime. Pour plus d'informations, reportez-vous à Recherche des types de variables .Net.

Ce type de variable peut par exemple être utilisé pour insérer la date dans une facture ou pour tous les type de documents nécessitant d'être horodaté.

Exemple d'utilisation d'une variable de type date et heure

Pour illustrer les propriétés d'une variable date et heure, nous vous invitons à créer un projet d'automatisation dont l'objectif est de récupérer la date et l'heure, de soustraire une période de temps donnée puis d'afficher les résultats obtenus dans une feuille de calcul Microsoft Excel.

1. Créez une nouvelle séquence.
2. Créez deux variables de type DateTime : Today et LastTime.
3. Créez une variable TimeSpan, appelée Span, et dans le champ Par défaut (Default), entrez 1.02:10:04.
   Remarque :

   La valeur par défaut donnée à la variable Span suit le format jour.hh:mm:ss.

4. Ajouter une activité Attribuer (Assign) au panneau Concepteur (Designer).
5. Ajoutez la variable Today dans le champ À (To) du module Propriétés (Properties).
6. Dans le champ Valeur (Value), entrez Now. Cela vous donne la date et heure d'exécution du projet, dans les formats dd/MM/yyyy et hh:mm:ss.
7. Ajoutez une autre activité de type Attribuer (Assign) sous la précédente.
8. Ajoutez la variable LastTime dans le champ À (To) du module Propriétés (Properties).
9. Indiquez Today.Subtract(Span) dans le champ Valeur (Value). Cela va soustraire la valeur par défaut de la variable Span de la date actuelle, enregistrées dans la variable Today.
10. Ajoutez une activité Excel Process Scope sous la dernière activité Attribuer.Cette activité ouvre ou réutilise des Processes Excel, charge les paramètres du projet Excel et les applique au fichier Excel associé.
11. Ajoutez une activité Utiliser le fichier Excel à l'intérieur de l'activité Étendue du processus Excel.
    Remarque :

    Utiliser l'outil de Gestion des paquets (Manage Packages) pour télécharger les activités Excel si celles-ci ne sont pas déjà installées.

12. Dans le champ Chemin d'accès au classeur (Workbook path), saisissez le chemin d'accès au fichier Excel dans lequel vous souhaitez écrire, entre guillemets. Dans notre cas, il s'agit de "%HOMEPATH%\Desktop\urgent_invoice.xlsx".
    Remarque :

    Le fichier sera créé s'il n'existe pas déjà dans le repertoire indiqué.

13. Ajoutez une activité Écrire la cellule (Write Cell) dans l'activité Utiliser le fichier Excel (Use Excel File).
14. Dans le champ Quoi écrire (What to write), tapez LastTime.ToString. Cela transforme la valeur de la variable LastTime en chaîne et l’écrit selon les coordonnées précédemment données.
15. Sur le côté droit du champ Où écrire (Where to write), sélectionnez Plus > Excel > Indiquer dans Excel (Indicate in Excel).
16. À l'intérieur du fichier Excel, indiquez la cellule dans laquelle vous souhaitez écrire (dans notre cas, « E3 »). Cliquez sur Confirmer (Confirm) après avoir indiqué la cellule.

Le projet final doit ressembler à la capture d'écran suivante :

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-166740-814a08a0.webp)

17. Appuyez sur F5. L'automatisation est exécutée. 18. Accédez à votre fichier Excel et double-cliquez sur la cellule dans laquelle vous avez ajouté la date. Notez que les informations d'heure et de date s'affichent dans la cellule vers laquelle vous avez pointée.

![docs image](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-167045-874ea11d.webp)

Téléchargez l'exemple

Variables de type DataTable

Une variable de type Table des données (DataTable) est capable de contenir une grande quantité d'informations et de fonctionner comme une base de données ou comme une feuille de calcul de base composée de lignes et de colonnes. On peut trouver ce type de variable dans la fenêtre Parcourir et sélectionner un type .Net (Browse and Select a .Net Type), sous l'option espace de noms System.Data (System.Data.DataTable). Pour plus d'informations, consultez le chapitre Rechercher des variables de type .Net.

Ces variables peuvent être utilisées pour migrer des données spécifiques d'une base de données vers une autre, pour extraire des données d'un site Web et les enregistrer dans une feuille de calcul sauvegardée sur un ordinateur local, et bien plus.

Exemple d'utilisation d'une variable de type Table des données (DataTable)

Pour illustrer les propriétés d'une variable de type Table des données (DataTable), nous vous invitons à créer un projet d'automatisation : son objectif est de lire une feuille de calcul Excel contenant de nombreuse colonnes, de récupérer les informations provenant de deux colonnes spécifiques, puis d'enregistrer ces données dans une autre feuille de calcul contenant déjà des éléments.

Le fichier d'origine est une base de données contenant une liste de personnes, de transactions, de dates et de produits. Dans notre exemple, nous allons extraire les noms des individus et la date de leur commande pour ajouter ces données à une feuille de calcul Excel contenant déjà des informations similaires.

1. Créez une nouvelle séquence.

2. Ajoutez une activité Excel Process Scope.Cette activité ouvre ou réutilise des Processes Excel, charge les paramètres du projet Excel et les applique au fichier Excel associé.

3. Ajoutez une activité Utiliser le fichier Excel à la séquence.Cette activité est requise pour la plupart des activités liées à Excel.

   Remarque :

   Utilisez l'outil de Gestion des paquets (Manage Packages) pour obtenir les activités Excel si celles-ci ne sont pas déjà installées dans votre version UiPath.

4. Créez deux variables de type Table de données (DataTable) : dt_NamesList, dt_DateInfo. Leur rôle sera d'enregistrer les données provenant de la feuille de calcul Excel d'origine.

5. Sélectionnez le champ Chemin classeur (WorkbookPath) dans le module Propriétés (Properties) et indiquez le chemin d'accès du fichier Excel à utiliser.

6. Ajoutez deux activités Lire une plage et placez-les l'une sous l'autre dans l'activité Utiliser le fichier Excel.Celles-ci sont utilisées pour obtenir des informations de la feuille de calcul initiale.

7. Sélectionnez la première activité Lire la plage (Read Range). Sur le côté droit du champ Plage (Range), sélectionnez Plus > Excel > Indiquer dans Excel (Indicate in Excel).

8. À l’intérieur du fichier Excel, indiquez les coordonnées qui signalent à UiPath Studio d’où extraire les informations (dans notre cas, « G7:G37 »). Cliquez sur Confirmer (Confirm) après avoir sélectionné la plage.

9. Dans le champ Enregistrer vers (Save to), saisissez le nom de la première variable TableDonnées (DataTable), dt_NamesList. Cette variable stocke toutes les informations disponibles entre les lignes G7 et G37.

10. (Facultatif) Pour pouvoir distinguer cette activité de l'autre, saisissez une valeur différente dans le champ NomComplet ((DisplayName), comme Lire les noms (Read Names).

11. Sélectionnez la deuxième activité Lire la plage (Read Range). Sur le côté droit du champ Plage (Range), sélectionnez Plus > Excel > Indiquer dans Excel (Indicate in Excel).

12. À l'intérieur du fichier Excel, indiquez les coordonnées qui contiennent la date de commande que nous voulons extraire (dans notre cas, « C7:C37 »). Cliquez sur Confirmer (Confirm) après avoir sélectionné la plage.

13. Dans le champ Enregistrer vers (Save to), spécifiez la variable dt_DateInfo. Cette variable conserve toutes les informations de date dont nous avons besoin.

14. Ajoutez une deuxième activité Utiliser le fichier Excel à la sequence.

15. Sélectionnez le champ Chemin classeur (WorkbookPath) dans le module Propriétés (Properties) et indiquez le chemin d'accès du fichier Excel à utiliser pour enregistrer toutes les données extraites au cours des étapes précédentes.

16. Ajoutez une activité Write DataTable to Excel (Ecrire la table de données dans Excel) au panneau Concepteur sous le deuxième Utiliser le fichier Excel. Cette activité est utilisée pour écrire les informations stockées dans un autre fichier Excel.

    Remarque :

    Le fichier utilisé par l'activité Écriture de plage (Write Range) doit être fermé lorsque vous exécutez le projet. S'il est ouvert, une erreur s'affichera et l'exécution du projet d'automation sera interrompue.

17. Saisissez la variable dt_NamesList dans le champ Quoi écrire (What to write).

18. Sur le côté droit du champ Destination, sélectionnez Plus > Excel > Indiquer dans Excel (Indicate in Excel).

19. À l'intérieur du deuxième fichier Excel, sélectionnez la cellule de départ dans laquelle les informations du fichier initial doivent être ajoutées (dans notre cas, « B7 »). Cliquez sur Confirmer (Confirm).

20. Ajoutez une activité de type Écrire un objet TableDonnées dans Excel (Write DataTable to Excel) sous la première.

21. Saisissez la variable dt_DateInfo dans le champ Quoi écrire (What to write).

22. Sur le côté droit du champ Destination, sélectionnez Plus > Excel > Indiquer dans Excel (Indicate in Excel).

23. Sélectionnez la cellule de départ (dans notre cas, « A7 »). Cliquez sur Confirmer (Confirm).

    

24. Appuyez sur la touche F5 pour exécuter votre projet d'automatisation.

25. Double-cliquez sur le fichier Excel destinataire pour vérifier que les données copiées ont bien été intégrées.

    

Téléchargez l'exemple