Udostępnij za pośrednictwem


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

  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.

    Środowisko tworzenia aplikacji z funkcją Button.OnSelect wywołującą funkcję Notify w celu wyświetlenia użytkownikowi komunikatu „Hello, World” w formie niebieskiego banera.

  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.

    Środowisko tworzenia aplikacji z funkcją Button.OnSelect wywołującą funkcję Notify w celu wyświetlenia użytkownikowi komunikatu „Hello, World” w formie czerwonego banera.

  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.

    Środowisko tworzenia aplikacji z funkcją Button.OnSelect wywołującą funkcję Notify w celu wyświetlenia użytkownikowi komunikatu „Hello, World” w formie pomarańczowego banera.

  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.

    Środowisko tworzenia aplikacji z funkcją Button.OnSelect wywołującą funkcję Notify w celu wyświetlenia użytkownikowi komunikatu „Hello, World” w formie zielonego banera.