Δημιουργία και χρήση συναρτήσεων στο Microsoft Dataverse (έκδοση προεπισκόπησης)
[Αυτό το θέμα αποτελεί τεκμηρίωση προέκδοσης και υπόκειται σε αλλαγές.]
Δημιουργία και χρήση επαναχρησιμοποιούμενων συναρτήσεων στο Microsoft Dataverse. Οι συναρτήσεις χρησιμοποιούν Power Fx για την εκτέλεση ενός συγκεκριμένου συνόλου εντολών εντός Dataverse που εκτελείται στην πλευρά του διακομιστή.
Σημαντικό
- Αυτή είναι μια δυνατότητα προεπισκόπησης.
- Οι λειτουργίες προεπισκόπησης δεν προορίζονται για παραγωγική χρήση και ενδέχεται να έχουν περιορισμένη λειτουργικότητα. Αυτές οι δυνατότητες είναι διαθέσιμες πριν από μια επίσημη κυκλοφορία έτσι ώστε οι πελάτες να έχουν πρόσβαση από νωρίς και να κάνουν σχόλια.
Προαπαιτούμενα
Ιδιότητα μέλους ρόλου ασφαλείας υπεύθυνου προσαρμογής συστήματος στο Power Platform περιβάλλον.
Δημιουργία συνάρτησης σε μια λύση
- Μεταβείτε στο Power Apps και επιλέξτε Λύσεις από το αριστερό παράθυρο περιήγησης. Εάν το στοιχείο δεν βρίσκεται στο πλαϊνό τμήμα του πίνακα, επιλέξτε ...Περισσότερα και, στη συνέχεια, επιλέξτε το στοιχείο που θέλετε.
- Ανοίξτε τη λύση όπου θέλετε να δημιουργήσετε μια συνάρτηση.
- Στη γραμμη εντολών επιλέξτε Νέα>Αυτοματισμός>Συνάρτηση.
- Καταχωρίστε τις παρακάτω πληροφορίες στο πλαϊνό παράθυρο διαλόγου Νέα συνάρτηση που εμφανίζεται.
- Δώστε ένα εμφανιζόμενο όνομα και μια περιγραφή για τη λειτουργία σας.
- Επιλέξτε Νέα παράμετρος καταχώρισης ή/και Νέα παράμετρος εξόδου και, στη συνέχεια, δώστε ένα όνομα και έναν τύπο δεδομένων για την παράμετρο. Προσθέστε περισσότερες παραμέτρους εισόδου και εξόδου, όπως απαιτείται.
- Στη λίστα Αναφορές πίνακα, μπορείτε προαιρετικά να επιλέξετε πίνακες. Μπορείτε να κάνετε αναφορά στους Dataverse πίνακες που επιλέγετε χρησιμοποιώντας συναρτήσεις συλλογής δεδομένων, όπως Φίλτρο() και Αναζήτηση().
- Πληκτρολογήστε την παράσταση Power Fx στο πλαίσιο Μορφή.
- Επιλέξτε Αποθήκευση.
- Δοκιμάστε τη συνάρτηση.
Αναφέρετε παραμέτρους εισόδου στη φόρμουλα με τα ονόματά τους.
Οι παράμετροι εξόδου πρέπει να αναφέρονται εντός των αγκύλων, όπως { Out: "Return value" }.
Φιλοδώρημα
- Παρατηρήστε το IntelliSense στο πλαίσιο Φόρμουλα. Το υπογραμμισμένο κόκκινο δεν είναι έγκυρο. Η κίτρινη μουντζούρα σημαίνει ότι η λογική σας ενδέχεται να επηρεάζεται από περιορισμούς ανάθεσης. Αποφύγετε ζητήματα ανάθεσης χρησιμοποιώντας συναρτήσεις με δυνατότητα ανάθεσης.
- Αναπτύξτε το στοιχείο Επιλογές για προχωρημένους για να εξετάσετε το όνομα του σχήματος.
Παραδείγματα συνάρτησης
Αυτή η ενότητα παρέχει μερικά παραδείγματα συναρτήσεων.
Υπολογισμός του αθροίσματος δύο ακεραίων
Εισαγάγετε ένα εμφανιζόμενο όνομα, όπως new_calculateSum, και μια περιγραφή.
Προσθέστε δύο παραμέτρους εισόδου, x και y (και οι δύο ακέραιος τύπου δεδομένων) και μία παράμετρο εξόδου, z (ακέραιος τύπος δεδομένων).
Στο πλαίσιο Φόρμουλα καταχωρίστε τη φόρμουλα:
{ z:x+y }
Προσθήκη νέου τίτλου στον πίνακα άρθρων
- Δημιουργήστε δύο παραμέτρους εισόδου τίτλος και διεύθυνση URL (και οι δύο με τύπους δεδομένων συμβολοσειράς) και μία μεταβλητή εξόδου, μήνυμα (συμβολοσειρά τύπου δεδομένων).
- Επιλέξτε τον πίνακα Ομόσπονδα Άρθρα Γνώσης στην αναπτυσσόμενη λίστα Αναφορές Πίνακα.
- Στο πλαίσιο Φόρμουλα καταχωρίστε τη φόρμουλα:
Collect('Knowledge Federated Articles',
{
Title: title,
URL: url
}
);
{
message: "New Article title added: " & title
}
Επαληθεύστε εάν μια συμβολοσειρά εισόδου περιέχει τις συμβολοσειρές της επιλογής σας
- Δημιουργήστε μια παράμετρο εισόδου DocumentTextInput (με τύπο δεδομένων συμβολοσειράς) και μία μεταβλητή εξόδου, που ονομάζεται αποτέλεσμα (συμβολοσειρά τύπου δεδομένων).
- Στο πλαίσιο Φόρμουλα καταχωρίστε τη φόρμουλα:
{
result: If("Confidentiality" in DocumentTextInput && "Dispute Resolution" in DocumentTextInput && "Governing Law" in DocumentTextInput && "Termination" in DocumentTextInput,
"Document is compliant.",
"Document is missing one or more compliance clauses."
)
}
Υπολογίστε μια τιμή διαμονής σε ξενοδοχείο
- Δημιουργήστε έξι παραμέτρους εισόδου: διανυκτερεύσεις, δωμάτια, φόρος, έκπτωση, υπηρεσία δωματίου, ratepernight (όλα με τύπο δεδομένων συμβολοσειράς) και μία μεταβλητή εξόδου, τιμή (τύπος δεδομένων κινητής υποδιαστολής).
- Στο πλαίσιο Φόρμουλα καταχωρίστε τη φόρμουλα:
{
price: ((nights*rooms*ratepernight)*(1+(tax/100))*(1-(discount/100)))+roomservice
}
Περισσότερα παραδείγματα συναρτήσεων
Για περισσότερα παραδείγματα συναρτήσεων, μεταβείτε στο παράδειγμα συναρτήσεων (έκδοση προεπισκόπησης).
Επεξεργασία, δοκιμή ή διαγραφή μιας συνάρτησης
Επεξεργασία συνάρτησης
- Επιλέξτε τη συνάρτησή σας στην περιοχή Συναρτήσεις.
- Επιλέξτε Επεξεργασία στη γραμμή εντολών.
- Τροποποιήστε την φόρμουλα σας και, στη συνέχεια αποθηκεύστε την.
Δοκιμή συνάρτησης
- Επιλέξτε τη συνάρτησή σας στην περιοχή Συναρτήσεις.
- Επιλέξτε Δοκιμή στη γραμμή εντολών.
- Δώστε τιμές για τις παραμέτρους εισόδου που ορίζονται στη συνάρτηση και, στη συνέχεια, επιλέξτε Αναπαραγωγή.
Μια επιτυχημένη δοκιμή επιστρέφει μια απόκριση OData που περιλαμβάνει πληροφορίες όπως το URI του οργανισμού, το όνομα της συνάρτησης και τις παραμέτρους και τιμές εξόδου.
Φιλοδώρημα
Χρησιμοποιήστε παραμέτρους εξόδου για να επικυρώσετε την αναμενόμενη συμπεριφορά και αποτελέσματα. Διαφορετικά, παρατηρείτε μόνο επιτυχία ή αποτυχία κατά τη δοκιμή.
Διαγραφή συνάρτησης
Σημαντικό
Κατά τη διάρκεια της προεπισκόπησης, μην διαγράψετε τις συναρτήσεις σας από την περιοχή Λύσεις καθώς μπορεί να οδηγήσει σε ορφανά στοιχεία. Οι συναρτήσεις θα πρέπει να διαγραφούν μεταβαίνοντας στο Power App (make.powerapps.com) >Συναρτήσεις στο αριστερό παράθυρο περιήγησης.
- Επιλέξτε Συναρτήσεις στο αριστερό τμήμα παραθύρου περιήγησης και, στη συνέχεια, επιλέξτε τη συνάρτησή σας. Εάν το στοιχείο δεν βρίσκεται στο πλαϊνό τμήμα του πίνακα, επιλέξτε ...Περισσότερα και, στη συνέχεια, επιλέξτε το στοιχείο που θέλετε.
- Επιλέξτε Διαγραφή στη γραμμή εντολών.