Vos variables (définies par l'utilisateur)
- Dernière mise à jour2023/09/11
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).
- Un bot 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 bot 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 String pour utiliser des variables de chaîne. De même, pour utiliser des variables numériques, utilisez les actions du package Number. Pour convertir la valeur d'un type de variable en un autre, consultez la rubrique Conversion de typeVous pouvez également réutiliser des valeurs identiques avec différents bots au lieu de créer de nouvelles variables pour chaque bot. 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
iFileEmailAttachment pour une variable de type de fichier qui est utilisée pour fournir une entrée.<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
-
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 Task Bot 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'Bot editor |
|
| 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é. |
| 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. | |
| Fichier File |
Stocke un chemin de fichier. | |
| Formulaire Form |
Stocke la valeur saisie dans un champ de formulaire interactif. | |
| Liste List |
Stocke une séquence de valeurs booléennes, numériques ou de chaîne. | |
| 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. |
Vous pouvez supprimer les chiffres après une décimale lors de la conversion de la valeur 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. | 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
Excel basic, Excel advanced ou Terminal Emulator. Transmettez cette variable d'un bot parent à un enfant dans l'action
pour permettre au bot enfant de traiter les données dans le fichier ouvert dans le bot parent. Remarque : Lors de l'initialisation de cette variable dans le bot enfant, sélectionnez Utiliser comme entrée.
|
Exemple de partage d'une session Excel entre bots |
| 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. |
| 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. |
Comportement des variables de fenêtre
Lorsque vous utilisez Recorder 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 bot, le bot 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 bot vérifie si la fenêtre 1 est active. Si la fenêtre 1 est active, le bot 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 bot et permet de gagner du temps, car le bot 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 bot, le bot 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
- 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.