Δημιουργήστε παραστάσεις χρησιμοποιώντας το Power Fx

Σημείωμα

Αυτό το άρθρο περιγράφει δυνατότητες που χρησιμοποιούνται σε παράγοντες ή ροές παραγόντων που υποστηρίζονται από την τυπική πλεξούδα.

Το Power Fx είναι μια γλώσσα χαμηλών απαιτήσεων κώδικα που χρησιμοποιεί τύπου όπως το Excel. Χρησιμοποιήστε το Power Fx για να δημιουργήσετε σύνθετη λογική που επιτρέπει στους παράγοντες σας να χειρίζονται δεδομένα. Για παράδειγμα, ένας τύπος Power Fx μπορεί να ορίσει την τιμή μιας μεταβλητής, να αναλύσει μια συμβολοσειρά ή να χρησιμοποιήσει μια παράσταση σε μια συνθήκη. Για περισσότερες πληροφορίες, δείτε την επισκόπηση Power Fx και την αναφορά τύπου.

Σημείωμα

Οι τύποι Power Fx στο Copilot Studio χρησιμοποιούν αρίθμηση στυλ Η.Π.Α. Δηλαδή, η υποδιαστολή είναι μια τελεία ή κουκκίδα, όπως στο 12,567.892. Αυτό σημαίνει ότι πρέπει να χρησιμοποιήσετε κόμματα (,) ως διαχωριστικά παραμέτρων για τους τύπους σας Power Fx.

Προϋποθέσεις

• Δημιουργία και επεξεργασία θεμάτων
• Επισκόπηση μεταβλητών

Χρήση μεταβλητών σε τύπο

Για να χρησιμοποιήσετε μια μεταβλητή σε έναν τύπο Power Fx, πρέπει να προσθέσετε ένα πρόθεμα στο όνομά της για να υποδείξετε το πεδίο εφαρμογής της μεταβλητής:

• Για τις μεταβλητές συστήματος, χρησιμοποιήστε System.
• Για καθολικές μεταβλητές χρησιμοποιήστε Global.
• Για μεταβλητές θέματος χρησιμοποιήστε Topic.
• Για μεταβλητές περιβάλλοντος, χρησιμοποιήστε το Environment.

Για παράδειγμα, για να χρησιμοποιήσετε τη μεταβλητή συστήματος Conversation.Id σε έναν τύπο, δείτε τη μεταβλητή συστήματος ως System.Conversation.Id.

Χρήση τιμών λεκτικής σταθεράς σε τύπο

Εκτός από τη χρήση μεταβλητών σε έναν τύπο Power Fx , μπορείτε να καταχωρήσετε και τιμές λεκτικής σταθεράς. Για να χρησιμοποιήσετε μια τιμή λεκτικής σταθεράς,σε έναν τύπο πρέπει να την καταχωρήσετε με τη μορφή που αντιστοιχεί στον τύπο. Ο παρακάτω πίνακας περιλαμβάνει τους τύπους δεδομένων και τη μορφή των αντίστοιχων τιμών λεκτικής σταθεράς.

Τύπος	Παραδείγματα τύπου
String	"hi", "hello world!", "copilot"
Boolean	Μόνο true ή false
Αριθμός	1, 532, 5.258,-9201
Καταγραφή και πίνακας	[1], [45, 8, 2], ["cats", "dogs"], , { id: 1 }, { message: "hello" }{ name: "John", info: { age: 25, weight: 175 } }
Ημερομηνία/ώρα	Time(5,0,23), Date(2022,5,24), DateTimeValue("May 10, 2022 5:00:00 PM")
Επιλογή	Δεν υποστηρίζεται
Κενό	Μόνο Blank()

Κοινοί τύποι Power Fx

Ο παρακάτω πίνακας παραθέτει τους τύπους δεδομένων και τους τύπους Power Fx που μπορείτε να χρησιμοποιήσετε με κάθε τύπο δεδομένων.

Τύπος	Φόρμουλες Power Fx
String	Συνάρτηση Text Συναρτήσεις Concat και Concatenate Συνάρτηση Len Συναρτήσεις Lower, Upper και Proper Συναρτήσεις IsMatch, Match και MatchAll Συναρτήσεις EndsWith και StartsWith Συνάρτηση εύρεσης Η συνάρτηση Replace και Substitute
Boolean	Συνάρτηση Boolean Συναρτήσεις And, Or και Not Συναρτήσεις If και Switch
Αριθμός	Συναρτήσεις Decimal, Float και Value Συναρτήσεις Int, Round, RoundDown, RoundUp και Trunc
Καταγραφή και πίνακας	Συναρτήσεις Concat και Concatenate Συναρτήσεις Count, CountA, CountIf και CountRows Συνάρτηση ForAll Συναρτήσεις First, FirstN, Index, Last και LastN Συναρτήσεις Filter, Search και LookUp Συνάρτηση JSON Συνάρτηση ParseJSON
Ημερομηνία/ώρα	Συναρτήσεις Date, DateTime και Time Συναρτήσεις DateValue, TimeValue και DateTimeValue Συναρτήσεις Day, Month, Year, Hour, Minute, Second και Weekday Συναρτήσεις Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday Συναρτήσεις DateAdd, DateDiff και TimeZoneOffset Συνάρτηση Text
Κενό	Συναρτήσεις Blank, Coalesce, IsBlank και IsEmpty Συναρτήσεις Error, IfError, IsError, IsBlankOrError

Χρησιμοποιήστε το Power Fx για να ορίσετε μια μεταβλητή

Σε αυτό το παράδειγμα, μια παράσταση Power Fx αποθηκεύει και εξάγει το όνομα του πελάτη με κεφαλαία γράμματα.

1. Δημιουργήστε ένα θέμα και προσθέστε έναν κόμβο Ερώτηση .

2. Για Εισαγωγή μηνύματος, πληκτρολογήστε «Πώς σας λένε;».

3. Στην περιοχή Προσδιορισμός, επιλέξτε την οντότητα Όνομα προσώπου.

4. Επιλέξτε το πλαίσιο στην περιοχή Αποθήκευση απόκρισης χρήστη ως και, στη συνέχεια, επιλέξτε τη μεταβλητή Var1 και ονομάστε την customerName.

5. Στον κόμβο Ερώτηση, επιλέξτε + και, έπειτα, επιλέξτε Ορισμός τιμής μεταβλητής.

6. Επιλέξτε το πλαίσιο στο Ορισμός μεταβλητής, και έπειτα επιλέξτε Δημιουργία νέας και ονομάστε την capsName.

7. Στο πλαίσιο Προς τιμή, επιλέξτε το βέλος > και, έπειτα, επιλέξτε την καρτέλα Τύπος.

8. Στο πλαίσιο fx, εισαγάγετε Upper(Text(Topic.customerName)) και, έπειτα, επιλέξτε Εισαγωγή.

   

9. Κάτω από τον κόμβο Ερώτηση, επιλέξτε + και έπειτα επιλέξτε Αποστολή μηνύματος.

10. Πληκτρολογήστε "HELLO ", επιλέξτε {x} και, στη συνέχεια, επιλέξτε capsName.

    

Χρήση τύπου Power Fx ως συνθήκη

Για να αξιολογήσετε πιο σύνθετες παραστάσεις, ρυθμίστε τους κόμβους Συνθήκη ώστε να χρησιμοποιούν τύπους Power Fx.

Σε αυτό το παράδειγμα, ο παράγοντας καθορίζει εάν μια ημερομηνία κράτησης πληροί τις προϋποθέσεις για έκπτωση. Για να το κάνετε αυτό, ελέγχει εάν η ημερομηνία κράτησης που παρέχεται από τον πελάτη είναι 14 ημέρες ή περισσότερο από την τρέχουσα ημερομηνία.

1. Δημιουργήστε ένα θέμα και προσθέστε έναν κόμβο Ερώτηση .

2. Για Εισαγωγή μηνύματος, πληκτρολογήστε "Ημερομηνία κράτησης;".

3. Στην περιοχή Προσδιορισμός, επιλέξτε την οντότητα Ημερομηνία και ώρα.

4. Επιλέξτε το πλαίσιο στην περιοχή Αποθήκευση απόκρισης χρήστη ως και, στη συνέχεια, επιλέξτε τη μεταβλητή Var1 και ονομάστε την bookingDate.

   

5. Επιλέξτε το εικονίδιο Προσθήκη κόμβου κάτω από τον κόμβο Ερώτηση και μετά επιλέξτε Προσθέστε μία συνθήκη.

6. Επιλέξτε τις τρεις τελείες (...) του κόμβου Συνθήκη και, στη συνέχεια, επιλέξτε Αλλαγή σε τύπο.

7. Στο πλαίσιο Συνάρτηση, επιλέξτε το βέλος > και, έπειτα, επιλέξτε την καρτέλα Τύπος.

8. Αντικαταστήστε τα περιεχόμενα του πλαισίου fx με τον τύπο Topic.bookingDate > (DateAdd (Now(), 14)) και, έπειτα, επιλέξτε Εισαγωγή.

9. Κάτω από τον κόμβο Συνθήκη, προσθέστε έναν κομβό Μήνυμα και εισαγάγετε το μήνυμα "Πληροίτε τις προϋποθέσεις για έκπτωση".

10. Κάτω από τον κόμβο Όλες οι άλλες συνθήκες, προσθέστε έναν κομβό Μήνυμα και εισαγάγετε το μήνυμα "Συγγνώμη, δεν πληροίτε τις προϋποθέσεις για έκπτωση".