Função Notify no Power Apps

• 02/28/2020
• 2 minutos para ler
• • g

Apresenta uma mensagem em faixa ao utilizador.

Descrição

A função Notify apresenta uma mensagem em faixa ao utilizador na parte superior do ecrã, sobrepondo-se ao que é atualmente apresentado. A notificação permanecerá até que o utilizador a descarte, outra notificação a substitua ou o tempo limite expire por predefinição de 10 segundos.

São utilizados uma cor e um ícone adequados, dependendo do tipo de mensagem. O tipo é especificado pelo segundo argumento da função:

São apresentadas mensagens no ambiente de criação da aplicação e quando os utilizadores finais estão a utilizar a sua aplicação.

A função Notify só pode ser utilizada em fórmulas de comportamento.

A função Notify pode ser utilizada em conjunto com a função IfError para detetar e comunicar erros através de uma mensagem de erro personalizada.

O Power Apps também pode enviar notificações push através de um mecanismo completamente diferente do da função Notify. Para mais informações, consulte Enviar uma notificação no Power Apps.

A função Notify devolve sempre resultados true.

Nota: esta função tinha anteriormente a designação ShowError, uma vez que só podia apresentar mensagens de erro.

Sintaxe

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

• Mensagem – Obrigatório. A mensagem a apresentar ao utilizador.
• NotificationType – Opcional. Tipo de mensagem a apresentar de acordo com a tabela acima. A predefinição é NotificationType.Information.
• Timeout – Opcional. Número de milissegundos a aguardar antes de dispensar automaticamente a notificação. O valor predefinido é 10 segundos (ou 10.000 milisegundos). A notificação será apresentada indefinidamente com um Tempo limite de 0.

Exemplos

Passo a passo

1. Adicione um controlo Botão ao seu ecrã.

2. Defina a propriedade OnSelect do Botão como a fórmula:

   Notify( "Hello, World" )
   

3. Clique em ou prima o botão.

   Sempre que se clicar no botão, será apresentada a mensagem informativa Hello, World ao utilizador. A mesma será descartada automaticamente em 10 segundos (tempo limite predefinido) se o utilizador não o fechar ou premir novamente o botão.

   

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

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

5. Clique em ou prima o botão.

   Agora, sempre que se clicar no botão, será apresentada a mensagem de erro Hello, World ao utilizador. A mesma será descartada automaticamente em 10 segundos (tempo limite predefinido) se o utilizador não o fechar ou premir novamente o botão.

   

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

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

7. Clique em ou prima o botão.

   Agora, sempre que se clicar no botão, será apresentada a mensagem de aviso Hello, World ao utilizador. A mesma será descartada automaticamente em 4 segundos (4000 milisegundos) se o utilizador não o fechar ou premir novamente o botão.

   

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

   Notify( "Hello, World", NotificationType.Success, 0 )
   

9. Clique em ou prima o botão.

   Agora, sempre que se clicar no botão, será apresentada a mensagem de êxito Hello, World ao utilizador. Com um tempo limite de 0, a notificação só será dispensada pelo utilizador ou premindo o botão novamente.