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

Function	Ισχύει για
Clear	Εφαρμογές καμβά Συναρτήσεις του Power Platform CLI Dataverse για εφαρμογές καμβά
ClearCollect	Εφαρμογές καμβά Ροές επιφάνειας εργασίας Power Platform CLI
Collect	Ροές εφαρμογών καμβά Εφαρμογές καμβά Εφαρμογές βάσει μοντέλου Εφαρμογές Power Platform CLI Συναρτήσεις dataverse

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

Collect

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

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

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

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

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

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

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

Clear

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

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

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

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

ClearCollect

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

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

Ανάθεση

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

Σύνταξη

Collect( Προέλευση δεδομένων, Στοιχείο, ... )

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

Clear( Συλλογή )

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

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

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

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

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

Σε αυτά τα παραδείγματα, θα διαγράψετε και προσθέσετε σε μια συλλογή που ονομάζεται 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 } )	Clear όλα τα δεδομένα και, στη συνέχεια, προσθέτει δύο εγγραφές στη συλλογή 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 έχει τροποποιηθεί επίσης.