Funció de notificació
S'aplica a:
Aplicacions de llenç Aplicacions Power Platform basades en models CLI
Mostra un missatge de bàner a l'usuari.
Descripció
La funció Notifica mostra un missatge de bàner a l'usuari a la part superior de la pantalla. La notificació roman fins que l'usuari la descarta o caduca el temps d'espera, que per defecte és de 10 segons.
S'utilitza un color i una icona adequats en funció del tipus de missatge. El tipus s'especifica amb el segon argument a la funció:
Nota
El límit de caràcters de la funció Notify és de 500 caràcters.
| Argument NotificationType | Descripció |
|---|---|
| NotificationType.Error | Mostra el missatge com a error. |
| NotificationType.Information (per defecte) | Mostra el missatge com a informació. |
| NotificationType.Success | Mostra el missatge com a correcte. |
| NotificationType.Warning | Mostra el missatge com a advertiment. |
Els missatges es mostren tant quan creeu l'aplicació com quan els usuaris finals l'utilitzen.
Notify només es pot utilitzar en fórmules de comportament.
Notify es pot associar a la funció IfError per detectar errors i informar-no amb un missatge d'error personalitzat.
El Power Apps també pot enviar notificacions push mitjançant un mecanisme totalment diferent de Notify. Per obtenir més informació, consulta Enviar una notificació a Power Apps.
Notify sempre retorna true.
Nota: Aquesta funció s'anomenava prèviament ShowError quan només podia mostrar missatges d'error.
Nota
Notificar es pot utilitzar en aplicacions de llenç independents, pàgines personalitzades i Power Fx experiències de comandament . Els valors per defecte de NotificationType i Timeout varien segons l'experiència en què s'utilitzi. Podeu especificar els valors que voleu establir per a NotificationType i Timeout establint-los explícitament a la vostra Power Fx expressió i aquests valors es respectaran independentment de l'experiència.
Sintaxi
Notify(Missatge, [NotificationType, [Temps d'espera]])
- Missatge: obligatori. Missatge que es mostrarà a l'usuari.
- NotificationType: opcional. Tipus de missatge que es mostrarà de la taula anterior. El valor per defecte és NotificationType.Information.
- Temps d'espera: opcional. Nombre de mil·lisegons que espereu abans que es tanqui automàticament la notificació. El valor per defecte és 10 segons (o 10.000 mil·lisegons). La notificació es mostra indefinidament amb un temps d'espera de 0.
Exemples
Pas a pas
Afegiu un control Botó a la pantalla.
Definiu la propietat OnSelect del Botó a la fórmula:
Notify( "Hello, World" )Feu clic o premeu el botó.
Cada vegada que es fa clic al botó, es mostra el missatge Hola món a l'usuari com a informació. Es descarta automàticament en 10 segons (temps d'espera per defecte) si l'usuari no el descarta o torna a prémer el botó.
Canvieu el tipus de missatge per indicar un error. Afegiu un segon argument a la fórmula:
Notify( "Hello, World", NotificationType.Error )Feu clic o premeu el botó.
Ara, cada vegada que es fa clic al botó, es mostra el missatge Hola món a l'usuari com a error. Es descarta automàticament en 10 segons (temps d'espera per defecte) si l'usuari no el descarta o torna a prémer el botó.
Canvieu el tipus de missatge per indicar un advertiment. Canvieu el segon argument a la fórmula:
Notify( "Hello, World", NotificationType.Warning, 4000 )Feu clic o premeu el botó.
Ara, cada vegada que es fa clic al botó, es mostra el missatge Hola món a l'usuari com a advertiment. Es descarta automàticament en 4 segons (4.000 mil·lisegons) si l'usuari no el descarta o torna a prémer el botó.
Canvieu el tipus de missatge per indicar que s'ha dut a terme correctament. Canvieu el segon argument a la fórmula:
Notify( "Hello, World", NotificationType.Success, 0 )Feu clic o premeu el botó.
Ara, cada vegada que es fa clic al botó, es mostra el missatge Hola món a l'usuari com a correcte. Amb un temps d'espera 0, la notificació només es tancarà si ho fa l'usuari o si torna a prémer el botó.
