Notify funció

S'aplica a: Aplicacions de llenç Aplicacions basades en models CLI del Power Platform

Mostra un missatge de bàner a l'usuari.

Descripció

La Notify funció 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 per a Notify la funció é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.

Notify només es pot utilitzar en fórmules de comportament.

Notify es pot emparellar 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 completament diferent del 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

Notify es pot utilitzar en aplicacions de llenç independents, pàgines personalitzades i experiències d'ordres del Power Fx . 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

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

1. Afegiu un control Botó a la pantalla.

2. Definiu la propietat OnSelect del Botó a la fórmula:

   Notify( "Hello, World" )
   

3. 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ó.

   

4. Canvieu el tipus de missatge per indicar un error. Afegiu un segon argument a la fórmula:

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

5. 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ó.

   

6. Canvieu el tipus de missatge per indicar un advertiment. Canvieu el segon argument a la fórmula:

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

7. 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ó.

   

8. 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 )
   

9. 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ó.