Creare espressioni utilizzando Power Fx

Power Fx è un linguaggio con poco codice che utilizza formule simili a Excel. Utilizza Power Fx per creare una logica complessa che consenta ai tuoi copiloti di manipolare i dati. Ad esempio, una formula Power Fx può impostare il valore di una variabile, analizzare una stringa o utilizzare un'espressione in una condizione. Per altre informazioni, vedi la panoramica di Power Fx e il riferimento della formula.

Nota

Power Fx le formule in Copilot Studio utilizzano la numerazione in stile USA. Vale a dire che il separatore decimale è un punto, come in 12,567.892. Questo significa che i parametri Power Fx devono essere separati da virgole (,).

Prerequisiti

• Crea e modifica argomenti
• Lavorare con le variabili

Usare le variabili in una formula

Per usare una variabile in una formula Power Fx, è necessario aggiungere un prefisso al nome per indicare l'ambito della variabile:

• Per le variabili di sistema, utilizza System.
• Per le variabili globali, utilizza Global.
• Per le variabili di argomento, utilizza Topic.

Ad esempio, per utilizzare la variabile di sistema Conversation.Id in una formula, fare riferimento alla variabile di sistema come System.Conversation.Id.

Utilizzare valori letterali in una formula

Oltre a utilizzare le variabili in una formula Power Fx, puoi inserire valori letterali. Per utilizzare un valore letterale in una formula, devi immetterlo nel formato che corrisponde al suo tipo. La tabella seguente elenca i tipi di dati e il formato dei valori letterali corrispondenti.

Type	Esempi di formato
String	"hi", "hello world!", "copilot"
Booleano	Solo true o false
Numero	1, 532, 5.258,-9201
Registrazione e tabella	[1], [45, 8, 2], ["cats", "dogs"], { id: 1 }, { message: "hello" }, { name: "John", info: { age: 25, weight: 175 } }
Data/Ora	Time(5,0,23), Date(2022,5,24), DateTimeValue("May 10, 2022 5:00:00 PM")
Choice	Non supportato
Vuoto	Solo Blank()

Formule comuni Power Fx

Nella tabella seguente sono elencati i tipi di dati e le formule corrispondenti da utilizzare con quel tipo di dati. Power Fx

Type	Formule Power Fx
String	Funzione testo Funzioni Concat e Concatenate Funzione Len Funzioni inferiore, superiore e corretta Funzioni IsMatch, Match e MatchAll Funzioni EndsWith e StartsWith Trova funzione Funzione Sostituisci e Sostituisci
Booleano	Funzione booleano Funzioni And, Or e Not
Numero	Funzioni decimali, float e valore Funzioni Int, Round, RoundDown, RoundUp e Trun
Registrazione e tabella	Funzioni Concat e Concatenate Funzioni Count, CountA, CountIf e CountRows Funzione ForAll Funzioni First, FirstN, Index, Last e LastN Funzioni di filtro, ricerca e lookup Funzione JSON Funzione ParseJSON
Data/Ora	Funzioni Data, DateTime e Ora Funzioni DateValue, TimeValue e DateTimeValue Funzioni giorno, mese, anno, ora, minuto, secondo e giorno della settimana Funzioni Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday Funzioni DateAdd, DateDiff e TimeZoneOffset Funzione testo
Vuoto	Funzioni Blank, Coalesce, IsBlank e IsEmpty

Utilizzare Power Fx per impostare una variabile

In questo esempio, l'espressione a Power Fx memorizza e restituisce il nome del cliente in lettere maiuscole.

1. Crea un argomento e aggiungi un nodo Domanda.

2. Per Inserisci un messaggio, inserisci "Come ti chiami?".

3. In Identifica, seleziona l'entità Nome persona.

4. Seleziona la casella in Salva risposta come, quindi seleziona la variabile Var1 e denominala customerName.

5. Nel nodo Domanda, seleziona + e quindi seleziona Imposta un valore della variabile.

6. Seleziona la casella in Imposta variabile, quindi seleziona Crea nuovo e denominala capsName.

7. Nella casella A valore , seleziona la freccia>, quindi seleziona la scheda Formula.

8. Nella casella fx, immetti Upper(Text(Topic.customerName)), quindi seleziona Inserisci.

   

9. Nel nodo Domanda, seleziona + e scegli Invia un messaggio.

10. Inserisci "HELLO ", Seleziona {x}, quindi Seleziona capsName.

    

Utilizza una formula Power Fx come condizione

Per valutare espressioni più complesse, configura i nodi Condizione in modo utilizzare formule Power Fx.

In questo esempio, il copilota determina se una data di prenotazione è idonea per uno sconto. Per fare ciò, controlla se la data di prenotazione fornita dal cliente è di 14 giorni o più dalla data corrente.

1. Crea un argomento e aggiungi un nodo Domanda.

2. Per Inserisci un messaggio, inserisci "Data di prenotazione?".

3. In Identifica, seleziona l'entità Data e ora.

4. Seleziona la casella in Salva risposta come, quindi seleziona la variabile Var1 e denominala bookingDate.

   

5. Seleziona l'icona Aggiungi nodo sotto il nodo Domanda , quindi Seleziona Aggiungi una condizione.

6. Seleziona l'icona Altro (…) del nodo Condizione , quindi Seleziona Passa alla formula.

7. Nella casella Funziona , seleziona la freccia>, quindi seleziona la scheda Formula.

8. Sostituisci il contenuto della casella fx con la formula Topic.bookingDate > (DateAdd (Now(), 14)), quindi seleziona Inserisci.

9. Nel nodo Condizione , aggiungi un nodo Messaggio e inserisci il messaggio "Hai diritto a uno sconto".

10. Nel nodo Tutte le altre condizioni , aggiungi un nodo Messaggio e inserisci il messaggio "Siamo spiacenti, non hai diritto allo sconto".