Écriture d'expressions
Vous pouvez écrire des expressions pour indiquer des valeurs indépendantes ou dérivées des valeurs collectées par étapes ou stockées dans des variables de session. Vous pouvez utiliser une expression pour définir une condition d'étape ou la valeur d'une variable de session.
Utiliser une expression dans une condition d'étape
Vous pouvez utiliser une expression dans une condition d'étape si vous souhaitez conditionner une étape sur le résultat d'un calcul basé sur les informations que vous avez collectées au cours de la conversation.
Par exemple, supposons qu’un client dispose de 200 $ sur un compte d’épargne et souhaite en transférer 150 $ vers un nouveau compte courant. Les frais de transfert de fonds sont de 3 USD et la banque facture des frais lorsqu'un compte épargne contient moins de 50 USD. Vous pouvez créer une étape avec une condition d'étape qui vérifie cette situation. La condition d'étape utiliserait une expression comme celle-ci :
${savings} - (${Step_232} + ${transfer_fee}) < 50
où :
${savings}représente une variable de session qui stocke le solde total du compte épargne du client.${Step_232}représente l'étape qui demande le montant que le client souhaite transférer.${transfer_fee}représente une variable de session qui indique le montant des frais de transfert de fonds.
Si la condition de l'étape est remplie, l'étape avertit l'utilisateur que le transfert demandé fera passer le solde du compte d'épargne en dessous du minimum de 50 $ et engendrera des frais, et demandera confirmation avant de continuer.
Pour utiliser une expression dans une condition d'étape, procédez comme suit:
-
Dans l'étape, cliquez sur Add condition.
Une condition est générée automatiquement avec le choix le plus probable, qui est généralement toutes les variables définies à l'étape précédente.
-
Cliquez sur le premier segment de la condition générée, puis faites défiler vers le bas et cliquez sur Expression.
-
Facultatif: Cliquez sur l'icône
Développer pour ouvrir la fenêtre de l'éditeur d'expression. (Vous pouvez également entrer l'expression
directement dans la zone sans ouvrir la fenêtre, mais l'éditeur facilite l'édition d'une expression plus longue ou plus complexe.) -
Tapez l'expression que vous souhaitez utiliser.
Utilisation d'une expression pour affecter une valeur à une variable de session
Vous pouvez utiliser une expression lors de l'affectation d'une valeur à une variable de session si vous souhaitez que la valeur de la variable soit calculée en fonction d'autres variables.
Par exemple, supposons que vous souhaitiez indiquer à votre client le coût total d'un achat, y compris 6% de taxe sur les ventes et un montant fixe de3.00 frais de traitement. Pour calculer le coût total, vous pouvez créer une variable de session et affecter la valeur à l'aide d'une expression:
(${price} * 1.06) + 3
Vous pouvez ensuite faire référence à cette variable dans la zone Assistant dit.
Pour utiliser une expression lors de l'affectation d'une valeur à une variable de session, procédez comme suit:
-
Dans une étape, cliquez sur Définir des valeurs de variable.
-
Cliquez sur Set new value.
-
Dans la liste déroulante, sélectionnez la variable de session dans laquelle vous souhaitez stocker la valeur.
-
Après to, sélectionnez Expression.
-
Tapez l'expression que vous souhaitez utiliser.
-
Si vous utilisez l'éditeur d'expression, cliquez sur Appliquer pour enregistrer vos modifications et fermer la fenêtre de l'éditeur.
Vous pouvez également utiliser une expression pour affecter une valeur initiale à une variable de session. Dans la fenêtre Variable de session, accédez à la zone Valeur initiale et cliquez sur Utiliser l'expression.
Vous pouvez également écrire une expression directement sans sélectionner au préalable une variable:
-
Dans une étape, cliquez sur Définir des valeurs de variable.
-
Cliquez sur Set new value.
-
Dans la liste déroulante, sélectionnez Expression.
-
Tapez l'expression que vous souhaitez utiliser.
-
Si vous utilisez l'éditeur d'expression, cliquez sur Appliquer pour enregistrer vos modifications et fermer la fenêtre de l'éditeur.
syntaxe des expressions
Lewatsonx Assistant Le langage d'expression est basé sur le langage Spring Expression (SpEL ), mais avec quelques différences syntaxiques importantes. Pour obtenir des informations générales détaillées surSpEL, voir Langage d'expression de printemps(SpEL).
Variables
Pour référencer une variable dans une expression, entrez un signe dollar ($), puis sélectionnez une variable dans la liste. La référence est insérée dans votre expression dans la notation correcte, en référençant la variable à
l'aide de son ID variable plutôt que de son nom d'affichage (par exemple, ${step_773} ou ${customer_id}). Ne modifiez pas cette référence à moins que vous ne souhaitiez faire référence à une autre variable et que
vous ne soyez sûr de son ID de variable.
Pour référencer les variables d'action ou de session définies par l'utilisateur dans une application client personnalisée, utilisez le préfixe de mot clé réservé user_defined_. Par exemple, utilisez ${user_defined_my_context_var} pour obtenir la valeur de my_context_var fixé par votre client. Pour plus d'informations sur le client personnalisé, voir client construit sur mesure.
Mathématiques standard
Pour les valeurs numériques, vous pouvez utiliser des expressions pour effectuer des calculs mathématiques. Pour l'arithmétique de base, vous pouvez utiliser des opérateurs standard (+, -, *, /).
Vous pouvez également utiliser des méthodes pour effectuer des opérations mathématiques supplémentaires. Pour plus d'informations, voir Méthodes de langage d'expression pour les actions.
Tableaux
Pour définir une valeur de tableau, entrez la valeur entre crochets, en séparant les éléments par des virgules (par exemple, [ "one", "two", "three" ]).
Pour référencer un élément dans un tableau, utilisez la notation entre crochets et spécifiez l'index de base zéro de l'élément dans le tableau. Par exemple, ${Items}[0] représente le premier élément du tableau Items.
Vous pouvez également utiliser la méthode de tableau get() pour extraire un élément d'un tableau. Pour plus d'informations, voir Méthodes de langage d'expression pour les actions.
Objets JSON
Utilisez la notation JSON pour définir des objets composés dans des expressions. Par exemple, l'expression suivante affecte un objet JSON complexe comme valeur d'une variable:
{
"name": {
"firstname": "John",
"lastname": "Doe"
},
"age": 36
}
Vous pouvez utiliser des variables et des fonctions mathématiques standard dans JSON pour créer des objets dynamiques qui sont calculés lors de l'exécution. Par exemple, l'expression suivante définit un objet JSON qui fait référence à des variables et calcule une valeur moyenne:
{
"temp_1": ${temp_1},
"temp_2": ${temp_2},
"avg_temp": (${temp_1} + ${temp_2}) / 2
}
Pour faire référence à un objet enfant contenu dans une valeur JSON, utilisez la notation par point pour exprimer le chemin d'accès à l'objet (par exemple, ${customer}.name.lastname).
Si vous devez faire référence à un enfant d'un objet qui peut ou non être défini, utilisez l'opérateur de navigation sécurisée (?). Par exemple, l'expression ${customer}.name?.lastname est évaluée à null si customer.name est null. (Sans l'opérateur de navigation sécurisée, une erreur se produit.)
Méthodes
Utilisez des méthodes de langage d'expression pour manipuler des valeurs (par exemple, le formatage d'une chaîne ou l'ajout d'un élément à un tableau). Pour plus d'informations sur les méthodes prises en charge pour chaque type de données, voir Méthodes de langage d'expression pour les actions.