Compartir por


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

  1. Engada un control de botón á pantalla.

  2. Axuste a propiedade OnSelect do botón na fórmula:

    Notify( "Hello, World" )
    
  3. 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.

    No ambiente de creación, mostrar Button.OnSelect chamando Notify e amosar a mensaxe Hello, World resultante como mensaxe de faixa azul para o usuario.

  4. Cambia o tipo de mensaxe para indicar un erro. Engada un segundo argumento á nosa fórmula:

    Notify( "Hello, World", NotificationType.Error )
    
  5. 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.

    No ambiente de creación, mostrar Button.OnSelect chamando Notify e amosar a mensaxe Hello, World resultante como mensaxe de faixa vermella para o usuario.

  6. Cambie o tipo de mensaxe para indicar unha advertencia. Cambie o segundo argumento na nosa fórmula:

    Notify( "Hello, World", NotificationType.Warning, 4000 )
    
  7. 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.

    No ambiente de creación, mostrar Button.OnSelect chamando Notify e amosar a mensaxe Hello, World resultante como mensaxe de faixa laranxa para o usuario.

  8. Cambia o tipo de mensaxe para indicar un éxito. Cambie o segundo argumento na nosa fórmula:

    Notify( "Hello, World", NotificationType.Success, 0 )
    
  9. 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.

    No ambiente de creación, mostrar Button.OnSelect chamando Notify e amosar a mensaxe Hello, World resultante como mensaxe de faixa verde para o usuario.