Funkcja Notify
Dotyczy:
Aplikacje kanwy Aplikacje oparte na modelu Interfejs Power Platform wiersza polecenia aplikacji opartych na modelu
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ślnie) | 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.
Powiadamiaj może być używany tylko w formułach zachowań.
Notify można sparować z funkcją IfError , aby wykrywać i zgłaszać błędy za pomocą 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.
Opcja Notify zawsze zwraca wartość true.
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( Wiadomość [, TypPowiadomienia [ ; Limit czasu] ] )
- Wiadomość – wymagane. Komunikat wyświetlany użytkownikowi.
- Typ powiadomienia– Opcjonalny. Typ komunikatu z powyższej tabeli, który będzie wyświetlany. Wartością domyślną jest NotificationType.Information.
- Limit czasu– Opcjonalny. 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.
