Funcția de notificare
Se aplică pentru:
planșă de lucru apps Aplicații bazate pe model 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 utilizat numai în formule de comportament.
Notify poate fi asociat cu funcția IfError pentru a detecta și raporta erori cu un mesaj de eroare personalizat.
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.
Notificare returnează întotdeauna adevărat.
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 explicit în Power Fx expresia dvs., iar aceste valori vor fi respectate indiferent de experiență.
Sintaxă
Notificare( 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
Adăugați un control Buton la ecran.
Setați proprietatea OnSelect pentru Buton la această formulă:
Notify( "Hello, World" )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.
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 )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.
Modificați tipul de mesaj pentru a indica o avertizare. Schimbați al doilea argument din formula noastră:
Notify( "Hello, World", NotificationType.Warning, 4000 )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.
Modificați tipul de mesaj pentru a indica un succes. Schimbați al doilea argument din formula noastră:
Notify( "Hello, World", NotificationType.Success, 0 )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.
