Συνάρτηση Notify

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

Εμφανίζει ένα πλαίσιο μηνύματος στον χρήστη.

Description

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

Ανάλογα με τον τύπο του μηνύματος χρησιμοποιείται κατάλληλο χρώμα και εικονίδιο. Ο τύπος καθορίζεται από το δεύτερο όρισμα της συνάρτησης:

Σημείωμα

Το όριο χαρακτήρων για τη συνάρτηση Notify είναι 500 χαρακτήρες.

Όρισμα NotificationType Περιγραφή
NotificationType.Error Εμφανίζει το μήνυμα ως σφάλμα.
NotificationType.Information (Προεπιλογή) Εμφανίζει το μήνυμα ως ενημερωτικό μήνυμα.
NotificationType.Success Εμφανίζει το μήνυμα ως μήνυμα επιτυχίας.
NotificationType.Warning Εμφανίζει το μήνυμα ως προειδοποίηση.

Τα μηνύματα εμφανίζονται κατά τη σύνταξη της εφαρμογής αλλά και όταν οι τελικοί χρήστες χρησιμοποιούν την εφαρμογή σας.

Η συνάρτηση Notify μπορεί να χρησιμοποιηθεί αποκλειστικά σε τύπους συμπεριφοράς.

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

Το Power Apps μπορεί επίσης να στέλνει ειδοποιήσεις push χρησιμοποιώντας έναν εντελώς διαφορετικό μηχανισμό από τη συνάρτηση Notify. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Αποστολή ειδοποίησης στο Power Apps.

Η συνάρτηση Notify επιστρέφει πάντα true.

Σημείωση: Αυτή η συνάρτηση ονομαζόταν στο παρελθόν ShowError και μπορούσε να εμφανίζει μόνο μηνύματα σφάλματος.

Σημείωμα

Η ειδοποίηση μπορεί να χρησιμοποιηθεί σε αυτόνομες εφαρμογές καμβά, προσαρμοσμένες προσαρμοσμένη σελίδα και εμπειρίες εντολών Power Fx. Οι προεπιλεγμένες τιμές για τον NotificationType και το Timeout διαφέρουν ανάλογα με την εμπειρία στην οποία χρησιμοποιείται. Μπορείτε να καθορίσετε τις τιμές που θέλετε να ορίσετε για NotificationType και Timeout ορίζοντας τα ρητά στην παράσταση Power Fx και αυτές οι τιμές θα τηρούνται ανεξάρτητα από την εμπειρία.

Σύνταξη

Notify( Message [, NotificationType [ , Timeout ] ] )

  • Message – Απαιτείται. Το μήνυμα που θα εμφανίζεται στον χρήστη.
  • NotificationType – Προαιρετικό. Ο τύπος του μηνύματος που θα εμφανίζεται από τον παραπάνω πίνακα. Η προεπιλογή είναι NotificationType.Information.
  • Timeout – Προαιρετικό. Ο αριθμός των χιλιοστών του δευτερολέπτου που πρέπει να περιμένετε πριν την αυτόματη απόρριψη της ειδοποίησης. Η προεπιλεγμένη τιμή είναι 10 δευτερόλεπτα ή (or 10.000 χλστ. δευτ.). Η ειδοποίηση εμφανίζεται επ' αόριστον με Χρονικό όριο 0.

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

Βήμα προς βήμα

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

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

    Notify( "Hello, World" )
    
  3. Κάντε κλικ ή πατήστε το κουμπί.

    Κάθε φορά που γίνεται κλικ στο κουμπί, το μήνυμα Hello, World εμφανίζεται στον χρήστη ως ενημερωτικό μήνυμα. Απορρίπτεται αυτόματα σε 10 δευτερόλεπτα (προεπιλεγμένο χρονικό όριο) εάν ο χρήστης δεν το απορρίψει ή δεν πατήσει ξανά το κουμπί.

    Στο περιβάλλον σύνταξης, η Button.OnSelect που καλεί τη Notify και εμφανίζει το μήνυμα Hello, World που προκύπτει ως μπλε πλαίσιο μηνύματος για τον χρήστη.

  4. Αλλάξτε τον τύπο του μηνύματος για να δηλώνει σφάλμα. Προσθέστε ένα δεύτερο όρισμα στον τύπο:

    Notify( "Hello, World", NotificationType.Error )
    
  5. Κάντε κλικ ή πατήστε το κουμπί.

    Τώρα, κάθε φορά που γίνεται κλικ στο κουμπί, το μήνυμα Hello, World εμφανίζεται στον χρήστη ως σφάλμα. Απορρίπτεται αυτόματα σε 10 δευτερόλεπτα (προεπιλεγμένο χρονικό όριο) εάν ο χρήστης δεν το απορρίψει ή δεν πατήσει ξανά το κουμπί.

    Στο περιβάλλον σύνταξης, η Button.OnSelect που καλεί τη Notify και εμφανίζει το μήνυμα Hello, World που προκύπτει ως κόκκινο πλαίσιο μηνύματος για τον χρήστη.

  6. Αλλάξτε τον τύπο του μηνύματος για να δηλώνει προειδοποίηση. Αλλάξτε το δεύτερο όρισμα του τύπου:

    Notify( "Hello, World", NotificationType.Warning, 4000 )
    
  7. Κάντε κλικ ή πατήστε το κουμπί.

    Τώρα, κάθε φορά που γίνεται κλικ στο κουμπί, το μήνυμα Hello, World εμφανίζεται στον χρήστη ως προειδοποίηση. Απορρίπτεται αυτόματα σε 4 δευτερόλεπτα (4.000 χλστ. δευτ.) εάν ο χρήστης δεν το απορρίψει ή δεν πατήσει ξανά το κουμπί.

    Στο περιβάλλον σύνταξης, η Button.OnSelect που καλεί τη Notify και εμφανίζει το μήνυμα Hello, World που προκύπτει ως πορτοκαλί πλαίσιο μηνύματος για τον χρήστη.

  8. Αλλάξτε τον τύπο του μηνύματος για να δηλώνει επιτυχία. Αλλάξτε το δεύτερο όρισμα του τύπου:

    Notify( "Hello, World", NotificationType.Success, 0 )
    
  9. Κάντε κλικ ή πατήστε το κουμπί.

    Τώρα, κάθε φορά που γίνεται κλικ στο κουμπί, το μήνυμα Hello, World εμφανίζεται στον χρήστη ως μήνυμα επιτυχίας. Με χρονικό όριο 0, η ειδοποίηση θα απορριφθεί μόνο από το χρήστη ή πατώντας ξανά το κουμπί.

    Στο περιβάλλον σύνταξης, η Button.OnSelect που καλεί τη Notify και εμφανίζει το μήνυμα Hello, World που προκύπτει ως πράσινο πλαίσιο μηνύματος για τον χρήστη.