Συνάρτηση Choices
Ισχύει σε:
Εφαρμογές καμβά Εφαρμογές βάσει μοντέλου
Επιστρέφει έναν πίνακα με τις πιθανές τιμές για μια στήλη αναζήτησης.
Description
Η συνάρτηση Choices επιστρέφει έναν πίνακα με τις πιθανές τιμές για μια στήλη αναζήτησης.
Χρησιμοποιήστε τη συνάρτηση Choices για να παρέχετε μια λίστα επιλογών για τον χρήστη. Αυτή η συνάρτηση χρησιμοποιείται συνήθως με το στοιχείο ελέγχου Combo box σε φόρμες επεξεργασίας.
Για μια αναζήτηση, ο πίνακας που επιστρέφει η συνάρτηση Choices συμφωνεί με τον εξωτερικό πίνακα που έχει συσχετιστεί με την αναζήτηση. Με τη χρήση της συνάρτησης Choices, εξαλείφεται η ανάγκη προσθήκης ενός εξωτερικού πίνακα ως προέλευσης δεδομένων. Η συνάρτηση Choices επιστρέφει όλες τις στήλες του εξωτερικού πίνακα.
Επειδή η συνάρτηση Choices επιστρέφει έναν πίνακα, μπορείτε να χρησιμοποιήσετε τις Filter, Sort, AddColumns και όλες τις άλλες συναρτήσεις χειρισμού πίνακα για να φιλτράρετε, να ταξινομήσετε και να σχηματοποιήσετε τον πίνακα.
Αυτήν τη στιγμή, δεν είναι δυνατή η ανάθεση της συνάρτησηςChoices. Εάν αυτός ο περιορισμός αποτελεί πρόβλημα για την εφαρμογή σας, προσθέστε τον εξωτερικό πίνακα ως προέλευση δεδομένων και χρησιμοποιήστε τον απευθείας.
Η συνάρτηση Choices δεν απαιτεί τα ονόματα στηλών να είναι συμβολοσειρές και να περικλείονται σε διπλά εισαγωγικά, σε αντίθεση με τις ShowColumns, Search και άλλες συναρτήσεις πίνακα. Καταχωρήστε τον τύπο σαν να κάνατε απευθείας αναφορά στη στήλη.
Οι αναφορές στηλών πρέπει να κατευθύνουν προς την προέλευση δεδομένων. Για παράδειγμα, εάν η προέλευση δεδομένων είναι Accounts και η αναζήτηση είναι SLA, η αναφορά στήλης θα Accounts.SLA. Η αναφορά δεν είναι δυνατό να διέρχεται από μια συνάρτηση, μια μεταβλητή ή ένα στοιχείο ελέγχου. Επεκτείνοντας αυτό το παράδειγμα, εάν το Accounts χορηγείται σε ένα στοιχείο ελέγχου Gallery, χρησιμοποιήστε τον τύπο Gallery.Selected.SLA για να αναφερθείτε στο SLA για τον επιλεγμένο λογαριασμό. Ωστόσο, αυτή η αναφορά έχει περάσει από ένα στοιχείο ελέγχου και δεν είναι δυνατό να διαβιβαστεί στη συνάρτηση Columns - εξακολουθείτε να πρέπει να χρησιμοποιήσετε την Accounts.SLA.
Αυτήν τη στιγμή, μπορείτε να χρησιμοποιήσετε στήλες αναζήτησης μόνο με το SharePoint και το Microsoft Dataverse.
Σύνταξη
Choices( column-reference [, text-filter ] )
- column-reference - Υποχρεωτικό. Μια στήλη αναζήτησης μιας προέλευσης δεδομένων. Μην περικλείετε το όνομα της στήλης σε διπλά εισαγωγικά. Η αναφορά πρέπει να απευθείας στη στήλη της προέλευσης δεδομένων και να μην διέρχεται από μια συνάρτηση ή ένα στοιχείο ελέγχου.
- text-filter - Προαιρετικό. Φιλτράρει τη λίστα επιλογών επιστρέφοντας μόνο επιλογές που ξεκινούν με το κείμενο που καθορίζεται ως text-filter. Εάν καθοριστεί μια κενή συμβολοσειρά, θα επιστραφούν όλες οι επιλογές.
Παραδείγματα
Choices για μια αναζήτηση
Δημιουργήστε μια βάση δεδομένων στο Dataverse και επιλέξτε το πλαίσιο Συμπερίληψη δειγμάτων εφαρμογών και δεδομένων.
Δημιουργούνται πολλοί πίνακες, όπως Λογαριασμοί.
Σημείωση: Τα ονόματα των πινάκων είναι στον ενικό στο make.powerapps.com και στον πληθυντικό στο Power Apps Studio.
Ο πίνακας Λογαριασμοί έχει μια στήλη Κύρια επαφή, η οποία είναι μια αναζήτηση για τον πίνακα Επαφές.
Για κάθε λογαριασμό, μια επαφή έχει οριστεί ως η κύρια επαφή ή η κύρια επαφή είναι κενή.
Δημιουργία εφαρμογής από τον πίνακα Λογαριασμοί.
Στη λίστα των οθονών και των στοιχείων ελέγχου κοντά στο αριστερό άκρο, μετακινηθείτε προς τα κάτω μέχρι να εμφανιστεί η EditScreen1 και, στη συνέχεια, επιλέξτε EditForm1 ακριβώς κάτω από αυτή.
Στην καρτέλα ιδιότητες στο δεξιό τμήμα του παραθύρου, επιλέξτε Edit fields.
Στο παράθυρο Πεδία κάντε κλικ στην επιλογή Προσθήκη πεδίου.
Αναζητήστε το πεδίο Κύρια επαφή, επιλέξτε το πλαίσιο ελέγχου του και, στη συνέχεια, επιλέξτε Προσθήκη.
Το πεδίο Κύρια επαφή εμφανίζεται στο κάτω μέρος της φόρμας. Εάν το πεδίο εμφανίζει σφάλμα, επιλέξτε Προελεύσεις δεδομένων από την καρτέλα Προβολή, επιλέξτε τα αποσιωπητικά (...) για την προέλευση δεδομένων Λογαριασμοί και, στη συνέχεια, επιλέξτε Ανανέωση.
(προαιρετικό) Σύρετε το πεδίο Κύρια επαφή από κάτω στο επάνω μέρος της λίστας πεδίων.
Στην καρτέλα για το Κύρια επαφή, επιλέξτε το στοιχείο ελέγχου Combo box.
Η ιδιότητα Items αυτού του στοιχείου ελέγχου ορίζεται σε έναν τύπο ο οποίος προσδιορίζει τη στήλη είτε με το εμφανιζόμενο όνομα της, όπως στο πρώτο παράδειγμα, είτε με το λογικό της όνομα, όπως στο δεύτερο παράδειγμα:
Choices( Accounts.'Primary Contact' )
Choices( Accounts.primarycontactid )
Για λόγους απεικόνισης, είναι δυνατή η προβολή ολόκληρου του πίνακα που επιστρέφεται από τη συνάρτηση Choices σε ένα στοιχείο ελέγχου Data table. Στην καρτέλα Αρχική, επιλέξτε Νέα οθόνη και, στη συνέχεια, επιλέξτε Κενή.
Στην καρτέλα Εισαγωγή, επιλέξτε Data table.
Ορίστε την ιδιότητα Items του στοιχείου ελέγχου Data table στον εξής τύπο:
Choices( Accounts.'Primary Contact' )
Στη μέση του στοιχείου ελέγχου Data table, επιλέξτε τη σύνδεση που ξεκινά Επιλέξτε τα πεδία... και, στη συνέχεια, επιλέξτε τα πλαίσια ελέγχου για το πεδίο ή τα πεδία που θέλετε να εμφανίσετε (για παράδειγμα, όνομα και επώνυμο).
