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 il définit la façon dont elle est affichée et utilisée. Si cela change ou est supprimé, Studio ne sera pas en mesure d'interpréter les fichiers .xaml en fonction des activités chargées. Toutes les chaînes doivent être placées entre guillemets.

Attention : s'il existe une variable et un argument portant le même nom, la variable est toujours utilisée par défaut lors du runtime.

Vous pouvez gérer les variables de plusieurs manières. Pour bénéficier d'une expérience et d'une flexibilité optimales, nous vous recommandons d'utiliser le gestionnaire de données.

Types de variables

Les données stockées dans une variable sont appelées valeur et peuvent être de plusieurs types. Lorsque vous créez une variable, les options suivantes sont disponibles :

• Booléen (Boolean) : ce type n’a que deux valeurs possibles : true ou false. Ces variables vous permettent de prendre des décisions, et donc d’avoir un meilleur contrôle sur votre workflow.
• Int32 : ce type est utilisé pour stocker des informations numériques. Certaines de ses utilisations consistent à effectuer des équations, des comparaisons et à transmettre des données importantes.
• Chaîne (String) : stocke les informations textuelles. Ce type de variable peut être utilisé pour stocker toute information textuelle telle que les noms d’employés, les noms d’utilisateur ou toute autre chaîne.
• Objet (Object) : peut être utilisé pour stocker différents types de données. Vous pouvez utiliser ce type de variable dans les situations où vous avez besoin de flexibilité pour le type de données que vous stockez dans une variable. Assurez-vous que le type de données utilisé dans les variables d’objet est compatible avec les activités qui utilisent la variable.
• TableDonnées.Données.Système (System.Data.DataTable) : ce type peut stocker de gros éléments d'information et agir comme une base de données ou une simple feuille de calcul avec des lignes et des colonnes. Il peut être utile 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.
• Tableau de [T] (Array of [T]) : vous permet de stocker plusieurs valeurs du même type.

• Parcourir les types (Browse for Types) - Vous permet d'explorer plus de types qui peuvent être pertinents pour votre tâche.

  Remarque : l'utilisation de variables de types définis par le langage utilisé dans le projet en tant que résultats statiques entraîne une erreur de compilation dans les projets Windows et multiplate-forme.

Étendue de variable

La propriété d'étendue donne aux variables un contexte bien défini dans lequel elles peuvent être utilisées. L'étendue peut être définie sur la globalité (disponible dans l'ensemble du projet), sur le fichier de workflow actuel ou sur n'importe quelle activité de conteneur dans le fichier de workflow.

Vous ne pouvez créer des variables globales qu'à partir du gestionnaire de données.

Remarque :

• Les variables globales ne sont pas sérialisables et sont donc incompatibles avec les activités de persistance de longue durée.
• Les variables globales ne sont pas prises en charge dans les projets de bibliothèque.
• Dans les projets C#, l’utilisation d’une variable globale ou d’une constante globale dans les activités nécessite d’appliquer le format suivant : GlobalVariablesNamespace.GlobalVariables.YOUR_GLOBAL_VARIABLE_NAME. Dans les projets VB, vous pouvez référencer directement la variable globale ou la constante globale par son nom.

Créer une variable

À partir du gestionnaire de données

1. Ouvrez le gestionnaire de données, puis sélectionnez Nouveau (New) > Nouvelle variable (New Variable).
2. Indiquez le nom, le type de données, l'étendue et la valeur par défaut de la variable.

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 visible dans le champ. Vérifiez son étendue et saisissez-la dans le panneau Gestionnaire de données (Data Manager).

À 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 saisissez-la dans le panneau Gestionnaire de données (Data Manager).

   
   

   

   
   

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 visible dans le champ. Vérifiez son étendue et saisissez-la dans le panneau Gestionnaire de données (Data Manager).

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).

Variables générées automatiquement à partir des sorties de l'activité (pour les projets Windows et multiplate-forme uniquement)

Si le paramètre de conception Générer automatiquement les sorties d'activité est activé, Studio remplit automatiquement chaque champ Sortie des activités qui génèrent une sortie avec une variable. Vous pouvez ensuite utiliser dans d'autres activités la variable générée en sélectionnant le menu Plus sur le côté droit des champs d'entrée de l'activité, puis Utiliser la variable.

Si vous préférez créer manuellement une variable de sortie, vous pouvez faire cela dans le champ de sortie. Cela aura pour effet de remplacer la variable générée par la variable que vous avez créée. Si vous sélectionnez l'option Effacer la valeur après avoir créé manuellement une variable, la variable générée par défaut sera restaurée.

La variable générée est disponible dans le panneau Variables et dans le Gestionnaire de données (si la variable est utilisée dans une autre activité). Comme pour toute autre variable, vous pouvez modifier le nom, le type de données, l'étendue et la valeur par défaut de la variable générée.

L'étendue de la variable générée dépend de l'emplacement de l'activité dans le workflow (par exemple, l'étendue sera différente si l'activité se trouve dans la séquence principale ou bien à l'intérieur d'une activité Pour chaque). L'étendue de la variable générée sera mise à jour si vous copiez, coupez ou collez l'activité. Renommer une activité n'aura pas d'impact sur la variable générée. Cependant, la suppression d'une activité :

• Efface la valeur de la variable si celle-ci n'est pas utilisée.
• Supprime la variable si la variable est utilisée et qu'un avertissement est affiché dans les activités ayant utilisé la variable en tant qu'entrée.

Supprimer une variable

Vous pouvez supprimer des variables du gestionnaire de données ou du panneau Variables.

À partir du gestionnaire de données

1. Ouvrez le gestionnaire de données, puis développez le nœud *Variables.
2. Cliquez avec le bouton droit sur une variable, puis sélectionnez Supprimer la variable (Delete Variable). Vous pouvez également la sélectionner et appuyer sur la touche Suppr.

Depuis le panneau Variables (Variables)

1. Ouvrez le panneau Variables.

2. Cliquez avec le bouton droit sur une variable, puis sélectionnez Supprimer (Delete). Vous pouvez également la sélectionner et appuyer sur la touche Suppr.

   
   

   

   
   

Suppression de toutes les variables inutilisées

Pour supprimer toutes les variables qui sont définies mais ne sont utilisées nulle part dans le fichier actuel, sélectionnez Supprimer les éléments inutilisés (Remove Unused) > Variables dans le ruban Studio, puis sélectionnez Oui (Yes) lorsque vous êtes invité à confirmer. 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 gestionnaire de données, dans la liste déroulante Type de données (Data Type) d'une variable, sélectionnez Rechercher d'autres types (Browse for Types). Vous pouvez également accéder au menu à partir de la liste déroulante Type de variable (Variable Type) dans le panneau Variables. La fenêtre Parcourir et sélectionner un type .Net (Browse and Select a .Net Type) s'affiche.
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).

Remarque : l'attribution d'un littéral de nombre à virgule flottante (par exemple, 10,5) à une variable ou à un argument de type float (System.Single) entraîne une erreur de compilation lors de l'exécution du workflow. Pour attribuer correctement la valeur, vous pouvez soit :

• Utiliser le suffixe f ou F (1.5f ou 1.5F)
• Utiliser des opérateurs de conversion ((float)1.5 pour C# ou CSng(1.5) pour VB)