Une expression produit généralement un texte. Par exemple, l'expression

"L'auteur du livre " + Book.title + " est " + Book.author + " " correspond au texte "L'auteur du livre Autant en emporte le vent est Margaret Mitchell.", si les variables Book.title et Book.author contiennent respectivement les textes « Autant en emporte le vent » et « Margaret Mitchell ».

Vous pouvez également exécuter des calculs numériques dans l'expression. Par exemple, si la variable Book.price contient le prix d'un livre, vous pouvez le multiplier par 100 en utilisant l'expression suivante :

Book.price * 100

Le tableau suivant présente les types de sous-expressions les plus couramment utilisés. Pour un aperçu complet de tous les types de sous-expressions disponibles, consultez la référence ci-dessous.

Types de sous-expressions couramment utilisés

Notez que vous pouvez spécifier une constante texte en utilisant la notation avec des guillemets, ou la notation >>texte<<, par exemple "Margaret Mitchell" ou >>Margaret Mitchell<<. Si vous utilisez la notation avec des guillemets et que vous souhaitez qu'un caractère guillemet apparaisse dans le texte, vous devez l'écrire comme deux caractères guillemets. Par exemple, écrivez « Ceci est un texte ""cité"" » pour obtenir le texte « Ceci est un texte "cité" ». Si vous utilisez la notation >>texte<<, tout peut apparaître dans le texte, sauf ">>" et "<<". Ainsi, vous pouvez écrire directement des citations, comme dans >>Ceci est un texte "cité"<<. La notation >>texte<< est pratique pour les textes longs qui contiennent un grand nombre de guillemets, tel que HTML.

Le tableau suivant répertorie les fonctions les plus couramment utilisées dans les expressions.

Par exemple, l'expression "La remise est" + round ((Item.oldPrice - Item.newPrice) / Item.oldPrice) + "%". correspond à "La remise est de 10%." lorsque l'ancien prix de l'article est de 99,95 $ et le nouveau prix de 89,95 $.

Référence

Expressions

Type d'expression	Notation	Description	Exemples
Constante	"texte"	Un texte fixe. Vous pouvez utiliser la barre oblique inverse (\) pour entrer des caractères spéciaux : \n pour un saut de ligne \r pour un retour à la ligne \f pour un document formulaire \t pour une tabulation horizontale \b pour un retour arrière \" pour des guillemets doubles \' un guillemet simple \\ pour la barre oblique inverse elle-même \uxxxx pour le caractère Unicode avec xxxx codé, où xxxx correspond à quatre chiffres hexadécimaux.	« Ceci est un texte \"cité\". » "C'est un texte avec un saut de ligne\n, une tabulation \t et un caractère unicode \u0035"
Constante	>>texte<<	Un texte fixe. Cette notation peut contenir n'importe quoi, y compris des guillemets, sauf le symbole de fin (<<). La barre oblique inverse (\) ne peut pas être utilisée pour entrer des caractères spéciaux.	>>Il s'agit d'un texte "cité".<<
Variables	variable.attribute variable	Valeur d'une variable Si la variable est de type complexe, un nom d'attribut doit être également fourni.	Book.title + Entier
Saisir du texte	ENTRÉE	Le texte d'entrée, le cas échéant, dans l'expression.	ENTRÉE
Concaténation	expr1 + expr2	La concaténation des deux expressions expr1 et expr2.	"Title:" + Book.title
Correspondance de sous-expression rationnelle	$n	Si n > 0, le texte qui correspond à la sous-expression rationnelle n dans l'expression rationnelle. Si n = 0, le texte qui correspond à l'ensemble de l'expression rationnelle. Remarque : Cette expression n'a de sens que s'il existe une expression rationnelle associée à l'expression.	$1 Pour obtenir plus d'informations, voir Expressions rationnelles et Expérimenter les expressions.
Expression numérique	Opérateurs : +, -, *, /, %	Le résultat d'une expression numérique.	Book.price * 100
Expression booléenne	Opérateurs : && (et), || (ou)	Le résultat d'une expression booléenne.	performTransactions && Book.price < 30
Expression conditionnelle	condition ? expr1 : expr2	Si la condition donne true, la valeur de expr1 est utilisée ; sinon, la valeur de expr2 est utilisée.	Book.price < 30 ? "bon marché" : "cher"
Égalité	Opérateurs : == (égal à), != (différent de)	Ces opérateurs fonctionnent sur des opérandes de tous types, mais le type des opérandes doit être le même. Par exemple, vous ne pouvez pas comparer un nombre à un entier.	true == false style != "none"
Relationnel	Opérateurs : < (inférieur à), <= (inférieur ou égal à), > (supérieur à), >= (supérieur ou égal à)	Les opérateurs relationnels déterminent si un opérande est inférieur ou supérieur à un autre opérande. Les opérandes doivent être des nombres, c'est-à-dire de type Entier ou Nombre. Les types d'opérandes dans une expression doivent être les mêmes.	0 < 1 1.0 >= 0.0
Fonction	func(expr)	La fonction func appliquée au résultat de l'expression expr. Consultez la section Fonctions qui suit ce tableau pour les fonctions disponibles.	capitalize(Book.title)
URL actuelle	URL	L'URL actuelle.	URL
Fenêtre actuelle	FENÊTRE	L'ID unique de la fenêtre actuelle.	FENÊTRE
Nom du robot	Robot.name	Le nom du robot.	Robot.name
ID d'exécution	Robot.executionId	ID d'exécution actuel du robot.	Robot.executionId
Erreurs d'exécution	Robot.executionErrors	Les erreurs d'exécution rencontrées dans la branche précédente de l'Étape de tentative la plus proche. Cette expression peut être utilisée dans la deuxième branche et toutes les branches suivantes de l'étape Tentative.	Robot.executionErrors

Fonctions

Fonction	Description
abs(arg)	Renvoie la valeur absolue du nombre.
base64Decode(arg)	Décode les données codées en base 64.
base64Encode(arg)	Code les données binaires avec le codage en base 64.
binaryToText(data[, encoding])	Décode les données binaires en texte. Utilise le codage spécifié s'il est présent, ou utilise par défaut le codage UTF-8.
capitalize(arg)	La première lettre de chaque mot est en majuscule et toutes les autres lettres sont en minuscule.
ceil(arg)	Arrondit le nombre au nombre entier le plus proche.
collapseSpaces(arg)	Vérifie qu'il n'existe pas deux espaces consécutifs.
contains(source, key)	Renvoie si la source contient la clé spécifiée.
date()	Renvoie la date du jour au format standard (aaaa-mm-jj).
day(args)	Renvoie le jour du mois de la date donnée comme argument.
endsWith(source, key)	Retourne true si la chaîne source se termine par la clé spécifiée, ou sinon false.
floor(arg)	Arrondit le nombre au nombre entier inférieur le plus proche.
guid()	Renvoie un ID (GUID) globalement unique généré de manière aléatoire.
hexDecode(arg)	Décode les données codées en hexadécimal.
hexEncode(arg)	Code les données binaires avec un codage hexadécimal.
indexOf(source, clé)	Renvoie le premier index de la clé dans la source, ou -1 si non trouvé.
length(arg)	Compte le nombre de caractères dans le texte, ou le nombre d'octets s'il s'agit de données binaires.
max(a, b)	Renvoie le plus grand des deux nombres.
md5(arg)	Calcule la somme de contrôle MD5 des données binaires données en argument.
min(a, b)	Renvoie le plus petit des deux nombres.
month(args)	Renvoie le mois de la date donnée comme argument.
now()	Renvoie la date et l'heure actuelles.
random()	Renvoie un nombre aléatoire entre 0 et 1.
removeSpaces(args)	Supprime tous les caractères d'espacement dans l'argument, tels que SPACE, \t, \n.
replacePattern(source, pattern, newText)	Remplace chaque occurrence de l'expression rationnelle "expression rationnelle" dans le texte "source" par le texte "newText". La correspondance d'expression rationnelle n'est pas sensible à la casse.
replaceText(source, oldText, newText)	Remplace chaque occurrence du texte "oldText" dans le texte "source" par le texte "newText". La correspondance avec "oldText" n'est pas sensible à la casse.
resolveURL(arg)	Convertit une URL relative en URL absolue en utilisant l'URL actuelle.
round(arg)	Arrondit à l'entier le plus proche.
shortTime(arg)	Retourne l'heure sans fraction de seconde (hh:mm:ss) pour la date donnée en argument.
substring(source, startIndex)	Renvoie la partie de la chaîne source commençant à l'index de début et allant jusqu'à la fin de la chaîne source, le premier caractère de la chaîne étant à l'index 0.
substring(source, startIndex, endIndex)	Renvoie la partie de la chaîne source commençant à l'index de début et allant jusqu'à l'index de fin, le premier caractère de la chaîne étant à l'index 0.
startsWith(source, key)	Retourne true si la chaîne source commence par la clé spécifiée, ou sinon false.
textToBinary(text[, encoding])	Code le texte en données binaires. Utilise le codage spécifié s'il est présent, ou utilise par défaut le codage UTF-8.
time(arg)	Renvoie l'heure (hh:mm:ss.fff) de la date donnée en argument.
toInteger(args)	Convertit le texte en un nombre entier. Cela peut être utile si vous voulez l'inclure dans les calculs.
toNumber(args)	Convertit le texte en un nombre en virgule flottante. Cela peut être utile si vous voulez l'inclure dans les calculs.
toLowerCase(arg)	Convertit tous les caractères du texte en minuscules.
toUpperCase(arg)	Convertit tous les caractères du texte en majuscules.
trim(arg)	Supprime tout l'espace aux deux extrémités du texte.
urlDecode(arg)	Décode le texte codé de l'URL.
urlEncode(arg)	L'URL code le texte.
weekday(arg)	Retourne le nom du jour de la semaine (en anglais) de la date donnée en argument.
year(args)	Renvoie l'année de la date donnée comme argument.
toColumn(arg)	Convertit les nombres entiers en texte de colonne Excel.
toIndex(arg)	Convertit le texte des colonnes Excel en nombre entier.
itération(arg)	Contient le numéro d'itération actuel.

Seules les expressions qui renvoient des valeurs de type Texte peuvent être utilisées dans les convertisseurs. Pour plus d'informations, voir Convertisseurs de données.