Función de notificación
Aplícase a: Aplicacións de lenzo Aplicacións baseadas en modelos Power Platform CLI
Amosa unha mensaxe de faixa para o usuario.
Descripción
A función Notificar amosalle ao usuario unha mensaxe de banner na parte superior da pantalla. A notificación permanece ata que o usuario a descarte ou caduque o tempo de espera, que é por defecto de 10 segundos.
Utilízase unha cor e unha icona adecuadas dependendo do tipo da mensaxe. O segundo argumento especifica o tipo na función:
Nota
O límite de caracteres para a función Notify é de 500 caracteres.
Argumento NotificationType | Descripción |
---|---|
NotificationType.Erro | Mostra a mensaxe como un erro. |
NotificationType.Information (predeterminado) | Mostra a mensaxe como información. |
NotificationType.Success | Mostra a mensaxe como correcto. |
NotificationType.Warning | Mostra a mensaxe como unha advertencia. |
As mensaxes móstranse tanto ao autorizar a aplicación como cando os usuarios finais usan a súa aplicación.
Notificar só se pode usar nas fórmulas de comportamento.
Notify pódese vincular coa función IfError para detectar e informar erros cunha mensaxe de erro personalizada.
Power Apps tamén pode enviar notificacións push mediante un mecanismo completamente diferente de Notify. Para obter máis información, consulta Enviar unha notificación en Power Apps.
Notificar sempre devolve true.
Nota: Esta función foi nomeada anteriormente ShowError cando só podía mostrar mensaxes de erro.
Nota
Notificación pódese usar na aplicación de lenzo autónoma, páxina personalizada e Power Fx comando experiencias. Os valores predeterminados de NotificationType e Timeout varían segundo a experiencia na que se usa. Podes especificar os valores que queres definir para NotificationType e Timeout, establecéndoos explícitamente na túa Power Fx expresión e respectaranse estes valores independentemente da experiencia.
Sintaxe
Notificar( Mensaxe [, Tipo de notificación [, Tempo de espera ] ] )
- Mensaxe – Obrigatorio. Mensaxe para mostrar ao usuario.
- NotificationType – Opcional. Tipo da mensaxe que se mostrará na táboa anterior. O valor predeterminado é NotificationType.Information.
- Tempo de espera – Opcional. Número de milisegundos que se vai agardar antes de omitir automaticamente a notificación. O valor predefinido son 10 segundos (ou 10.000 milisegundos). A notificación móstrase indefinidamente cun Tempo de espera de 0.
Exemplos
Paso a paso
Engada un control de botón á pantalla.
Axuste a propiedade OnSelect do botón na fórmula:
Notify( "Hello, World" )
Faga clic ou prema o botón.
Cada vez que se fai clic no botón, a mensaxe Hello, World móstrase ao usuario como informativo. Descartarase automaticamente en 10 segundos (tempo de espera predeterminado) se o usuario non o desbota ou preme de novo o botón.
Cambia o tipo de mensaxe para indicar un erro. Engada un segundo argumento á nosa fórmula:
Notify( "Hello, World", NotificationType.Error )
Faga clic ou prema o botón.
Agora cada vez que se fai clic no botón, a mensaxe Hello, World móstrase ao usuario como un erro. Descartarase automaticamente en 10 segundos (tempo de espera predeterminado) se o usuario non o desbota ou preme de novo o botón.
Cambie o tipo de mensaxe para indicar unha advertencia. Cambie o segundo argumento na nosa fórmula:
Notify( "Hello, World", NotificationType.Warning, 4000 )
Faga clic ou prema o botón.
Agora cada vez que se fai clic no botón, a mensaxe Hello, World móstrase ao usuario como unha advertencia. Descártao automaticamente en 4 segundos (4.000 milisegundos) se o usuario non o descarta ou volve pulsar o botón.
Cambia o tipo de mensaxe para indicar un éxito. Cambie o segundo argumento na nosa fórmula:
Notify( "Hello, World", NotificationType.Success, 0 )
Faga clic ou prema o botón.
Agora cada vez que se fai clic no botón, a mensaxe Hello, World móstrase ao usuario como un éxito. Cun tempo de espera de 0, a notificación só se omitirá polo usuario ou ao premer o botón de novo.