Créer des expressions avec Power Fx

Article
10/25/2024

Power Fx est un langage low-code qui utilise des formules de type Excel. Utiliser Power Fx pour créer une logique complexe qui permet à vos copilotes de manipuler les données. Par exemple, une formule Power Fx peut définir la valeur d’une variable, analyser une chaîne ou utiliser une expression dans une condition. Pour en savoir plus, voir la Vue d’ensemble Power Fx et la référence sur les formules.

Note

Power Fx les formules Copilot Studio utilisent une numérotation de style américain. Autrement dit, le séparateur décimal est un point, comme dans 12,567.892. Autrement dit, les paramètres Power Fx doivent être séparés par des virgules (,).

Conditions préalables

Utiliser des variables dans une formule

Pour utiliser une variable dans une formule Power Fx, vous devez ajouter un préfixe à son nom pour indiquer l‘étendue de la variable :

Pour les variables système, utilisez System.
Pour les variables globales, utilisez Global.
Pour les variables de rubrique, utilisez Topic.

Par exemple, pour utiliser la variable système Conversation.Id dans une formule, faites référence à la variable système comme System.Conversation.Id.

Capture d’écran du volet Entrer une formule avec une expression contenant une variable système.

Utiliser des valeurs littérales dans une formule

En plus d’utiliser des variables dans une formule Power Fx, vous pouvez saisir des valeurs littérales. Pour utiliser une valeur littérale dans une formule, vous devez saisir la valeur dans le format correspondant à son type : Le tableau suivant répertorie les types de données et le format de leurs valeurs littérales correspondantes.

Type	Exemples de format
String	`"hi"`, `"hello world!"`, `"copilot"`
Valeur booléenne	Uniquement `true` ou `false`
Chiffre	`1`, `532`, `5.258`,`-9201`
Enregistrement et tableau	`[1]`, `[45, 8, 2]`, `["cats", "dogs"]`, `{ id: 1 }`, `{ message: "hello" }`, `{ name: "John", info: { age: 25, weight: 175 } }`
DateHeure	`Time(5,0,23)`, `Date(2022,5,24)`, `DateTimeValue("May 10, 2022 5:00:00 PM")`
Option	Non pris en charge
Vide	Uniquement `Blank()`

Formules courantes Power Fx

Le tableau suivant répertorie les types de données et les formules correspondantes à utiliser avec ce type de données. Power Fx

Type	Formules Power Fx
String	Fonction texte Fonctions Concat et Concatenate Fonction Len Fonctions inférieure, supérieure et propre Fonctions IsMatch, Match et MatchAll Fonctions EndsWith et StartsWith Fonction de recherche Fonction Remplacer et Substituer
Valeur booléenne	Fonction booléen Fonctions Et, Ou et Non
Chiffre	Fonctions décimales, flottantes et de valeur Fonctions Int, Round, RoundDown, RoundUp et Trun
Enregistrement et tableau	Fonctions Concat et Concatenate Fonctions Count, CountA, CountIf et CountRows Fonction ForAll Fonctions First, FirstN, Index, Last et LastN Fonctions de filtrage, de recherche et de consultation Fonction JSON Fonction ParseJSON
DateHeure	Fonctions Date, DateTime et Heure Fonctions DateValue, TimeValue et DateTimeValue Fonctions Jour, Mois, Année, Heure, Minute, Seconde et Jour de la semaine Fonctions Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday Fonctions DateAdd, DateDiff et TimeZoneOffset Fonction texte
Vide	Fonctions Blank, Coalesce, IsBlank et IsEmpty

Utiliser Power Fx pour définir une variable

Dans cet exemple, une Power Fx expression stocke et génère le nom du client en majuscules.

Créez une rubrique et ajoutez un nœud Question.
Pour Entrer un message, entrez "Quel est votre nom ? ».
Sous Identifier, sélectionnez l’entité Nom de la personne.
Sélectionnez la zone sous Enregistrer la réponse sous, puis sélectionnez la variable Var1 et nommez-la customerName.
Sous le nœud Question, sélectionnez +, puis Définir une valeur de variable.
Sélectionnez la zone sous Définir la variable, puis sélectionnez Créer et nommez-la capsName.
Dans la zone Vers la valeur, sélectionnez la flèche >, puis sélectionnez l’onglet Formule.
Dans la zone fx, saisissez Upper(Text(Topic.customerName)), puis sélectionnez Insérer.
Sous le nœud Question, sélectionnez +, puis Envoyer un message.
Entrez "HELLO", Sélectionner {x}, puis Sélectionner capsName.

Utiliser une formule Power Fx comme condition

Pour évaluer des expressions plus complexes, configurez les nœuds Condition pour utiliser les formules Power Fx.

Dans cet exemple, le copilote détermine si une date de réservation donne droit à une réduction. Pour ce faire, il vérifie si la date de réservation fournie par le client est de 14 jours ou plus à partir de la date actuelle.

Créez une rubrique et ajoutez un nœud Question.
Pour Entrer un message, entrez "Date de réservation ? ».
Sous Identifier, sélectionnez l’entité Date et heure.
Sélectionnez la zone sous Enregistrer la réponse sous, puis sélectionnez la variable Var1 et nommez-la bookingDate.
Sélectionner l’ icône Ajouter un nœud sous le nœud Question , puis Sélectionner Ajouter une condition.
Sélectionner l’icône Plus (…) du nœud Condition , puis Sélectionner Changer en formule.
Dans la zone Fonction, sélectionnez la flèche >, puis sélectionnez l’onglet Formule.
Remplacez le contenu de la zone fx par la formule Topic.bookingDate > (DateAdd (Now(), 14)), puis sélectionnez Insérer.
Sous le nœud Condition , ajoutez un nœud Message et saisissez le message "Vous avez droit à une remise".
Sous le nœud Toutes les autres conditions , ajoutez un nœud Message et saisissez le message "Désolé, vous n’avez pas droit à une remise. »

Partager via