Expressions
Les informations sur cette page d’aide concernent à la fois Studio et Desktop Studio.
Une expression est tout ce qui, dans votre script, compare une valeur ou aboutit à une valeur. Par exemple,
Chacun des exemples précédents pourrait également être une instruction d'affectation. Une instruction d'affectation affecte la valeur située à droite du signe égal à la variable située à gauche. Les affectations de Variable ne sont pas des expressions.
Les expressions peuvent être utilisées pour :
- Effectuer des calculs mathématiques ou algébriques.
- Comparer deux valeurs et prendre une mesure en fonction du résultat de la comparaison.
- Prendre des décisions logiques en se basant sur le fait qu'une expression est évaluée comme vraie ou fausse.
Les valeurs comparées dans une expression peuvent être composées de lettres, de nombres ou d'une combinaison des deux. Elles peuvent également inclure des variables. Dans Studio, il existe trois types d'expressions : numérique, chaîne, et booléenne.
Réessayez
Téléchargez le script d'exemples d'expressions et importez-le dans Studio. Les exemples de cette page d'aide sont disponibles dans les actions
Expressions numériques
Les expressions numériques comprennent uniquement des chiffres et des opérateurs mathématiques ou booléens, tels que +, -, etc. Elles peuvent également inclure des références de variables, si les variables contiennent des valeurs numériques utilisées dans les calculs.
Les expressions numériques sont utilisées dans les extraits et pour configurer les propriétés des actions Studio. Par exemple, dans l'action IF, vous configurez la propriété Expression avec une expression qui sera évaluée comme mécanisme de prise de décision de l'action. Vous pouvez faire la même chose dans un extrait à l'aide du mot-clé
Syntaxe des expressions numérique
A data type that has two possible values: true and false.. Si vous placez une expression numérique entre guillemets, elle est traitée comme du texte. Par exemple, c1 = 123 + 456 donne 579, mais
c2 = "123 + 456" donne 123 + 456.
Ne mettez pas entre accolades et guillemets doubles les variables utilisées dans les expressions numériques. Ceci produirait une erreur dans votre script.
Évaluation des expressions Numériques
Dans une expression numérique, si le script peut évaluer les valeurs numériques en tant que nombres, il le fait. Cela signifie que :
- Tout ce qui ne peut pas être évalué comme une valeur numérique, comme des lettres ou un mot, est considéré comme une référence Variable.
- Si les caractères non numérique de l'expression sont une Variable du script avec une valeur de chaîne, le script ignore les caractères non numérique et évalue la partie numérique de l'expression originale.
- Si les caractères non numériques de l'expression sont une Variable avec une valeur numérique, le script inclut cette valeur dans l'évaluation de l'expression.
- Si les caractères non numérique de l'expression ne sont pas une variable du script, le script ignore ces caractères dans l'expression d'origine.
Dans l'exemple suivant, le script tente d'évaluer nextNum en tant que variable parce qu'il ne peut pas être évalué en tant que nombre : c1 = 123 + 456 + nextNum. Les exemples suivants présentent le résultat de trois scénarios selon que nextNum est une variable ou non, et selon sa valeur.
Lorsque nextNum est une variable avec une valeur de chaîne, le résultat est c1 = 579 :
ASSIGN nextNum = "my string"
ASSIGN c2 = 123 + 456 + nextNum
Lorsque nextNum est une variable avec une valeur numérique, le résultat est c2 = 1368 :
ASSIGN nextNum = 789
ASSIGN c3 = 123 + 456 + nextNum
Lorsque nextNum n'est pas une variable, le résultat est c3 = 579 :
ASSIGN c3 = 123 + 456 + nextNum
Si vous évaluez une expression qui comprend deux variables qui contiennent toutes les deux des nombres traités comme des valeurs de chaîne, le script convertit les valeurs en nombres et les évalue en conséquence. Le résultat de l'exemple suivant est c4 = 50 :
ASSIGN nextNum = "20"
ASSIGN otherNum = "30"
ASSIGN c4 = nextNum + otherNum
Vous pouvez inclure des expressions numériques dans des valeurs de chaîne en plaçant l'expression entre accolades. Par exemple :
ASSIGN nextNum = 6
ASSIGN otherNum = 7
ASSIGN c5 = "There are {nextNum + otherNum} fish in the aquarium."
Nombres avec zéros initiaux
Il existe une différence dans la manière dont Studio gère les nombres lorsqu'ils sont traités comme des chaînes de caractères et lorsqu'ils sont traités comme des nombres. Lorsque les nombres sont traités comme une chaîne, ils peuvent comporter des zéros initiaux. Si vous additionnez deux variables contenant des valeurs de chaîne numérique avec des zéros non significatifs, ces zéros non significatifs sont supprimés. Par exemple, le résultat de l'expression suivante est c6=59 :
ASSIGN nextNum = "00020"
ASSIGN otherNum = "000039"
ASSIGN c6 = nextNum+otherNum
Si vous avez besoin que la valeur résultante comporte des zéros non significatifs, vous pouvez utiliser la
Expressions de chaîne
Les expressions de chaîne incluent des caractères alphanumériques et spéciaux, tels que #, @, et ainsi de suite. La syntaxe des expressions de chaînes de caractères est similaire à la syntaxe d'affectation de valeurs de chaînes à des variables :
- Dans les snippets, les valeurs des expressions doivent toujours être placées entre guillemets simples ou doubles. C'est la même chose que pour les valeurs de chaîne
- Pour effectuer une substitution de variable dans les expressions de chaîne, placez le nom DE variable entre accolades.
- Certains caractères, tels que les guillemets, sont considérés comme du code. Pour inclure ces caractères dans des valeurs de chaîne, vous devez utiliser des séquences d'échappement.
Comparaisons de chaînes
Les chaînes de caractères peuvent être évaluées en tant que valeurs dans des expressions booléennes. Par exemple, vous pouvez utiliser l'expression suivante dans une instruction
customer = "Grendel Cainson"
Lorsque customer contient exactement la valeur Grendel Cainson, le résultat est true. Pour toute autre valeur, le résultat est false.
Vous pouvez utiliser les opérateurs « plus grand que » et « plus petit que » dans les comparaisons de chaînes de caractères. Dans ce type de comparaison, une valeur est attribuée à chaque caractère alphabétique (A = 1 et Z = 26). Le script commence par comparer le premier caractère. S’ils sont différents, celui qui commence par une lettre plus éloignée dans l'alphabet est plus grand. Par exemple, dans la comparaison apple > banana, le résultat est faux. Ceci s'explique par le fait que
Si les premiers caractères sont identiques, le script compare les seconds caractères. S’ils sont différents, la comparaison s'arrête là. Si les deuxièmes caractères sont identiques, le script continue à comparer les caractères jusqu'à ce qu'il atteigne une paire de caractères différents. Par exemple, dans la comparaison de grapes > grapey, le script compare chaque caractère jusqu'à la fin. Le résultat est false, car
Dans les comparaisons supérieur ou égal à ou inférieur ou égal à, les mêmes règles s'appliquent. Si les scripts trouvent que la chaîne du côté gauche de l'opérateur est la même que celle du côté droit, l'expression est évaluée à vrai.
Les comparaisons de chaînes sont sensibles à la casse.
Séquences d'échappement dans les chaînes
Studio prend en charge les séquences d'échappement dans les constantes de chaîne. Les séquences d'échappement permettent d'inclure certains caractères spéciaux dans une chaîne. Les Caractères tels que les guillemets doubles ou une accolade ouvrante sont reconnus comme du code. Lorsqu'ils sont inclus dans une chaîne, le compilateur les interprète avec la signification non littérale du code au lieu de leur valeur littérale. Les séquences d'échappement permettent d'inclure ces caractères dans des chaînes.Si vous incluez ces caractères dans des chaînes sans séquence d'échappement, la sortie ne correspondra pas à ce que vous attendez, et une erreur peut en résulter.
Il n'est pas nécessaire d'ajouter des séquences d'échappement aux chaînes qui contiennent du XML ou du JSON converti. Les séquences d'échappement sont automatiquement ajoutées pour les caractères qui le nécessitent.
Prefix any string where you use an escape sequence with a dollar sign ($): $"...". Within the double quotes, you can use any of the following escape sequences:
| Séquence | Détails |
|---|---|
|
|
Intégrez un guillemet double. |
|
|
Intégrez une citation unique. |
|
|
Permet d'intégrer une tabulation (ASCII 9). |
|
|
Permet d'intégrer un retour chariot (ASCII 13). |
|
|
Permet d'intégrer un saut de ligne (ASCII 10). |
|
|
Permet d'intégrer un retour arrière (ASCII 8). |
|
|
Intégrez une accolade ouverte. Vous ne devez utiliser une séquence d’échappement devant l'accolade fermante que si le texte qui la précède ne contient pas d'accolade ouverte avec séquence d’échappement. Si vous devez échapper une accolade fermante, cela ressemble à ceci : |
|
|
Intégrez un null (0 est un zéro). |
L'exemple suivant utilise la séquence d'échappement \n pour ajouter un saut de ligne à la chaîne. Cela permet de déplacer le curseur vers la ligne suivante sans revenir au début de la ligne.
x = $"A phrase\nAnd a new line"
Lorsque la chaîne est imprimée, la sortie ressemble à ceci :
phrase
Et une nouvelle ligne ]
Dans l'exemple précédent, le crochet fermant représente le curseur.
L'exemple suivant utilise la séquence d'échappement \" pour inclure des guillemets doubles dans la chaîne :
y = $"Embedding \"double quotes\" in a string."
Lorsque la chaîne est imprimée, elle ressemble à ceci : intégration de « guillemets doubles » dans une chaîne. Sans la séquence d'échappement, le script ne reconnaîtrait la chaîne que jusqu'au symbole de guillemet double précédant le mot double.
L'exemple suivant utilise la séquence d'échappement \{ pour inclure des accolades littérales dans la chaîne :
z = $"Using \{curly} braces."
Lorsque la chaîne est imprimée, elle ressemble à ceci : utilisation des accolades {curly}. Sans la séquence d'échappement, le script aurait interprété
Expressions booléennes
Studio prend en charge l'utilisation d'expressions Booléennes
A data type that has two possible values: true and false.. Elles peuvent être utilisées pour créer une logique de prise de décision dans votre script. Comme les expressions booléennes sont évaluées à « vrai » ou « faux », vous pouvez les utiliser pour créer des conditions qui doivent être remplies pour décider de la voie à suivre. Si la condition est remplie, le script suit cette branche, mais si elle ne l'est pas, il suit l'autre.
Il existe un certain nombre d'opérateurs que vous pouvez utiliser dans les expressions booléennes. Cela vous permet de définir une condition logique qui répond aux besoins de votre script. Par exemple, vous pouvez vérifier si une valeur est identique à une autre en utilisant le signe égal (=) ou vous pouvez vérifier si une valeur est supérieure à une autre en utilisant l'opérateur supérieur à (>).
Vous pouvez utiliser des expressions booléennes avec des actions telles que If et Snippet. Un certain nombre d'instructions que vous pouvez utiliser dans les Extraits utilisent des expressions booléennes comme mécanisme de prise de décision, notamment :
- IF
- IF ... ELSE
- SELECT
L'exemple suivant montre l'utilisation d'une expression booléenne avec une instruction
ASSIGN var1 = "Cat"
IF var1 = "Dog"
{
ASSIGN dogWasFound = true
}
ELSE
{
ASSIGN dogWasFound = false
}
Les expressions booléennes peuvent également être utilisées dans le scripting avec des actions. L'image suivante montre la même instruction
Valeurs booléennes pour activer ou désactiver des Paramètres
Les valeurs booléennes sont parfois utilisées dans les Scripts pour activer ou désactiver des paramètres dans NiCE CXone. Dans ces cas, vous attribuez une valeur booléenne à une variable. Pour activer un paramètre, attribuez la valeur vrai ou 1. Pour désactiver un paramètre, attribuez la valeur faux ou 0.
Les mots et les nombres sont des valeurs booléennes valides. Toutefois, consultez l'aide en ligne de l'action Studio que vous utilisez pour voir s'il existe une valeur préférée pour les propriétés de l'action. Dans les deux cas, la valeur utilisée ne doit pas être entre guillemets. Si vous placez la valeur entre guillemets, le script la traite comme une chaîne littérale et non comme une valeur booléenne.
Les opérateurs
Un opérateur est un symbole qui représente une opération mathématique ou une comparaison. Les symboles tels que +, - et = sont des opérateurs. Les opérateurs booléens comparent deux expressions et produisent une réponse vraie/fausse. Snippet prend en charge les opérateurs mathématiques et les opérateurs booléens.
Outre les opérateurs mathématiques classiques pour la multiplication, la division, l'addition et la soustraction, vous pouvez également utiliser les opérateurs suivants :
- Opérateur modulo (%)
- Puissance/exposant (^)
- Entier divide (\)
- OU exclusif (~)
L'ordre mathématique normal des opérations s'applique à toutes les expressions. Tout ce qui se trouve entre parenthèses est d'abord évalué en tant que sous-unité. Les opérateurs d’exposant/de puissance sont évalués en second lieu. La multiplication et la division sont évaluées ensuite, suivies de l'addition et la soustraction. Les opérateurs de comparaison sont les derniers à être évalués, après que toutes les opérations mathématiques ont été effectuées.
Opérateurs booléens
Vous pouvez utiliser les opérateurs booléens suivants dans les snippets. Tous ces opérateurs peuvent être utilisés avec
| Opérateur SYMBOL | Nom DE L'OPÉRATEUR | Détails |
|---|---|---|
| = | Égal | Si les deux côtés de l'expression sont équivalents, le résultat de l'expression est |
| != | Pas égal | Si les deux côtés de l'expression ne sont pas équivalents, l'expression est évaluée à |
| > | Supérieur |
Si le côté droit de l'expression est inférieur au côté gauche, l'expression a pour résultat |
| >= | Supérieur ou égal |
Si le côté droit de l'expression est inférieur ou égal au côté gauche, l'expression donne |
| < | Inférieur à |
Si le côté gauche de l'expression est inférieur au côté droit, l'expression a pour résultat |
| <= | Inférieur ou égal |
Si le côté gauche de l'expression est inférieur ou égal au côté droit, l'expression a pour résultat |
| & | et | Si toutes les sous-expressions sont évaluées à vrai, l'expression entière donne pour résultat |
| | | ou | Si l'une ou l'autre des sous-expressions est évaluée comme vraie, l'expression a pour résultat |
Signes « égal » dans les expressions
L'opérateur de signe égal ( = ) a des significations différentes selon le type d'expression avec lequel vous travaillez.
Les expressions utilisées dans les instructions d'affectation attribuent une expression comme valeur d'une Variable. Le signe égal utilisé dans ces instructions affecte la valeur située à droite de l'expression à la variable située à gauche.
Dans d'autres expressions, le signe égal indique l'évaluation d'une égalité. Par exemple, dans l'expression algébrique x = 3 * (5 + 10), le signe égal signifie que x représente la valeur résultant de l'expression algébrique 3 * (5 + 10). Dans ce cas, x = 45. Vous pouvez utiliser cette expression algébrique dans une instruction d'affectation pour affecter la valeur de l'expression à une variable x. Toutefois, si la même expression était utilisée comme valeur booléenne, elle serait évaluée comme vraie ou fausse selon la valeur de x.
Les expressions booléennes sont couramment utilisées dans les scripts Studio. Si vous utilisez un signe égal comme opérateur dans ces expressions, il compare la valeur à gauche du signe égal à la valeur à droite pour déterminer l'égalité. Si vous devez modifier la valeur d'une variable utilisée dans une expression booléenne, utilisez soit une action ASSIGN, soit une instruction ASSIGN dans une action Extrait.