Gestion des variables

Dans Studio, les variables sont utilisées pour stocker plusieurs types de données. Un autre aspect clé des variables est que leur valeur peut changer. Il est donc, par exemple, possible de contrôler le nombre d'exécutions dans le corps d'une boucle.

Remarque :

• Les variables doivent posséder des noms uniques, même si elles sont utilisées dans des étendues différentes. Si deux variables ont le même nom mais se trouvent dans des étendues différentes, la variable de l’étendue interne sera prioritaire. Vous pouvez consulter nos recommandations dans la section Conventions d’affectation de noms de conception de workflow.
• Les noms de variable doivent commencer par une lettre ou un trait de soulignement _.
• L’utilisation de certains mots-clés (« Remplacer », par exemple) pour nommer les variables peut entraîner des erreurs inattendues.

Du point de vue de Studio, le nom de la variable est son ID unique et définit son mode d'affichage et d'utilisation. En cas de modification ou de suppression, Studio ne peut pas interpréter les fichiers .xaml en fonction des activités chargées.

Important : s'il existe à la fois une variable et un argument Gestion des arguments (Managing Arguments) portant le même nom, la variable est toujours utilisée par défaut lors du runtime.

Les valeurs (c'est-à-dire les informations contenues dans les variables) peuvent être de plusieurs types. Une multitude de formats sont acceptés dans UiPath, qu'il s'agissent de données génériques, numériques, tableaux, date/heure, UiElements, de texte ou de n'importe quel type de variable .Net.

Dans Studio, toutes les chaînes doivent être placées entre guillemets.

Créer une variable

Remarque : pour pouvoir créer une variable, le module Concepteur (Designer) doit contenir au moins une activité.

Depuis le corps d'une activité

1. À partir du panneau Activités (Activities), déplacez une activité vers le panneau Concepteur (Designer). Cliquez avec le bouton droit sur un champ et sélectionnez Créer une variable dans le menu contextuel, appuyez sur Ctrl+K ou sélectionnez Créer une variable dans l' icône Plus sur le côté droit du champ. Le champ Définir Var (Set Var) s'affiche.
2. Renseignez le nom et appuyez sur Entrée. La variable est créée et est visible dans le champ. Vérifiez son étendue et entrez-la dans le panneau Variables (Variables).

À partir d’expressions

Alternativement, les variables peuvent être créées à partir d’expressions directement dans un champ d’entrée d’activité ou dans l’éditeur d’expression :

1. Sélectionnez une partie de l’expression et appuyez sur Ctrl+K. Le champ Set Var s'affiche.

2. Renseignez le nom et appuyez sur Entrée. La variable est créée. Vérifiez son étendue et entrez-le dans le panneau Arguments(Arguments).

   
   

   

   
   

Les arguments ainsi créés reçoivent automatiquement le type en fonction de l'activité. Par exemple, si vous créez une variable dans le champ Data Table d'une activité Write Range, le type de la variable est défini sur DataTable. Si vous créez une variable dans le champ Text d'une activité Write Line, le type de la variable est défini sur String.

L'étendue de ces variables est le plus petit conteneur dont elle fait partie. Le type est automatiquement généré selon la propriété sélectionnée.

Depuis le panneau Propriétés

1. Dans le panneau Propriétés de n'importe quelle activité, cliquez avec le bouton droit sur un champ et sélectionnez Créer une variable dans le menu contextuel, appuyez sur Ctrl+K ou sélectionnez Créer une variable dans l' icône Plus sur le côté droit du champ. Le champ Définir Var (Set Var) s'affiche.
2. Renseignez le nom et appuyez sur Entrée. La variable est créée et est visible dans le champ. Vérifiez son étendue et entrez-la dans le panneau Variables (Variables).

L'étendue des variables créées de cette manière est le plus petit conteneur dont elle fait partie. Le type est automatiquement généré selon la propriété sélectionnée.

Depuis le panneau Variables (Variables)

1. Rendez-vous dans le module Concepteur (Designer) et cliquez sur Variables pour ouvrir le module Variables.
2. Cliquez sur la ligne Créer une variable (Create Variable) et renseignez le nom. Une variable est créée.

Le type par défaut des variables créées de cette façon est Chaîne (String).

Supprimer une variable

Pour supprimer une variable dans le panneau Variables, faites un clic droit sur la variable et sélectionnez Supprimer (Delete),ou sélectionnez la variable et appuyez sur la touche Supprimer.

Pour supprimer toutes les variables définies dans le panneau Variables mais qui ne sont utilisées nulle part dans le fichier actuel, accédez au ruban Studio, sélectionnez Supprimer les éléments inutilisés (Remove Unused) > Variables, puis sélectionnez Oui (Yes) lorsque le message de confirmation apparaît. Cela supprime également les variables inutilisées mais mentionnées dans les annotations.

Remarque : si vous supprimez ou mettez à niveau un paquet qui peut générer une variable ou un argument indéfini, un Type inconnu (Unknown Type) est ajouté à sa place pour que le fichier puisse être ouvert et modifié dans Studio.

Rechercher des variables de type .Net

Si vous souhaitez chercher un type de variables qui n'apparait pas par défaut dans la liste des Types de variables, suivez les instructions ci-dessous :

1. Dans le panneau Variables (Variables), liste déroulante Type de variable (Variable Type), sélectionnez Rechercher les types (Browse for Types). La fenêtre Rechercher et sélectionner un type .Net (Browse and Select a .Net Type) est affichée.
2. Dans le champ Nom du type (Type Name), saisissez un mot-clé pour la variable que vous recherchez (par exemple « Excel »). Tous les types de variables de type .Net contenant votre mot-clé apparaitront alors automatiquement dans la rubrique des résultats.

3. Sélectionnez un type de variable et cliquez sur OK (OK) pour créer une nouvelle variable de ce type dans le module Variables.

   
   

   

   
   
   Remarque : une fois qu'un type de variable provenant de la fenêtre Rechercher et sélectionner un type .Net (Browse and Select a .Net Type) a été utilisé, il est automatiquement ajouté à la liste déroulante Type de variable (Variable Type) du panneau Variables.

Les types de variable et d'argument faisant partie des assemblys propres à Studio ou à Robot sont masqués. Les workflows qui référencent les types provenant de ces assemblys ne doivent pas être affectés au moment de l'exécution. Pour utiliser un type d'un assembly autre que .Net Framework, ajoutez-le comme dépendance à votre projet à l'aide de la fenêtre Gérer les paquets (Manage Packages).