Función de notificación

Artigo
03/22/2024

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.Error	Mostra a mensaxe como un erro.
NotificationType.Information (valor 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.

Notify só se pode usar en fórmulas de comportamento.

Notify pódese combinar coa función IfError para detectar e informar de 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, consulte Enviar unha notificación Power Apps.

Notify sempre evolve verdadeiro.

Nota: Esta función foi nomeada anteriormente ShowError cando só podía mostrar mensaxes de erro.

Nota

Notify 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, establecindoos explícitamente na túa Power Fx expresión e respectaranse estes valores independentemente da experiencia.

Sintaxe

Notify( Message [, NotificationType [ , Timeout ] ] )

Message – Obrigatorio. Mensaxe para mostrar ao usuario.
NotificationType – Opcional. Tipo da mensaxe que se mostrará na táboa anterior. O valor predeterminado é NotificationType.Information.
Timeout – 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.

Compartir por