Funcția de notificare

Se aplică pentru: planșă de lucru apps Model-driven apps Power Platform CLI

Afișează un mesaj banner către utilizator.

Descriere

Funcția Notificare afișează un mesaj banner pentru utilizator în partea de sus a ecranului. Notificarea rămâne până când utilizatorul o respinge sau expiră timpul de expirare, care este implicit de 10 secunde.

În funcție de tipul de mesaj, se utilizează o culoare și o pictogramă corespunzătoare. Tipul este specificat de al doilea argument al funcției:

Notă

Limita de caractere pentru funcția Notify este de 500 de caractere.

Argument NotificationType	Descriere
NotificationType.Error	Afișează mesajul ca o eroare.
NotificationType.Information (implicit)	Afișează mesajul ca fiind informativ.
NotificationType.Success	Afișează mesajul ca fiind reușit.
NotificationType.Warning	Afișează mesajul ca fiind o avertizare.

Mesajele sunt afișate atât atunci când autorizați aplicația, cât și când utilizatorii finali folosesc aplicația.

Notify poate fi folosită doar în formule comportamentale.

Notify poate fi asociat cu funcția IfError pentru detectarea și raportarea erorilor cu un mesaj de eroare particularizat.

Power Apps poate trimite, de asemenea, notificări push folosind un mecanism complet diferit de la Notify. Pentru mai multe informații, consultați Trimiteți o notificare în Power Apps.

Notify returnează întotdeauna true.

Notă: Această funcție a fost numită anterior ShowError când ar putea afișa doar mesaje de eroare.

Notă

Notify poate fi folosit în autonomă aplicație creată pe planșă, pagina personalizată și Power Fx comandă experiențe. Valorile implicite pentru NotificationType și Timeout variază în funcție de experiența în care este utilizat. Puteți specifica valorile pe care doriți să le setați pentru NotificationType și Timeout setându-le în mod explicit în Power Fx expresia dvs., iar aceste valori vor fi respectate indiferent de experiență.

Sintaxă

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

• Mesaj - Obligatoriu. Mesaj de afișat pentru utilizator.
• NotificationType - Opțional. Tipul mesajului de afișat din tabelul de mai sus. Valoarea implicită este NotificationType.Information.
• Timeout – Opțional. Număr de milisecunde de aștepta înainte de a respinge automat notificarea. Valoarea implicită este de 10 de secunde (sau de 10.000 de milisecunde). Notificarea este afișată pe termen nelimitat cu un Timeout de 0.

Exemple

Pas cu pas

1. Adăugați un control Buton la ecran.

2. Setați proprietatea OnSelect pentru Buton la această formulă:

   Notify( "Hello, World" )
   

3. Faceți clic sau apăsați butonul.

   De fiecare dată când se face clic pe buton, mesajul Salut, lume este afișat utilizatorului ca fiind informativ. Se anulează automat în 10 secunde (timeout implicit) dacă utilizatorul nu îl respinge sau apăsă din nou butonul.

   

4. Modificați tipul de mesaj pentru a indica o eroare. Adăugați un al doilea argument la formula noastră:

   Notify( "Hello, World", NotificationType.Error )
   

5. Faceți clic sau apăsați butonul.

   De fiecare dată când se face clic pe buton, mesajul Salut, lume este afișat utilizatorului ca fiind o eroare. Se anulează automat în 10 secunde (timeout implicit) dacă utilizatorul nu îl respinge sau apăsă din nou butonul.

   

6. Modificați tipul de mesaj pentru a indica o avertizare. Schimbați al doilea argument din formula noastră:

   Notify( "Hello, World", NotificationType.Warning, 4000 )
   

7. Faceți clic sau apăsați butonul.

   De fiecare dată când se face clic pe buton, mesajul Salut, lume este afișat utilizatorului ca fiind o avertizare. Se anulează automat în 4 secunde (4.000 de milisecunde) dacă utilizatorul nu îl respinge sau apăsă din nou butonul.

   

8. Modificați tipul de mesaj pentru a indica un succes. Schimbați al doilea argument din formula noastră:

   Notify( "Hello, World", NotificationType.Success, 0 )
   

9. Faceți clic sau apăsați butonul.

   De fiecare dată când se face clic pe buton, mesajul Salut, lume este afișat utilizatorului ca fiind un succes. Cu expirarea 0, notificarea va fi respinsă numai de către utilizator sau prin apăsarea din nou a butonului.