Συναρτήσεις Collect, Clear και ClearCollect

Δημιουργεί και διαγράφει συλλογές και προσθέτει καρτέλες σε οποιαδήποτε προέλευση δεδομένων.

Collect

Ισχύει σε: Εφαρμογές καμβά Κάρτες Προσθήκες Dataverse χαμηλού κώδικα Power Platform CLI Ροές επιφάνειας εργασίας

Η συνάρτηση Collect προσθέτει καρτέλες σε μια προέλευση δεδομένων. Τα στοιχεία για προσθήκη μπορεί να είναι:

• Μια μοναδική τιμή: Η τιμή τοποθετείται στο πεδίο Value μιας νέας καρτέλας. Όλες οι άλλες ιδιότητες μένουν blank.
• Μια καρτέλα: Κάθε ιδιότητα με όνομα τοποθετείται στην αντίστοιχη ιδιότητα μιας νέας καρτέλας. Όλες οι άλλες ιδιότητες μένουν κενές.
• Ένας πίνακας: Κάθε καρτέλα του πίνακα προστίθεται ως ξεχωριστή καρτέλα της προέλευσης δεδομένων, όπως περιγράφεται παραπάνω. Ο πίνακας δεν προστίθεται ως ένθετος πίνακας σε μια καρτέλα. Για να το κάνετε αυτό, πρέπει πρώτα να γίνει συσκευασία του πίνακα σε μια καρτέλα.

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

Εάν η προέλευση δεδομένων δεν υπάρχει ήδη, δημιουργείται μια συλλογή.

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

Μπορείτε, επίσης, να χρησιμοποιήσετε τη συνάρτηση Patch για να δημιουργήσετε καρτέλες σε μια προέλευση δεδομένων.

Η συνάρτηση Collect επιστρέφει την τροποποιημένη προέλευση δεδομένων ως ένα πίνακα. Η συνάρτηση Collect μπορεί να χρησιμοποιηθεί αποκλειστικά σε έναν τύπο συμπεριφοράς.

Clear

Ισχύει σε: Εφαρμογές καμβά

Η συνάρτηση Clear διαγράφει όλες τις καρτέλες σε μια συλλογή. Οι στήλες της συλλογής θα παραμείνουν.

Να σημειωθεί ότι η συνάρτηση Clear λειτουργεί μόνο σε συλλογές και όχι σε άλλες προελεύσεις δεδομένων. Μπορείτε να χρησιμοποιήσετε τη συνάρτηση RemoveIf( DataSource, true ) για αυτόν το σκοπό. Να προσέχετε καθώς αυτό θα καταργήσει όλες τις καρτέλες από τον χώρο αποθήκευσης της προέλευσης δεδομένων και μπορεί να επηρεάσει άλλους χρήστες.

Μπορείτε να χρησιμοποιήσετε τη συνάρτηση Remove για να καταργήσετε καρτέλες επιλεκτικά.

Η συνάρτηση Clear δεν επιστρέφει καμία τιμή. Μπορεί να χρησιμοποιηθεί αποκλειστικά σε έναν τύπο συμπεριφοράς.

ClearCollect

Ισχύει σε: Εφαρμογές καμβά Εφαρμογές βάσει μοντέλου

Η συνάρτηση ClearCollect διαγράφει όλες τις καρτέλες από μια συλλογή. Και, στη συνέχεια, προσθέτει ένα διαφορετικό σύνολο καρτελών στην ίδια συλλογή. Με μία μόνο συνάρτηση, η ClearCollect παρέχει τον συνδυασμό των συναρτήσεων Clear και Collect.

Η συνάρτηση ClearCollect επιστρέφει την τροποποιημένη συλλογή ως πίνακα. Η συνάρτηση ClearCollect μπορεί να χρησιμοποιηθεί αποκλειστικά σε έναν τύπο συμπεριφοράς.

Ανάθεση

Όταν χρησιμοποιούνται με προέλευση δεδομένων, αυτές οι λειτουργίες δεν μπορούν να ανατεθούν. Θα ανακτηθεί μόνο το πρώτο μέρος της προέλευσης δεδομένων και, στη συνέχεια, θα εφαρμοστεί η λειτουργία. Το αποτέλεσμα μπορεί να μην αντιπροσωπεύει το πλήρες ιστορικό. Στον χρόνο σύνταξης μπορεί να εμφανιστεί μια προειδοποίηση που θα σας υπενθυμίζει αυτόν τον περιορισμό και θα προτείνει την αλλαγή σε εναλλακτικές λύσεις που μπορούν να ανατεθούν, όπου είναι δυνατόν. Για περισσότερες πληροφορίες, δείτε την ενότητα επισκόπηση ανάθεσης.

Σύνταξη

Collect( DataSource, Item, ... )

• DataSource – Υποχρεωτικό. Η προέλευση δεδομένων στην οποία θέλετε να προσθέσετε δεδομένα. Εάν δεν υπάρχει ήδη, δημιουργείται μια νέα συλλογή.
• Item(s) - Υποχρεωτικό. Μία ή περισσότερες καρτέλες ή πίνακες για προσθήκη στην προέλευση δεδομένων.

Clear( Collection )

• Collection – Υποχρεωτικό. Η συλλογή που θέλετε να διαγράψετε.

ClearCollect( Collection, Item, ... )

• Collection – Υποχρεωτικό. Η συλλογή που θέλετε να διαγράψετε και στην οποία θέλετε στη συνέχεια να προσθέσετε δεδομένα.
• Item(s) - Υποχρεωτικό. Μία ή περισσότερες καρτέλες ή πίνακες για προσθήκη στην προέλευση δεδομένων.

Παραδείγματα

Διαγραφή και προσθήκη καρτελών σε μια προέλευση δεδομένων

Σε αυτά τα παραδείγματα, θα διαγράψετε και προσθέσετε σε μια συλλογή που ονομάζεται IceCream. Η προέλευση δεδομένων ξεκινά με αυτά τα περιεχόμενα:

Τύπος	Περιγραφή	Αποτέλεσμα
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } )	Διαγράφει όλα τα δεδομένα από τη συλλογή IceCream και, στη συνέχεια, προσθέτει μια καρτέλα που περιλαμβάνει μια ποσότητα παγωτού φράουλα.	Η συλλογή IceCream έχει τροποποιηθεί επίσης.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } )	Προσθέτει δύο καρτέλες στη συλλογή IceCream που περιλαμβάνει μια ποσότητα παγωτό φιστίκι και πορτοκάλι.	Η συλλογή IceCream έχει τροποποιηθεί επίσης.
Clear( IceCream )	Καταργεί όλες τις καρτέλες από τη συλλογή IceCream.	Η συλλογή IceCream έχει τροποποιηθεί επίσης.

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

Καρτέλες και πίνακες

Τα παραδείγματα αυτά εξετάζουν τον τρόπο χειρισμού των ορισμάτων καρτέλας και πίνακα Collect και ClearCollect.

Τύπος	Περιγραφή	Αποτέλεσμα
ClearCollect( IceCream, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } )	Διαγράφει όλα τα δεδομένα και, έπειτα, προσθέτει δύο καρτέλες στη συλλογή IceCream που περιλαμβάνει μια ποσότητα παγωτού σοκολάτας και βανίλιας. Οι καρτέλες που θα προστεθούν παρέχονται ως μεμονωμένα ορίσματα στη συνάρτηση.	Η συλλογή IceCream έχει τροποποιηθεί επίσης.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) )	Το ίδιο με το προηγούμενο παράδειγμα, εκτός από το ότι οι καρτέλες συνδυάζονται σε έναν πίνακα και περνούν μέσα από ένα μόνο όρισμα. Τα περιεχόμενα του πίνακα εξάγονται καρτέλα προς καρτέλα προτού προστεθούν στη συλλογή IceCream.	Η συλλογή IceCream έχει τροποποιηθεί επίσης.
ClearCollect( IceCream, { MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )	Το ίδιο με το προηγούμενο παράδειγμα, εκτός από το ότι ο πίνακας συσκευάζεται σε μια καρτέλα. Οι καρτέλες του πίνακα δεν έχουν εξαχθεί και, αντί για αυτό, προστίθεται ολόκληρος ο πίνακας ως κελί της καρτέλας.	Η συλλογή IceCream έχει τροποποιηθεί επίσης.