Partilhar via


setNotification (referência da API do cliente)

Exibe uma mensagem de erro para o controle para indicar que os dados não são válidos. Quando esse método é usado, um ícone "X" vermelho aparece ao lado do controle. Nos clientes móveis do Dynamics 365, tocar no ícone exibirá a mensagem.

Observação

Certifique-se sempre de que o controlo com que está a utilizar setNotification está visível no formulário.

setNotification não retornará um erro se você usá-lo em um controle que está visível, mas está dentro de uma seção ou guia que não está visível. Ao salvar um registro setNotification será exibida uma mensagem na parte superior do formulário como um erro de validação. Se o controle não estiver visível porque está dentro de uma seção ou guia pai oculta, o usuário não poderá corrigir isso.

Tipos de controlo suportados

Tipos de controle padrão, pesquisa, escolhas e escolha.

Sintaxe

formContext.getControl(arg).setNotification(message,uniqueId);

Parâmetros

Nome Tipo Obrigatório Description
message String Yes A mensagem a ser exibida.
uniqueId String Não A ID a ser usada para limpar essa mensagem ao usar o método clearNotification .

Valor de retorno

Tipo: Booleano

Descrição: indica se o método foi bem-sucedido.

Observações

Definir uma notificação de erro em um controle impedirá que o formulário seja salvo.

adicionarNotificação
clearNotificação