Συνάρτηση Notify
Ισχύει για: Εφαρμογές καμβά Εφαρμογές Power Platform βάσει μοντέλου CLI
Εμφανίζει ένα πλαίσιο μηνύματος στον χρήστη.
Description
Η συνάρτηση Notify εμφανίζει ένα πλαίσιο μηνύματος στον χρήστη στο επάνω μέρος της οθόνης. Η ειδοποίηση παραμείνει μέχρι ο χρήστης να την απορρίψει ή να λήξει το χρονικό όριο που είναι 10 δευτερόλεπτα από προεπιλογή.
Ανάλογα με τον τύπο του μηνύματος χρησιμοποιείται κατάλληλο χρώμα και εικονίδιο. Ο τύπος καθορίζεται από το δεύτερο όρισμα της συνάρτησης:
Σημείωμα
Το όριο χαρακτήρων για τη συνάρτηση Notify είναι 500 χαρακτήρες.
Όρισμα NotificationType | Περιγραφή |
---|---|
NotificationType.Error | Εμφανίζει το μήνυμα ως σφάλμα. |
NotificationType.Information (προεπιλογή) | Εμφανίζει το μήνυμα ως ενημερωτικό μήνυμα. |
NotificationType.Success | Εμφανίζει το μήνυμα ως μήνυμα επιτυχίας. |
NotificationType.Warning | Εμφανίζει το μήνυμα ως προειδοποίηση. |
Τα μηνύματα εμφανίζονται κατά τη σύνταξη της εφαρμογής αλλά και όταν οι τελικοί χρήστες χρησιμοποιούν την εφαρμογή σας.
Η ειδοποίηση μπορεί να χρησιμοποιηθεί μόνο σε τύπους συμπεριφοράς.
Η ειδοποίηση μπορεί να συνδυαστεί με τη συνάρτηση IfError για τον εντοπισμό και την αναφορά σφαλμάτων με ένα προσαρμοσμένο μήνυμα σφάλματος.
Το Power Apps μπορεί επίσης να στέλνει ειδοποιήσεις push χρησιμοποιώντας έναν εντελώς διαφορετικό μηχανισμό από τη συνάρτηση Notify. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Αποστολή ειδοποίησης στο Power Apps.
Η επιλογή Ειδοποίηση επιστρέφει πάντα αληθές.
Σημείωση: Αυτή η συνάρτηση ονομαζόταν στο παρελθόν ShowError και μπορούσε να εμφανίζει μόνο μηνύματα σφάλματος.
Σημείωμα
Η ειδοποίηση μπορεί να χρησιμοποιηθεί σε αυτόνομες εφαρμογές καμβά, προσαρμοσμένες προσαρμοσμένη σελίδα και εμπειρίες εντολών Power Fx. Οι προεπιλεγμένες τιμές για τον NotificationType και το Timeout διαφέρουν ανάλογα με την εμπειρία στην οποία χρησιμοποιείται. Μπορείτε να καθορίσετε τις τιμές που θέλετε να ορίσετε για NotificationType και Timeout ορίζοντας τα ρητά στην παράσταση Power Fx και αυτές οι τιμές θα τηρούνται ανεξάρτητα από την εμπειρία.
Σύνταξη
Notify( Μήνυμα [; Τύπος_ειδοποίησης [ ; Λήξη χρονικού ορίου ] ] )
- Μήνυμα – Απαιτείται. Το μήνυμα που θα εμφανίζεται στον χρήστη.
- NotificationType – Προαιρετικό. Ο τύπος του μηνύματος που θα εμφανίζεται από τον παραπάνω πίνακα. Η προεπιλογή είναι NotificationType.Information.
- Λήξη χρονικού ορίου – Προαιρετικό. Ο αριθμός των χιλιοστών του δευτερολέπτου που πρέπει να περιμένετε πριν την αυτόματη απόρριψη της ειδοποίησης. Η προεπιλεγμένη τιμή είναι 10 δευτερόλεπτα ή (or 10.000 χλστ. δευτ.). Η ειδοποίηση εμφανίζεται επ' αόριστον με Χρονικό όριο 0.
Παραδείγματα
Βήμα προς βήμα
Προσθέστε ένα στοιχείο ελέγχου Button στην οθόνη σας.
Ορίστε την ιδιότητα OnSelect του Button στον τύπο:
Notify( "Hello, World" )
Κάντε κλικ ή πατήστε το κουμπί.
Κάθε φορά που γίνεται κλικ στο κουμπί, το μήνυμα Hello, World εμφανίζεται στον χρήστη ως ενημερωτικό μήνυμα. Απορρίπτεται αυτόματα σε 10 δευτερόλεπτα (προεπιλεγμένο χρονικό όριο) εάν ο χρήστης δεν το απορρίψει ή δεν πατήσει ξανά το κουμπί.
Αλλάξτε τον τύπο του μηνύματος για να δηλώνει σφάλμα. Προσθέστε ένα δεύτερο όρισμα στον τύπο:
Notify( "Hello, World", NotificationType.Error )
Κάντε κλικ ή πατήστε το κουμπί.
Τώρα, κάθε φορά που γίνεται κλικ στο κουμπί, το μήνυμα Hello, World εμφανίζεται στον χρήστη ως σφάλμα. Απορρίπτεται αυτόματα σε 10 δευτερόλεπτα (προεπιλεγμένο χρονικό όριο) εάν ο χρήστης δεν το απορρίψει ή δεν πατήσει ξανά το κουμπί.
Αλλάξτε τον τύπο του μηνύματος για να δηλώνει προειδοποίηση. Αλλάξτε το δεύτερο όρισμα του τύπου:
Notify( "Hello, World", NotificationType.Warning, 4000 )
Κάντε κλικ ή πατήστε το κουμπί.
Τώρα, κάθε φορά που γίνεται κλικ στο κουμπί, το μήνυμα Hello, World εμφανίζεται στον χρήστη ως προειδοποίηση. Απορρίπτεται αυτόματα σε 4 δευτερόλεπτα (4.000 χλστ. δευτ.) εάν ο χρήστης δεν το απορρίψει ή δεν πατήσει ξανά το κουμπί.
Αλλάξτε τον τύπο του μηνύματος για να δηλώνει επιτυχία. Αλλάξτε το δεύτερο όρισμα του τύπου:
Notify( "Hello, World", NotificationType.Success, 0 )
Κάντε κλικ ή πατήστε το κουμπί.
Τώρα, κάθε φορά που γίνεται κλικ στο κουμπί, το μήνυμα Hello, World εμφανίζεται στον χρήστη ως μήνυμα επιτυχίας. Με χρονικό όριο 0, η ειδοποίηση θα απορριφθεί μόνο από το χρήστη ή πατώντας ξανά το κουμπί.