Funció de notificació
S'aplica a:
Aplicacions de llenç CLI d'aplicacions Power Platform basades en models
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ó es manté 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ó |
|---|---|
| Tipus de notificació.Error | Mostra el missatge com a error. |
| NotificationType.Information (per defecte) | Mostra el missatge com a informació. |
| Tipus de notificació.Èxit | 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.
La notificació només es pot utilitzar en fórmules de comportament.
La notificació es pot combinar amb la funció IfError per detectar i informar d'errors 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ó, vegeu 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
La notificació es pot utilitzar en aplicacions de llenç independents, pàgines personalitzades i Power Fx experiències d'ordres . Els valors per defecte de NotificationType i Timeout varien segons l'experiència en què s'utilitza. Podeu especificar els valors que voleu definir 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
Notifica(Missatge[, Tipus de notificació[ , 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 tanca automàticament en 10 segons (temps d'espera predeterminat) 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 tanca automàticament en 10 segons (temps d'espera predeterminat) 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 tanca 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ó.
