Udostępnij przez


Funkcja Notify

Dotyczy: Aplikacje kanwy Aplikacje oparte na modelu — interfejs wiersza polecenia platformy Power Platform

Wyświetla komunikat baneru dla użytkownika.

Popis

Funkcja Notify wyświetla użytkownikowi w górnej części ekranu komunikat baneru. 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

Limit znaków dla Notify funkcji to 500 znaków.

Argument NotificationType Popis
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.

Notify można używać tylko w formułach zachowania.

Notify Funkcja IfError może być sparowana z funkcją IfError w celu wykrywania i zgłaszania błędów z niestandardowym komunikatem o błędzie.

Usługa Power Apps może również wysyłać powiadomienia wypychane przy użyciu zupełnie innego mechanizmu niż Notify. Aby uzyskać więcej informacji, zobacz artykuł Wysyłanie powiadomienia w Power Apps.

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

Notify można używać w autonomicznej aplikacji kanwy, niestandardowej stronie i środowiskach 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( Komunikat [, NotificationType [ , 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

  1. Dodaj kontrolkę Button do swojego ekranu.

  2. Dla właściwości OnSelect przycisku ustaw Przycisk następującą formułę:

    Notify( "Hello, World" )
    
  3. 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.

    W środowisku tworzenia pokazano wywołanie Notify elementu Button.OnSelect i wyświetlenie wynikowej wiadomości Hello, World jako niebieskiego baneru dla użytkownika.

  4. Zmień typ komunikatu, aby informował o błędzie. Dodaj drugi argument do naszej formuły:

    Notify( "Hello, World", NotificationType.Error )
    
  5. 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.

    W środowisku tworzenia pokazano wywołanie Notify elementu Button.OnSelect i wyświetlenie wynikowej wiadomości Hello, World jako czerwonego baneru dla użytkownika.

  6. Zmień typ komunikatu, aby wskazywał ostrzeżenie. Zmień drugi argument w naszej formule:

    Notify( "Hello, World", NotificationType.Warning, 4000 )
    
  7. 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.

    W środowisku tworzenia wyświetlane jest polecenie Button.OnSelect wywołujące Notify i wyświetlające wynikową wiadomość Hello, World jako pomarańczowy baner dla użytkownika.

  8. Zmień typ komunikatu, aby informował o powodzeniu. Zmień drugi argument w naszej formule:

    Notify( "Hello, World", NotificationType.Success, 0 )
    
  9. 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.

    W środowisku tworzenia pokazano polecenie Button.OnSelect wywołując i wyświetlając Notify wynikową wiadomość Hello, World jako zielony baner dla użytkownika.