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.
Types de variable
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 utilisées pour effectuer des opérations sur les valeurs stockées dans la variable. Par exemple, utilisez les actions du package Stringpour travailler sur des variables de chaîne. De même, pour travailler sur des variables numériques, utilisez les actions du packageNumber. Pour convertir la valeur d'un type de variable en un autre, consultez la rubrique Conversion de typeNommage des 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.
iStrAuditLogPath
: une variable de type chaîne reçue d'une tâche appelanteoNumReturnValue
: une variable de type nombre retournée à une tâche appelanteioStrStatus
: une chaîne qui est à la fois reçue et retournée à une tâche appelantecStrNull
: une chaîne qui ne contient aucune valeur ; par exemple, utile pour les comparaisons de chaînes afin de vérifier si une valeur est présente
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 variable
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, Numérique, 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 émettra. | 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 les valeurs d’être affichées dans une zone de message ou écrites dans un fichier. La valeur est soit sélectionnée à partir du Credential Vault , soit 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 valeurs clés. 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 Liste |
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. 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 une chaîne. |
Enregistrer Rec |
Stocke une seule rangée de valeurs extraites d’un tableau. Les valeurs peuvent être de type booléen, numérique ou chaîne. | Exemple d’entrée 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 des robots |
Chaîne Str |
Stocke des valeurs alphanumériques, des caractères spéciaux et des valeurs vides. Elle peut contenir jusqu’à 65535 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 de type de chaîne ou numérique dans un tableau avec lignes et colonnes. Les valeurs peuvent être de type booléen, numérique ou 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. |
Supprimer la variable
- 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.