Vos variables (définies par l'utilisateur)

Les utilisateurs et certaines actions créent des variables définies par l'utilisateur pour stocker temporairement des valeurs. Utilisez ce type de variable pour saisir des valeurs dans une action (titre de la fenêtre, informations d'identification de connexion ou chemin de fichier), ou pour accepter le résultat d'une action (valeurs lues à partir d'un fichier ou renvoi d'une valeur booléenne).

Lorsque vous construisez des tâches automatisées, certaines actions doivent se référer à certaines valeurs et les utiliser, et ces valeurs peuvent être stockées dans des variables. Les variables peuvent vous aider de différentes manières, de la récupération de données en ligne au transfert de données entre applications, par exemple Microsoft Excel. Une variable peut contenir une ou plusieurs valeurs. Les valeurs qu'une variable peut contenir et les opérations qui peuvent être effectuées sur la variable sont déterminées par son type de données.
Remarque :
  • Un robot ne peut renvoyer qu'un maximum de 3 Mo à une variable de sortie. En outre, la structure du tableau dans BotOutputVariable est limitée à 300 000 cellules.

    Si vous insérez plus de 300 000 cellules, un message d'erreur s'affiche, indiquant que la variable debug est trop volumineuse pour être déboguée ou que la variable BotOutputVariable est trop volumineuse pour être traitée.

    Solution de contournement : enregistrez la sortie du robot sur le périphérique, par exemple dans un fichier .txt. Si la sortie doit être partagée entre plusieurs Bot Runners, enregistrez-la dans un lecteur partagé.

  • La taille des variables d'entrée des robots est limitée à 1 900 000 octets. Nous vous recommandons d'utiliser le fichier .txt pour stocker un grand ensemble de données.

Types de variables

Le type de données d'une variable est un attribut qui détermine le type de données que la valeur stockée dans la variable peut avoir. Les types de données comprennent les classifications de stockage, telles que les entiers, les chaînes et les caractères. Les variables telles que dictionnaire, enregistrement, liste ou tableau peuvent contenir plusieurs types de données.

La plupart des types de variables possèdent un package avec un nom similaire, qui contient des actions servant à effectuer des opérations sur les valeurs stockées dans la variable. Par exemple, utilisez les actions du package Chaîne pour utiliser des variables de chaîne. De même, pour utiliser des variables numériques, utilisez les actions du package Nombre. Pour convertir la valeur d'un type de variable en un autre, consultez la rubrique Conversion de type

Vous pouvez également réutiliser des valeurs identiques avec différents robots au lieu de créer de nouvelles variables pour chaque robot. Reportez-vous à la rubrique Valeurs globales.

Attribution d'un nom aux variables

Un nom de variable peut contenir un maximum de 50 caractères Unicode, y compris des chiffres (0-9), des lettres latines (A-Z, a-z) et des caractères spéciaux (- et _). Vous pouvez utiliser des caractères à deux octets, tels que des caractères chinois, japonais ou coréens, dans un nom de variable. Plage Unicode prise en charge dans les variables

Nous recommandons d'utiliser des majuscules pour les noms de variables et de préfixer le nom de la variable pour indiquer la portée et le type de données. Par exemple, iFileEmailAttachment pour une variable de type de fichier qui est utilisée pour fournir une entrée.
Remarque : Suivez cette convention d'affectation de noms recommandée pour les variables : <type/scope indicator><data type><Variable name>. Bien qu'il existe de nombreuses options de convention d'affectation de noms, certaines doivent être adoptées et utilisées de manière cohérente au sein de l'organisation.

<type/scope indicator> est un caractère unique, comme suit :

  • p = variable locale (ni entrée ni sortie)
  • i = variable d'entrée
  • o = variable de sortie
  • io = variable d'entrée et de sortie
  • c = constante
Voici quelques autres exemples de noms de variables.
  • iStrAuditLogPath : variable de type chaîne reçue d'une tâche appelante
  • oNumReturnValue  : variable de type nombre renvoyée à une tâche appelante
  • ioStrStatus : chaîne à la fois reçue d'une tâche appelante et renvoyée par celle-ci
  • cStrNull : chaîne qui ne contient aucune valeur ; utile notamment pour les comparaisons de chaînes afin de vérifier la présence d'une valeur

Pour plus d'informations sur la portée, consultez la rubrique Robot de tâches package. Ce standard vous permet de rechercher des variables par type. Par exemple, oStr renvoie les variables qui sont utilisées pour contenir les valeurs des chaînes de sortie.

Types de variables

Type de variable et nom suggéré Description Exemples d'utilisation
N'importe lequel

Any

Stocke les types de données Booléen, Tableau de données, Date/heure, Fichier, Chiffre, Enregistrement, Chaîne ou Fenêtre. Utilisez ce type de variable lorsque vous n'êtes pas certain du type de données qu'une action va générer. Exemple d'utilisation de l'action Exécuter
Booléen

Bool

Stocke une valeur Vrai ou Faux.
Information d'identification

Cred

Stocke les valeurs de chaîne en toute sécurité, empêchant l'affichage des valeurs dans une zone de message ou leur écriture dans un fichier. La valeur est sélectionnée à partir du Credential Vault ou fournie par l'utilisateur.

Informations d'identification et variables d'informations d'identification dans l'Éditeur de robots

DateTime

Date

Stocke une valeur contenant une seule valeur de date et heure. Vous pouvez formater les valeurs en sélectionnant un format prédéfini ou en spécifiant un format personnalisé.

Formats de date/heure

Dictionnaire

Dict

Stocke les données sous forme de paires de valeur-clé. La valeur peut être de type booléen, numérique ou de chaîne.

package Dictionnaire

Fichier

File

Stocke un chemin de fichier.

Exemple d'utilisation d'une variable de fichier

Formulaire

Form

Stocke la valeur saisie dans un champ de formulaire interactif.

Utilisation de formulaires interactifs

Liste

List

Stocke une séquence de valeurs booléennes, numériques ou de chaîne.

Liste package

Nombre

Num

Stocke les valeurs numériques, y compris les nombres entiers et décimaux. Elle contient des valeurs comprises entre -9 223 372 036 854 775 808 et 9 223 372 036 854 775 807, et jusqu'à 15 décimales.

Vous pouvez attribuer une valeur générée de manière aléatoire à cette variable.

action Nombre aléatoire

Vous pouvez supprimer les chiffres après une décimale lors de la conversion de la valeur en chaîne.

Action de conversion d'un nombre en chaîne

Enregistrement

Rec

Stocke une rangée unique de valeurs extraites d'un tableau. Les valeurs peuvent être de type booléen, numérique ou de chaîne.

Variable d'enregistrement

Exemple de saisie de données dans un formulaire Web à partir d'une feuille de calcul
Session

Sess

Stocke le nom de session à partir des packages Bases d'Excel, Excel avancé ou Émulateur de terminal. Transmettez cette variable d'un robot parent à un enfant dans l'action Robot de tâches > Exécuter pour permettre au robot enfant de traiter les données dans le fichier ouvert dans le robot parent.
Remarque : Lors de l'initialisation de cette variable dans le robot enfant, sélectionnez Utiliser comme entrée.
Exemple de partage d'une session Excel entre robots
Chaîne

Str

Stocke des valeurs alphanumériques, des caractères spéciaux et des valeurs vides. Elle peut contenir jusqu'à 65 535 caractères UTF-8. Une variable de chaîne peut contenir plusieurs lignes de texte. Vous pouvez comparer la valeur d'une variable de chaîne à une variable de chaîne vide.

Exemple d'utilisation d'une instruction conditionnelle

Tableau

Table

Stocke plusieurs valeurs dans un tableau de lignes et de colonnes. Les valeurs peuvent être de type booléen, numérique ou de chaîne. Affectez des valeurs à une variable de tableau en extrayant des valeurs d'un fichier CSV/TXT, d'un fichier Excel ou d'un formulaire Web.
Fenêtre

Win

Stocke un titre de fenêtre et une URL.

Lorsque vous créez une variable de type Fenêtre, notez que le fait de sélectionner Navigateur comme valeur par défaut ne prend en charge que les onglets Google Chrome, tandis que la sélection de la variable Application comme valeur par défaut prend en charge toute fenêtre d'application.

Certaines actions, comme l'action Capturer, créent une variable de fenêtre pour stocker le titre de la fenêtre et l'URL spécifiés.

Exemple d'extraction de données d'un tableau Web

Comportement des variables de fenêtre

Lorsque vous utilisez Enregistreur pour automatiser une fenêtre spécifique, par exemple la fenêtre 1, que vous effectuez une action Cliquer sur la fenêtre et que vous exécutez le robot, le robot recherche pour la première fois cette fenêtre spécifique, lui attribue un identificateur et l'enregistre dans la mémoire cache. Lorsque vous exécutez une deuxième action Cliquer sur la même fenêtre 1, le robot vérifie si la fenêtre 1 est active. Si la fenêtre 1 est active, le robot ne doit plus rechercher la fenêtre spécifique, car celle-ci est déjà enregistrée dans le cache, et il la récupère automatiquement. Cela améliore les performances du robot et permet de gagner du temps, car le robot ne doit pas systématiquement rechercher la fenêtre si elle est déjà disponible.

Supposons que vous exécutiez une troisième action Cliquer sur la même fenêtre 1, qui s'ouvre sur une autre page car le titre de la fenêtre a changé. Par exemple, si vous ouvrez une page Web Yahoo Inde et exécutez une action Cliquer sur l'option Actualités de la page Web, l'action vous dirige vers une autre page qui modifie le titre de la fenêtre.

Ainsi, dans ce cas, lorsque vous exécutez le robot, le robot récupère toujours la même fenêtre enregistrée dans le cache et exécute l'action sur cette fenêtre, car celle-ci est toujours la même (seul le titre a changé). Par conséquent, ce comportement offre une bonne expérience à l'utilisateur. De plus, vous pouvez éviter de créer plusieurs variables de fenêtre pour chaque fenêtre dont le titre change lors de l'automatisation de pages Web.

Suppression de variables

Vous pouvez supprimer les variables créées par l'utilisateur de l'une des manières suivantes :
  • Supprimer une variable : Dans la palette Variables, cliquez sur l'ellipse verticale à droite du nom de la variable et cliquez sur Supprimer la variable.
  • Supprimer les variables inutilisées : Dans la palette Variables, cliquez sur Supprimer les variables inutilisées, sélectionnez les variables à supprimer, puis cliquez sur Supprimer.