Compartir por

addNotification (Referencia da API do cliente)

Mostra unha notificación de erro ou recomendación para un control e permítelle especificar as accións a executar en función da notificación. Cando especifica un tipo de notificación de erro, aparece unha icona vermella "X" xunto ao control. Cando especifica un tipo de recomendación de notificación, aparece unha icona "i" xunto ao control. Nos clientes móbiles de Dynamics 365, ao tocar a icona aparecerá a mensaxe e permitiralle realizar a acción configurada premendo no botón Aplicar ou descartar a mensaxe.

Tipos de control soportados

Todos

Sintaxe

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

Parámetros

Nome Tipo Obrigatorio Descripción
notification Obxecto Si A notificación a engadir. Ver notification parámetro

notification parámetro

O notification parámetro acepta un obxecto coas seguintes propiedades

Nome Tipo Obrigatorio Descripción
actions Matriz de obxectos Non Ver actions propiedade
messages Matriz de cadeas Si A mensaxe que se mostrará na notificación. Na versión actual, só se mostrará a primeira mensaxe especificada nesta matriz. A cadea que especifique aquí aparece como texto en letra grosa na notificación e utilízase normalmente para o título ou o asunto da notificación. Debes limitar a túa mensaxe a 50 caracteres para unha experiencia de usuario óptima.
notificationLevel String Si Define o tipo de notificación. Os valores válidos son ERROR ou RECOMMENDATION.
uniqueId String Si O ID a usar para borrar esta notificación ao usar o método clearNotification.

actions Propiedade

A propiedade actions contén unha matriz de obxectos coas seguintes propiedades:

Nome Tipo Obrigatorio Descripción
message String Non O corpo da mensaxe da notificación que se mostrará ao usuario. Limita a túa mensaxe a 100 caracteres para unha experiencia de usuario óptima.
actions Conxunto de funcións Non As accións correspondentes á mensaxe.

Valor devolto

Tipo: Booleano

Descrición: Indica se o método tivo éxito.

Comentarios

No cliente web, o método addNotification mostra unha notificación coas mensaxes especificadas e dous botóns estándar: Aplicar e Descartar. Ao premer en Aplicar , execútase a acción que defina. premendo en Descartar péchase a mensaxe de notificación.

Interface unificada:

  • Non hai botón de descarte .
  • O botón Aplicar só aparece cando o nivel de notificación está establecido en RECOMENDACIÓN, non en ERRO.

Exemplo

O seguinte código de exemplo mostra unha notificación na columna Nome da conta do formulario de conta para establecer o símbolo de ticker se a columna Nome da conta contén "Microsoft" e o símbolo de ticker non está xa establecido en "MSFT". Ao premer Aplicar na notificación, a columna Símbolo de Ticker será "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");
}

Así aparece a notificación nas aplicacións baseadas en modelos:

Exemplo de notificación.

Limpar a notificación
establecer notificación

  • Last updated on