Partilhar via

addNotification (referência da API do cliente)

Exibe uma notificação de erro ou recomendação para um controle e permite especificar ações a serem executadas com base na notificação. Quando você especifica um tipo de erro de notificação, um ícone "X" vermelho aparece ao lado do controle. Quando você especifica um tipo de recomendação de notificação, um ícone "i" aparece ao lado do controle. Nos clientes móveis do Dynamics 365, tocar no ícone exibirá a mensagem e permitirá que você execute a ação configurada clicando no botão Aplicar ou descartando a mensagem.

Tipos de controlo suportados

Todos

Sintaxe

formContext.getControl(arg).addNotification(notification);

Parâmetros

Nome Tipo Obrigatório Description
notification Objeto Yes A notificação a adicionar. Ver notification parâmetro

parâmetro notification

O notification parâmetro aceita um objeto com as seguintes propriedades:

Nome Tipo Obrigatório Description
actions Matriz de objetos Não Ver actions propriedade
messages Matriz de cadeias de caracteres Yes A mensagem a ser exibida na notificação. Na versão atual, somente a primeira mensagem especificada nesta matriz será exibida. A cadeia de caracteres especificada aqui aparece como texto em negrito na notificação e normalmente é usada para título ou assunto da notificação. Você deve limitar sua mensagem a 50 caracteres para uma experiência de usuário ideal.
notificationLevel String Yes Define o tipo de notificação. Os valores válidos são ERROR ou RECOMMENDATION.
uniqueId String Yes A ID a ser usada para limpar essa notificação ao usar o método clearNotification.

actions propriedade

A actions propriedade contém uma matriz de objetos com as seguintes propriedades:

Nome Tipo Obrigatório Description
message String Não A mensagem do corpo da notificação a ser exibida para o usuário. Limite sua mensagem a 100 caracteres para uma experiência de usuário ideal.
actions Matriz de funções Não As ações correspondentes para a mensagem.

Valor de retorno

Tipo: Booleano

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

Observações

No web client, o método addNotification exibe uma notificação com as mensagens especificadas e dois botões padrão: Aplicar eDescartar. Clicar em Aplicar executa a ação que você definir; clicar em Dispensar fecha a mensagem de notificação.

Na interface unificada:

  • Não existe um botão Dispensar .
  • O botão Aplicar só aparece quando o nível de notificação está definido como RECOMENDAÇÃO, não ERRO.

Example

O código de exemplo a seguir exibe uma notificação na coluna Nome da Conta do formulário de conta para definir o Símbolo do Ticker se a coluna Nome da Conta contiver "Microsoft" e o símbolo do ticker ainda não estiver definido como "MSFT". Clicar em Aplicar na notificação definirá a coluna Símbolo do Ticker como "MSFT".

function addTickerSymbolRecommendation(executionContext) {
    var formContext = executionContext.getFormContext();
    var myControl = formContext.getControl('name');
    var accountName = formContext.data.entity.attributes.get('name');
    var tickerSymbol = formContext.data.entity.attributes.get('tickersymbol');

    if (accountName.getValue() == 'Microsoft' && tickerSymbol.getValue() != 'MSFT') {
        var actionCollection = {
            message: 'Set the Ticker Symbol to MSFT?',
            actions: null
        };

        actionCollection.actions = [function () {
            tickerSymbol.setValue('MSFT');
            myControl.clearNotification('my_unique_id');
        }];

        myControl.addNotification({
            messages: ['Set Ticker Symbol'],
            notificationLevel: 'RECOMMENDATION',
            uniqueId: 'my_unique_id',
            actions: [actionCollection]
        });
    }
    else
        console.log("Notification not set");
}

É assim que a notificação aparece em aplicativos controlados por modelo:

Exemplo: adicionar notificação.

clearNotificação
setNotification

  • Last updated on