Blank, Coalesce, IsBlankκαι IsEmpty συναρτήσεις

Functions	Ισχύει για
Blank	Εφαρμογές καμβά Copilot Studio Desktop ροές Στήλες τύπου Dataverse Εφαρμογές βάσει μοντέλου Συναρτήσεις του Power Platform CLI Dataverse
Coalesce IsEmpty	Εφαρμογές καμβά Copilot Studio Desktop ροές Εφαρμογές βάσει μοντέλου Συναρτήσεις Power Platform CLI Dataverse Στο Power Pages
IsBlank	Εφαρμογές καμβά Το Copilot Studio Desktop ροών στηλών τύπου Dataverse Εφαρμογές βάσει μοντέλου Συναρτήσεις του power Platform CLI Dataverse στο Power Pages

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

Επισκόπηση

BlankΤο είναι ένα σύμβολο κράτησης θέσης για "χωρίς τιμή" ή "άγνωστη τιμή". Για παράδειγμα, η ιδιότητα Selected ενός στοιχείου ελέγχου Σύνθετο πλαίσιο είναι κενή εάν ο χρήστης δεν έχει κάνει μια επιλογή. Πολλές προελεύσεις δεδομένων μπορούν να αποθηκεύουν και επιστρέφουν τιμές NULL, οι οποίες απεικονίζονται στο Power Apps ως κενές.

Οποιαδήποτε ιδιότητα ή υπολογιζόμενη τιμή στο Power Apps μπορεί να είναι κενή. Για παράδειγμα, μια δυαδική τιμή συνήθως έχει μία από δύο τιμές: true ή false. Επιπλέον αυτών των δύο, μπορεί επίσης να είναι κενή , υποδεικνύοντας ότι η κατάσταση δεν είναι γνωστή. Αυτό είναι παρόμοιο με αυτό που συμβαίνει στο Microsoft Excel, όπου ένα κελί σε ένα φύλλο εργασίας ξεκινά ως κενό χωρίς περιεχόμενα, αλλά μπορεί να τηρήσει τις τιμές TRUE ή FALSE (μεταξύ άλλων). Ανά πάσα στιγμή, τα περιεχόμενα του κελιού μπορούν να απαλειφθούν ξανά, επιστρέφοντάς το σε κατάσταση κενό.

Η κενή συμβολοσειρά αναφέρεται σε μια συμβολοσειρά που δεν περιέχει χαρακτήρες. Η συνάρτηση Len επιστρέφει μηδέν για μια τέτοια συμβολοσειρά και μπορεί να γραφτεί σε τύπους ως δύο διπλά εισαγωγικά χωρίς τίποτα ενδιάμεσα"". Ορισμένα στοιχεία ελέγχου και προελεύσεις δεδομένων χρησιμοποιούν μια κενή συμβολοσειρά για να υποδείξουν μια συνθήκη "χωρίς τιμή". Για να απλοποιηθεί η δημιουργία της εφαρμογής, οι IsBlank συναρτήσεις και Coalesce δοκιμάζουν τόσο για κενές τιμές είτε για κενές συμβολοσειρές.

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

Blank

Η Blank συνάρτηση επιστρέφει μια κενή τιμή. Χρησιμοποιήστε τη για την αποθήκευση μιας τιμής NULL σε μια προέλευση δεδομένων που υποστηρίζει αυτές τις τιμές, καταργώντας στην πραγματικότητα οποιαδήποτε τιμή από το πεδίο.

IsBlank

Η IsBlank συνάρτηση ελέγχει για μια κενή τιμή ή μια κενή συμβολοσειρά. Η δοκιμή περιλαμβάνει κενές συμβολοσειρές για τη διευκόλυνση της δημιουργίας εφαρμογών, καθώς ορισμένες προελεύσεις δεδομένων και στοιχεία ελέγχου χρησιμοποιούν μια κενή συμβολοσειρά όταν δεν υπάρχει τιμή. Για να ελέγξετε ειδικά για μια κενή τιμή, χρησιμοποιήστε if(Value = Blank(), ... αντί για IsBlank. Η IsBlank συνάρτηση θεωρεί τους κενούς πίνακες ως μη κενό και IsEmpty θα πρέπει να χρησιμοποιηθεί για τη δοκιμή ενός πίνακα.

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

Η τιμή επιστροφής για είναι IsBlank μια δυαδική τιμή true ή false.

Coalesce

Η Coalesce συνάρτηση αξιολογεί τα ορίσματά της με τη σειρά και επιστρέφει την πρώτη τιμή που δεν είναι κενή ή μια κενή συμβολοσειρά. Χρησιμοποιήστε αυτήν τη λειτουργία για την αντικατάσταση μιας κενής τιμής ή κενής συμβολοσειράς με διαφορετική τιμή, αλλά αφήστε μη κενές και μη κενές τιμές συμβολοσειράς αμετάβλητες. Εάν όλα τα ορίσματα είναι κενές ή κενές συμβολοσειρές, τότε η συνάρτηση επιστρέφει κενό, κάνοντας Coalesce έναν καλό τρόπο για να μετατρέψετε κενές συμβολοσειρές σε κενές τιμές.

Coalesce( value1, value2 ) είναι το πιο συνοπτικό ισοδύναμο και δεν απαιτεί If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) την αξιολόγηση των τιμών1 και τιμής2 δύο φορές. Η συνάρτηση If επιστρέφει κενό εάν δεν υπάρχει τύπος "else", όπως συμβαίνει εδώ.

Όλα τα ορίσματα πρέπει να Coalesce είναι του ίδιου τύπου. Για παράδειγμα, δεν μπορείτε να αναμίξετε αριθμούς με συμβολοσειρές κειμένου. Η τιμή επιστροφής από Coalesce το είναι αυτού του κοινού τύπου.

IsEmpty

Η IsEmpty συνάρτηση ελέγχει εάν ένας πίνακας περιέχει εγγραφές. Αντιστοιχεί στη χρήση της συνάρτησης CountRows και ελέγχει για μηδενικές τιμές. Μπορείτε να ελέγξετε για σφάλματα προέλευσης δεδομένων συνδυάζοντας IsEmpty με τη συνάρτηση Errors .

Η τιμή επιστροφής για IsEmpty είναι μια δυαδική τιμή true ή false.

Σύνταξη

Blank()

Coalesce( Value1 [, Value2, ... ] )

• Τιμές – Απαιτείται. Τιμές για έλεγχο. Κάθε τιμή αξιολογείται με τη σειρά μέχρι να βρεθεί μια τιμή που δεν είναι κενή και δεν βρέθηκε μια κενή συμβολοσειρά. Οι τιμές μετά από αυτό το σημείο δεν αξιολογούνται.

IsBlank( Τιμή )

• Τιμή – Απαιτείται. Τιμή για δοκιμή μιας κενής τιμής ή κενής συμβολοσειράς.

IsEmpty( Πίνακας )

• Πίνακας - Υποχρεωτικό. Ο πίνακας για έλεγχο καρτελών.

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

Blank

1. Δημιουργήστε μια εφαρμογή από την αρχή και προσθέστε ένα στοιχείο ελέγχου Button.

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

   ClearCollect( Cities, { Name: "Seattle", Weather: "Rainy" } )
   

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

4. Στο μενού Αρχείο, κάντε κλικ ή πατήστε Συλλογές.

   Η συλλογή Cities εμφανίζεται παρουσιάζοντας μία καρτέλα με "Seattle" και "Rainy":

   

5. Κάντε κλικ ή πατήστε το βέλος επιστροφής για να επιστρέψετε στον προεπιλεγμένο χώρο εργασίας.

6. Προσθέστε ένα στοιχείο ελέγχου Label και ορίστε την ιδιότητά του Text σε αυτόν τον τύπο:

   IsBlank( First( Cities ).Weather )
   

   Η ετικέτα εμφανίζει false καθώς το πεδίο Weather περιέχει μια τιμή ("Rainy").

7. Προσθέστε ένα δεύτερο κουμπί και ορίστε την ιδιότητά του OnSelect σε αυτόν τον τύπο:

   Patch( Cities, First( Cities ), { Weather: Blank() } )
   

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

   Το πεδίο Weather της πρώτης καρτέλας στη στήλη Cities αντικαθίσταται με κενό, καταργώντας την καταχώρηση "Rainy" που υπήρχε εκεί.

   

   Η ετικέτα εμφανίζει true καθώς το πεδίο Weather δεν περιέχει πλέον μια τιμή.

Coalesce

Τύπος	Περιγραφή	Αποτέλεσμα
Coalesce( ( Blank), 1 )	Ελέγχει την τιμή επιστροφής από τη Blank συνάρτηση, η οποία επιστρέφει πάντα μια κενή τιμή. Καθώς το πρώτο όρισμα είναι κενό, η αξιολόγηση συνεχίζει με το επόμενο όρισμα μέχρι να βρεθεί μια μη κενή τιμή και μη κενή συμβολοσειρά.	1
Coalesce( "", "2" )	Ελέγχει το πρώτο όρισμα, το οποίο είναι μια κενή συμβολοσειρά. Καθώς το πρώτο όρισμα είναι μια κενή συμβολοσειρά, η αξιολόγηση συνεχίζει με το επόμενο όρισμα μέχρι να βρεθεί μια μη κενή τιμή και μη κενή συμβολοσειρά.	2
Coalesce( ( Blank), "", Blank(), "", "3", "4" )	Coalesce Ξεκινά στην αρχή της λίστας ορισμάτων και αξιολογεί κάθε όρισμα διαδοχικά μέχρι να βρεθεί μια μη κενή τιμή και μια μη κενή συμβολοσειρά. Σε αυτή την περίπτωση, τα τέσσερα πρώτα ορίσματα επιστρέφουν όλα κενό ή μια κενή συμβολοσειρά, έτσι η αξιολόγηση συνεχίζει στο πέμπτο όρισμα. Το πέμπτο όρισμα είναι μη κενή και μη κενή συμβολοσειρά, επομένως η αξιολόγηση σταματά εδώ. Επιστρέφεται η τιμή του πέμπτου ορίσματος και το έκτο όρισμα δεν αξιολογείται.	3
Coalesce( "" )	Ελέγχει το πρώτο όρισμα, το οποίο είναι μια κενή συμβολοσειρά. Επειδή το πρώτο όρισμα είναι μια κενή συμβολοσειρά και δεν υπάρχουν άλλα ορίσματα, η συνάρτηση επιστρέφει κενή.	λευκός

IsBlank

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

2. Προσθέστε μια ετικέτα και ορίστε την ιδιότητα Text σε αυτόν τον τύπο:

   If( IsBlank( FirstName.Text ), "First Name is a required field." )
   

   Από προεπιλογή, η ιδιότητα Text ενός στοιχείου ελέγχου εισαγωγής κειμένου ορίζεται σε "Εισαγωγή κειμένου". Καθώς η ιδιότητα περιέχει μια τιμή, δεν είναι κενή και η ετικέτα δεν εμφανίζει οποιοδήποτε μήνυμα.

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

   Καθώς η ιδιότητα Text δεν περιέχει πλέον χαρακτήρες, είναι μια κενή συμβολοσειρά και IsBlank( FirstName.Text ) είναι true. Εμφανίζεται το μήνυμα υποχρεωτικού πεδίου.

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

Άλλα παραδείγματα:

Τύπος	Περιγραφή	Αποτέλεσμα
IsBlank( ( Blank) )	Ελέγχει την τιμή επιστροφής από τη Blank συνάρτηση, η οποία επιστρέφει πάντα μια κενή τιμή.	πιστός
IsBlank( "" )	Μια συμβολοσειρά που δεν περιέχει χαρακτήρες.	πιστός
IsBlank( "Hello" )	Μια συμβολοσειρά που περιέχει έναν ή περισσότερους χαρακτήρες.	ψεύτικος
IsBlank( AnyCollection )	Καθώς η συλλογή υπάρχει, δεν είναι κενή ακόμη και εάν δεν περιέχει καρτέλες. Για να ελέγξετε για μια κενή συλλογή, χρησιμοποιήστε τη συνάρτηση IsEmpty αντί για αυτό.	ψεύτικος
IsBlank( Mid( "Hello", 17, 2 ) )	Ο πρώτος χαρακτήρας για τη συνάρτηση Mid είναι πέρα από το τέλος της συμβολοσειράς. Το αποτέλεσμα είναι μια κενή συμβολοσειρά.	πιστός
IsBlank( If( false, false ) )	Μια συνάρτηση If χωρίς ElseResult. Καθώς η συνθήκη είναι πάντα false, αυτή η συνάρτηση If επιστρέφει πάντα κενό.	πιστός

IsEmpty

1. Δημιουργήστε μια εφαρμογή από την αρχή και προσθέστε ένα στοιχείο ελέγχου Button.

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

   Collect( IceCream, {Flavor: "Strawberry", Quantity: 300}, {Flavor: "Chocolate", Quantity: 100} )

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

   Δημιουργείται μια συλλογή με ονομασία IceCream και η οποία περιέχει αυτά τα δεδομένα:

   

   Αυτή η συλλογή έχει δύο καρτέλες και δεν είναι κενή. IsEmpty( Η συνάρτηση IceCream ) επιστρέφει false και η συνάρτηση CountRows( IceCream ) επιστρέφει 2.

4. Προσθέστε ένα δεύτερο κουμπί και ορίστε την ιδιότητά του OnSelect σε αυτόν τον τύπο:

   Clear( Παγωτό )

5. Κάντε προεπισκόπηση της εφαρμογής σας, κάντε κλικ ή πατήστε το δεύτερο κουμπί και, στη συνέχεια, κλείστε την προεπισκόπηση.

   Η συλλογή είναι τώρα κενή:

   

   Η συνάρτηση Clear καταργεί όλες τις καρτέλες από μια συλλογή, με αποτέλεσμα μια κενή συλλογή. IsEmpty( Η συνάρτηση IceCream ) επιστρέφει true και η συνάρτηση CountRows( IceCream ) επιστρέφει 0.

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

Τύπος	Περιγραφή	Αποτέλεσμα
IsEmpty( [ 1, 2, 3 ] )	Ο πίνακας μίας στήλης περιέχει τρεις καρτέλες και, επομένως, δεν είναι κενός.	ψεύτικος
IsEmpty( [ ] )	Ο πίνακας μίας στήλης δεν περιέχει καρτέλες και είναι κενός.	πιστός
IsEmpty( Filter( [ 1, 2, 3 ], Value > 5 ) )	Ο πίνακας μίας στήλης δεν περιέχει τιμές μεγαλύτερες από 5. Το αποτέλεσμα από το φιλτράρισμα δεν περιέχει καρτέλες και είναι κενό.	πιστός