Função Notify
Aplica-se a:
Aplicativos de tela CLI de aplicativos Power Platform controlados por modelo
Apresenta uma mensagem em faixa ao utilizador.
Description
A função Notify apresenta uma mensagem em faixa ao utilizador na parte superior do ecrã. A notificação permanece até que o utilizador a descarte 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:
Nota
O limite de caracteres para a função Notify é de 500 caracteres.
| Argumento NotificationType | Descrição |
|---|---|
| NotificationType.Error | Apresenta uma mensagem de erro. |
| NotificationType.Information (Padrão) | Apresenta a mensagem como informativa. |
| NotificationType.Success | Apresenta a mensagem como êxito. |
| NotificationType.Warning | Apresenta uma mensagem de aviso. |
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.
Notificar só pode ser usado em fórmulas de comportamento.
Notify pode ser emparelhado com a função IfError para detetar e relatar erros com 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.
Notify sempre retorna true.
Nota: esta função tinha anteriormente a designação ShowError, uma vez que só podia apresentar mensagens de erro.
Nota
A notificação pode ser utilizada na aplicação de tela autónoma, página personalizada e experiências de comandos do Power Fx . Os valores predefinidos para NotificationType e Timeout variam de acordo com a experiência em que são utilizados. Pode especificar os valores que pretende definir para NotificationType e Timeout definindo-os explicitamente na sua expressão do Power Fx, sendo que estes valores serão respeitados independentemente da experiência.
Sintaxe
Notificar( 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.
- Tempo limite – 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 é apresentada indefinidamente com um Timeout de 0.
Exemplos
Passo a passo
Adicione um controlo Button ao seu ecrã.
Defina a propriedade OnSelect do Botão como a fórmula:
Notify( "Hello, World" )Clique em ou prima o botão.
Sempre que se clicar no botão, será apresentada a mensagem informativa Hello, World ao utilizador. Descarta automaticamente em 10 segundos (tempo limite predefinido) se o utilizador não o descartar ou premir novamente o botão.
Altere o tipo de mensagem para indicar um erro. Adicione um segundo argumento à fórmula:
Notify( "Hello, World", NotificationType.Error )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. Descarta automaticamente em 10 segundos (tempo limite predefinido) se o utilizador não o descartar ou premir novamente o botão.
Altere o tipo de mensagem para indicar um aviso. Altere o segundo argumento da fórmula:
Notify( "Hello, World", NotificationType.Warning, 4000 )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. Descarta automaticamente em 4 segundos (4.000 milisegundos) se o utilizador não o descartar ou premir novamente o botão.
Altere o tipo de mensagem para indicar êxito. Altere o segundo argumento da fórmula:
Notify( "Hello, World", NotificationType.Success, 0 )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.
