Συναρτήσεις Remove και RemoveIf

Άρθρο
03/22/2024

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

Καταργεί καρτέλες από μια προέλευση δεδομένων.

Σημείωμα

Οι εντολές PAC CLI pac power-fx δεν υποστηρίζουν τη συνάρτηση RemoveIf.

Description

Συνάρτηση Remove

Χρησιμοποιήστε τη συνάρτηση Remove για να καταργήσετε μια συγκεκριμένη καρτέλα ή καρτέλες από μια προέλευση δεδομένων.

Για συλλογές πρέπει να ταιριάζει ολόκληρη η καρτέλα. Μπορείτε να χρησιμοποιήσετε το όρισμα RemoveFlags.All για να καταργήσετε όλα τα αντίγραφα μιας καρτέλας, διαφορετικά, καταργείται μόνο ένα αντίγραφο της καρτέλας.

Συνάρτηση RemoveIf

Χρησιμοποιήστε τη συνάρτηση RemoveIf για να καταργήσετε μια καρτέλα ή καρτέλες με βάση μια συνθήκη ή ένα σύνολο συνθηκών. Κάθε συνθήκη μπορεί να είναι οποιοσδήποτε τύπος που έχει ως αποτέλεσμα τιμή true ή false και μπορεί να αναφέρεται σε στήλες της προέλευσης δεδομένων με βάση το όνομα. Κάθε συνθήκη αξιολογείται μεμονωμένα για κάθε καρτέλα και η καρτέλα καταργείται, εάν όλες οι συνθήκες αξιολογούνται σε true.

Οι συναρτήσεις Remove και RemoveIf επιστρέφουν την τροποποιημένη προέλευση δεδομένων ως πίνακα. Μπορείτε να χρησιμοποιήσετε και τις δύο συναρτήσεις μόνο σε τύπους συμπεριφοράς.

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

Ανάθεση

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

Υποστήριξη ανάθεσης (Πειραματική)

Η υποστήριξη ανάθεσης για το RemoveIf βρίσκεται τώρα στην Πειραματική έκδοση προεπισκόπησης (προεπιλογή OFF) για προελεύσεις δεδομένων που την υποστηρίζουν. Εάν μια προέλευση δεδομένων δεν υποστηρίζει αυτήν τη δυνατότητα, το Power Apps θα στείλει ένα ερώτημα στο διακομιστή και θα ανακτήσει όλα τα δεδομένα που ταιριάζουν στην έκφραση φίλτρου έως το μέγιστο είτε 500, 2000 είτε στο μέγεθος της σελίδας δεδομένων. Στη συνέχεια, θα εκτελέσει μια λειτουργία διαγραφής σε καθεμία από αυτές τις καρτέλες με μεμονωμένες κλήσεις στο διακομιστή.

Σύνταξη

Remove( DataSource, Record1 [, Record2, ... ] [, RemoveFlags.All ] )

DataSource – Υποχρεωτικό. Η προέλευση δεδομένων που περιέχει την καρτέλα ή τις καρτέλες που θέλετε να καταργήσετε.
Record(s) - Υποχρεωτικό. Η καρτέλα ή οι καρτέλες για κατάργηση.
RemoveFlags.All – Προαιρετικό. Σε μια συλλογή, η ίδια εγγραφή μπορεί να εμφανίζεται περισσότερες από μία φορές. Μπορείτε να προσθέσετε το όρισμα RemoveFlags.All για να καταργήσετε όλα τα αντίγραφα της καρτέλας.

Remove( DataSource, Table [, RemoveFlags.All ] )

DataSource – Υποχρεωτικό. Η προέλευση δεδομένων που περιέχει τις καρτέλες που θέλετε να καταργήσετε.
Πίνακας – Υποχρεωτικό. Πίνακας των καρτελών προς κατάργηση.
RemoveFlags.All – Προαιρετικό. Σε μια συλλογή, η ίδια εγγραφή μπορεί να εμφανίζεται περισσότερες από μία φορές. Μπορείτε να προσθέσετε το όρισμα RemoveFlags.All για να καταργήσετε όλα τα αντίγραφα της καρτέλας.

RemoveIf( DataSource, Condition [, ... ] )

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

Παραδείγματα-Μεμονωμένοι τύποι

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

Παράδειγμα παγωτού.

Δημιουργία συλλογής με δείγματα καρτελών

Για να δημιουργήσετε μια συλλογή με αυτά τα δεδομένα:

Εισαγάγετε ένα στοιχείο ελέγχου Button.

Ορίστε την ιδιότητα OnSelect του στοιχείου ελέγχου Button στον παρακάτω τύπο:

ClearCollect( IceCream,
              { ID: 1, Flavor: "Chocolate",  Quantity: 100 },
              { ID: 2, Flavor: "Vanilla",    Quantity: 200 },
              { ID: 3, Flavor: "Strawberry", Quantity: 300 }
)

Επιλέξτε το κουμπί ενώ κρατάτε πατημένο το πλήκτρο Alt:

Κατάργηση δειγμάτων καρτελών από τη συλλογή χρησιμοποιώντας έναν τύπο

Τύπος	Description	Result
Remove( IceCream, LookUp( IceCream, Flavor="Chocolate" ))	Καταργεί την καρτέλα Chocolate από την προέλευση δεδομένων.	Η προέλευση δεδομένων IceCream έχει τροποποιηθεί.
Remove( IceCream, LookUp( IceCream, Flavor="Chocolate" ), LookUp( IceCream, Flavor="Strawberry" ) )	Καταργεί δύο καρτέλες από την προέλευση δεδομένων.	Η προέλευση δεδομένων IceCream έχει τροποποιηθεί.
RemoveIf( IceCream, Quantity > 150 )	Καταργεί τις καρτέλες που έχουν Quantity μεγαλύτερη από 150.	Η προέλευση δεδομένων IceCream έχει τροποποιηθεί.
RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S" )	Καταργεί τις καρτέλες που έχουν τιμή Quantity μεγαλύτερη από 150 και τιμή Flavor που ξεκινά με S.	Η προέλευση δεδομένων IceCream έχει τροποποιηθεί.
RemoveIf( IceCream, true )	Καταργεί όλες τις καρτέλες από την προέλευση δεδομένων.	Η προέλευση δεδομένων IceCream έχει τροποποιηθεί.

Παραδείγματα - κατάργηση κουμπιού εκτός μιας συλλογής

Σε αυτό το παράδειγμα, θα χρησιμοποιήσετε ένα στοιχείο ελέγχου Gallery για να παραθέσετε τις καρτέλες σε έναν πίνακα. Κι, έπειτα, χρησιμοποιήσετε τη συνάρτηση Remove για να καταργήσετε επιλεκτικά ένα στοιχείο.

Προετοιμασία για δείγμα δεδομένων

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

Κατάργηση κουμπιού εκτός μιας συλλογής

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

Δημιουργήστε μια νέα κενή εφαρμογή καμβά χρησιμοποιώντας μια διάταξη τηλεφώνου.
Επιλέξτε το Ένθεμα από το αριστερό τμήμα παραθύρου.
Επιλέξτε Κατακόρυφη συλλογή.
Ένα στοιχείο ελέγχου Gallery προστίθεται στην οθόνη σας.
Θα σας ζητηθεί να επιλέξετε μια προέλευση δεδομένων όπου μπορείτε να επιλέξετε μια προέλευση δεδομένων από τις διαθέσιμες προελεύσεις δεδομένων.
Για παράδειγμα, επιλέξτε τον πίνακα Επαφές για να χρησιμοποιήσετε το δείγμα δεδομένων:

Η συλλογή εμφανίζει στοιχεία από αυτόν τον πίνακα:
Εισαγάγετε ένα στοιχείο ελέγχου Button από το αριστερό τμήμα παραθύρου:
Μετακινήστε το κουμπί που προστίθεται κάτω από τα στοιχεία συλλογής:
Ενημέρωση για την ιδιότητα κειμένου κουμπιού σε Κατάργηση καρτέλας. Μπορείτε, επίσης, να χρησιμοποιήσετε κείμενο της επιλογής σας:
Ορίστε την ιδιότητα OnSelect για το στοιχείου ελέγχου αυτού του κουμπιού στον παρακάτω τύπο:
```
Remove( Contacts, Gallery1.Selected )
```
Το Στοιχείο ελέγχου Gallery καθιστά την τρέχουσα επιλεγμένη καρτέλα διαθέσιμη χρησιμοποιώντας την ιδιότητα Selected. Η συνάρτηση Remove αναφέρεται σε αυτήν την επιλεγμένη καρτέλα για να την καταργήσει.
Κάντε προεπισκόπηση της εφαρμογής χρησιμοποιώντας κουμπί Play στην επάνω δεξιά γωνία ή πατήστε F5 στο πληκτρολόγιο:
Επιλέξτε μια καρτέλα προς κατάργηση, όπως η καρτέλα της Νάνσυ στο παρακάτω παράδειγμα:
Επιλέξτε Κατάργηση καρτέλας:

Εάν επιλέξετε το κουμπί, καταργείται η επιλεγμένη καρτέλα (σε αυτό το παράδειγμα, η καρτέλα της Νανσύ).
Κλείστε την προεπισκόπηση εφαρμογής.

Φιλοδώρημα

Επίσης, μπορείτε να χρησιμοποιήσετε την εναλλακτική συμπεριφορά με το πλήκτρο Alt αντί να χρησιμοποιήσετε την προεπισκόπηση εφαρμογής με το κουμπί Αναπαραγωγή ή το F5.

Παραδείγματα - εικονίδιο κάδου απορριμμάτων στο εσωτερικό μιας συλλογής

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

Δημιουργία συλλογής με δείγματα δεδομένων

Εάν έχετε ήδη προετοιμάσει δείγματα δεδομένων, παραλείψτε αυτό το βήμα και μετακινηθείτε στο εικονίδιο Κάδος απορριμμάτων εντός μιας συλλογής.

Προσθέστε ένα στοιχείο ελέγχου Button στην οθόνη σας.

Ορίστε την ιδιότητα OnSelect στον παρακάτω τύπο:

ClearCollect( SampleContacts,
      { 'Full Name': "Yvonne McKay (sample)",      'Primary Email': "someone_a@example.com" },
      { 'Full Name': "Susanna Stubberod (sample)", 'Primary Email': "someone_b@example.com" },
      { 'Full Name': "Nancy Anderson (sample)",    'Primary Email': "someone_c@example.com" },
      { 'Full Name': "Maria Campbell (sample)",    'Primary Email': "someone_d@example.com" },
      { 'Full Name': "Robert Lyon (sample)",       'Primary Email': "someone_e@example.com" },
      { 'Full Name': "Paul Cannon (sample)",       'Primary Email': "someone_f@example.com" },
      { 'Full Name': "Rene Valdes (sample)",       'Primary Email': "someone_g@example.com" }
)

Επιλέξτε το κουμπί ενώ κρατάτε πατημένο το πλήκτρο Alt.

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

Εικονίδιο κάδου απορριμμάτων στο εσωτερικό μιας συλλογής

Δημιουργήστε μια νέα κενή εφαρμογή καμβά χρησιμοποιώντας μια διάταξη τηλεφώνου.
Επιλέξτε το Ένθεμα από το αριστερό τμήμα παραθύρου.
Επιλέξτε Κατακόρυφη συλλογή.
Ένα στοιχείο ελέγχου Gallery προστίθεται στην οθόνη σας.
Θα σας ζητηθεί να επιλέξετε μια προέλευση δεδομένων όπου μπορείτε να επιλέξετε μια προέλευση δεδομένων από τις διαθέσιμες προελεύσεις δεδομένων.
Για παράδειγμα, επιλέξτε τον πίνακα Επαφές για να χρησιμοποιήσετε το δείγμα δεδομένων:

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

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

Σημείωμα

Το Προσθήκη εικονιδίου εισάγει ένα εικονίδιο + στην αριστερή πλευρά της συλλογής, το οποίο έχει αναπαραχθεί για κάθε στοιχείο στη συλλογή.
Στο επάνω στοιχείο, μετακινήστε το εικονίδιο στη δεξιά πλευρά της οθόνης.
Επιλέξτε την ιδιότητα Icon για εικονίδιο και ορίστε τη στον ακόλουθο τύπο για να ενημερώσετε την εικόνα εικονιδίου ως εικονίδιο κάδου απορριμμάτων:
```
Icon.Trash
```
Σημείωμα

Το πρόθεμα Icon. εμφανίζεται μόνο όταν επεξεργάζεστε ενεργά τον τύπο.
Ορίστε την ιδιότητα OnSelect στον παρακάτω τύπο:
```
Remove( [@Contacts], ThisItem )
```
Σημείωμα

Πρέπει να χρησιμοποιήσετε τον τελεστή καθολικής αποσαφήνισης[@...] σε αυτό το παράδειγμα με δείγμα δεδομένων που χρησιμοποιεί τον πίνακα Επαφές για να αποφύγετε διένεξη με τη σχέση Ένα προς πολλά. Εάν χρησιμοποιείτε προελεύσεις δεδομένων, όπως μια λίστα ή έναν πίνακα SQL Server, δεν απαιτείται η χρήση του τελεστή καθολικής αποσαφήνισης.
Κάντε προεπισκόπηση της εφαρμογής χρησιμοποιώντας κουμπί Play στην επάνω δεξιά γωνία ή πατήστε F5 στο πληκτρολόγιο.
Επιλέξτε το εικονίδιο του κάδου απορριμμάτων δίπλα σε μια καρτέλα, για παράδειγμα της Μαρίας:

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