Compartilhar via


Função Notify

Aplica-se a: Aplicativos Canvas Aplicativos baseados em modelo Power Platform CLI

Exibe uma mensagem de faixa para o usuário.

Description

A função Notificar exibe uma mensagem da faixa ao usuário na parte superior da tela. A notificação permanece até que o usuário a descarte, outra notificação a substituirá, ou o tempo limite expirará, cujo padrão é 10 segundos.

Uma cor e um ícone apropriados são usados dependendo do tipo da mensagem. O tipo é especificado pelo segundo argumento para a função:

Nota

O limite de caracteres para a função Notify é de 500 caracteres.

Argumento NotificationType Descrição
Tipo de notificação.Erro Exibe a mensagem como um erro.
NotificationType.Information (Padrão) Exibe a mensagem como informativa.
Tipo de notificação.Sucesso Exibe a mensagem como êxito.
Tipo de notificação.Aviso Exibe a mensagem como um aviso.

As mensagens são exibidas enquanto você cria o aplicativo e quando os usuários finais estão usando o aplicativo.

Notify só pode ser usado em fórmulas de comportamento.

Notify pode ser pareado com a função IfError para detectar e relatar erros com uma mensagem de erro personalizada.

O Power Apps também pode enviar notificações por push usando um mecanismo completamente diferente de Notify. Para obter mais informações, consulte Enviar uma notificação no Power Apps.

Notify sempre retorna true.

Observação: anteriormente essa função era chamada ShowError quando ela só podia exibir mensagens de erro.

Observação

A notificação pode ser usada nas experiências do aplicativo de tela autônomo, página personalizada e comandos do Power Fx. Os valores padrão para NotificationType e Timeout variam de acordo com a experiência em que são usados. Você pode especificar os valores que deseja definir para NotificationType e Timeout definindo-os explicitamente em sua expressão do Power Fx e esses valores serão respeitados independentemente da experiência.

Sintaxe

Notificar( Mensagem [, Tipo de Notificação [, Tempo Limite ] ] )

  • Mensagem – Obrigatório. Mensagem a ser exibida ao usuário.
  • NotificationType – Opcional. O tipo de mensagem a ser exibido na tabela acima. O padrão é NotificationType.Information.
  • Tempo limite – Opcional. Número de milissegundos a aguardar antes de ignorar automaticamente a notificação. O padrão é 10 segundos (ou 10.000 milissegundos). A notificação é exibida indefinidamente com um Tempo limite de 0.

Exemplos

Passo a passo

  1. Adicione um controle Button na tela.

  2. Defina a propriedade OnSelect do Button como a fórmula:

    Notify( "Hello, World" )
    
  3. Clique no botão ou pressione-o.

    Cada vez que o botão é clicado, a mensagem Olá, Mundo é exibida ao usuário como informativa. Ela será descartada automaticamente em 10 segundos (tempo limite padrão) se o usuário não descartá-la ou pressionar o botão novamente.

    No ambiente de criação, mostrando Button.OnSelect chamando Notify e exibindo a mensagem Olá, Mundo resultante como uma mensagem de faixa azul para o usuário.

  4. Altere o tipo de mensagem para indicar um erro. Adicione um segundo argumento à nossa fórmula:

    Notify( "Hello, World", NotificationType.Error )
    
  5. Clique no botão ou pressione-o.

    Agora cada vez que o botão é clicado, a mensagem Olá, Mundo é exibida ao usuário como um erro. Ela será descartada automaticamente em 10 segundos (tempo limite padrão) se o usuário não descartá-la ou pressionar o botão novamente.

    No ambiente de criação, mostrando Button.OnSelect chamando Notify e exibindo a mensagem Olá, Mundo resultante como uma mensagem de faixa vermelha para o usuário.

  6. Altere o tipo de mensagem para indicar um aviso. Altere o segundo argumento em nossa fórmula:

    Notify( "Hello, World", NotificationType.Warning, 4000 )
    
  7. Clique no botão ou pressione-o.

    Agora cada vez que o botão é clicado, a mensagem Olá, Mundo é exibida ao usuário como um aviso. Ela será descartada automaticamente em 4 segundos (4.000 milissegundos) se o usuário não descartá-la ou pressionar o botão novamente.

    No ambiente de criação, mostrando Button.OnSelect chamando Notify e exibindo a mensagem Olá, Mundo resultante como uma mensagem de faixa laranja para o usuário.

  8. Altere o tipo de mensagem para indicar êxito. Altere o segundo argumento em nossa fórmula:

    Notify( "Hello, World", NotificationType.Success, 0 )
    
  9. Clique no botão ou pressione-o.

    Agora cada vez que o botão é clicado, a mensagem Olá, Mundo é exibida ao usuário como êxito. Com um tempo limite de 0, a notificação só será descartada pelo usuário ou pressionando o botão novamente.

    No ambiente de criação, mostrando Button.OnSelect chamando Notify e exibindo a mensagem Olá, Mundo resultante como uma mensagem de faixa verde para o usuário.