Funkcja Notify
Dotyczy:
Aplikacje kanwy Aplikacje oparte na modelu Power Platform CLI
Wyświetla komunikat baneru dla użytkownika.
Popis
Funkcja Notify wyświetla w górnej części ekranu komunikat baneru dla użytkownika. Powiadomienie pozostanie do momentu jego odwołania przez użytkownika lub wygaśnięcia limitu czasu, którego domyślnym ustawieniem jest 10 sekund.
W zależności od typu komunikatu jest używany odpowiedni kolor i ikona. Typ jest określany przez drugi argument funkcji:
Uwaga
Ograniczenie znaków dla funkcji Notify wynosi 500 znaków.
| Argument NotificationType | Opis |
|---|---|
| NotificationType.Error | Wyświetla komunikat o błędzie. |
| NotificationType.Information (domyślny) | Wyświetla komunikat informacyjny. |
| NotificationType.Success | Wyświetla komunikat z informacją o powodzeniu. |
| NotificationType.Warning | Wyświetla komunikat ostrzegawczy. |
Komunikaty są wyświetlane zarówno podczas tworzenia aplikacji, jak i podczas jej używania.
Funkcja Notify może być używana tylko w formułach zachowania.
Funkcję Notify można połączyć z funkcją IfError w celu wykrywania błędów i zgłaszania ich przy użyciu niestandardowego komunikatu o błędzie.
Power Apps może również wysyłać powiadomienia push, używając zupełnie innego mechanizmu z funkcji Notify. Aby uzyskać więcej informacji, zobacz artykuł Wysyłanie powiadomienia w Power Apps.
Funkcja Notify zawsze zwraca wartość prawda.
Uwaga: ta funkcja nosiła wcześniej nazwę ShowError, gdy umożliwiała tylko wyświetlanie komunikatów o błędach.
Uwaga
Powiadomienie może być używane w autonomicznej aplikacji kanwy, na niestandardowej stronie i interfejsach poleceń Power Fx. Wartości domyślne typu NotificationType i limitu czasu różnią się w zależności od działań, w których są używane. Można określić wartości, które mają być ustawione dla NotificationType i limitu czasu, jawnie ustawiając je w wyrażeniach Power Fx, a te wartości będą respektowane niezależnie od działania.
Składnia
Notify( Message [, NotificationType [ , Timeout ] ] )
- Wiadomość – wartość wymagana. Komunikat wyświetlany użytkownikowi.
- NotificationType – wartość opcjonalna. Typ komunikatu z powyższej tabeli, który będzie wyświetlany. Wartością domyślną jest NotificationType.Information.
- Timeout – opcjonalne. Liczba milisekund określająca czas oczekiwania przed automatycznym brakiem powiadomienia. Wartością domyślną jest 10 sekund lub (10 000 milisekund). Powiadomienie jest wyświetlane przez nieokreślony czas, jeśli limit czasu jest ustawiony na 0.
Przykłady
Krok po kroku
Dodaj kontrolkę Button do swojego ekranu.
Dla właściwości OnSelect przycisku ustaw Przycisk następującą formułę:
Notify( "Hello, World" )Kliknij lub naciśnij przycisk.
Każde kliknięcie przycisku spowoduje wyświetlenie użytkownikowi komunikatu informacyjnego Hello, World. Jest ono automatycznie usuwane w ciągu 10 sekund (domyślny limit czasu), jeśli użytkownik nie odrzuci go lub nie naciśnie ponownie przycisku.
Zmień typ komunikatu, aby informował o błędzie. Dodaj drugi argument do naszej formuły:
Notify( "Hello, World", NotificationType.Error )Kliknij lub naciśnij przycisk.
Teraz każde kliknięcie przycisku spowoduje wyświetlenie użytkownikowi komunikatu o błędzie Hello, World. Jest ono automatycznie usuwane w ciągu 10 sekund (domyślny limit czasu), jeśli użytkownik nie odrzuci go lub nie naciśnie ponownie przycisku.
Zmień typ komunikatu, aby wskazywał ostrzeżenie. Zmień drugi argument w naszej formule:
Notify( "Hello, World", NotificationType.Warning, 4000 )Kliknij lub naciśnij przycisk.
Teraz każde kliknięcie przycisku spowoduje wyświetlenie użytkownikowi komunikatu ostrzegawczego Hello, World. Jest ono automatycznie usuwane w ciągu 4 sekund (4000 milisekundy), jeśli użytkownik nie odrzuci go lub nie naciśnie ponownie przycisku.
Zmień typ komunikatu, aby informował o powodzeniu. Zmień drugi argument w naszej formule:
Notify( "Hello, World", NotificationType.Success, 0 )Kliknij lub naciśnij przycisk.
Teraz każde kliknięcie przycisku spowoduje wyświetlenie użytkownikowi komunikatu z informacją o powodzeniu Hello, World. Po upływie limitu czasu 0 użytkownik może zamknąć powiadomienie tylko przez użytkownika lub ponownie naciskając przycisk.
