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

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

Collect

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

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

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

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

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

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

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

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

Clear

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

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

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

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

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

ClearCollect

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

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

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

Ανάθεση

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

Σύνταξη

Συλλέξτε ( DataSource, στοιχείο, ... )

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

Clear( Συλλογή )

• Συλλογή – Απαιτείται. Η συλλογή που θέλετε να διαγράψετε.

ClearCollect ( Συλλογή, Στοιχείο, ... )

• Συλλογή – Απαιτείται. Η συλλογή που θέλετε να διαγράψετε και στην οποία θέλετε στη συνέχεια να προσθέσετε δεδομένα.
• Προϊόντα - Υποχρεωτικά. Μία ή περισσότερες καρτέλες ή πίνακες για προσθήκη στην προέλευση δεδομένων.

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

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

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

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

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

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

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

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