addNotification (referència de l'API del client)

Mostra una notificació d'error o recomanació per a un control i us permet especificar accions per executar en funció de la notificació. Quan especifiqueu un tipus d'error de notificació, apareix una icona vermella "X" al costat del control. Quan especifiqueu un tipus de notificació de recomanació, apareix una icona "i" al costat del control. Als clients mòbils del Dynamics 365, toqueu la icona es mostrarà el missatge i us permetrà dur a terme l'acció configurada fent clic al botó Aplica o descartar el missatge.

Tipus de control admesos

Tot

Sintaxi

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

Paràmetres

Nom	Type	Necessari	Descripció
notification	Objecte	Sí	La notificació per afegir. Veure notification paràmetre

notification paràmetre

El notification paràmetre accepta un objecte amb les propietats següents

Nom	Type	Necessari	Descripció
actions	Matriu d'objectes	No	Veure actions propietat
messages	Matriu de cadenes	Sí	El missatge que es mostrarà a la notificació. A la versió actual, només es mostrarà el primer missatge especificat en aquesta matriu. La cadena que especifiqueu aquí apareix com a text en negreta a la notificació i normalment s'utilitza per al títol o l'assumpte de la notificació. Hauríeu de limitar el vostre missatge a 50 caràcters per obtenir una experiència d'usuari òptima.
notificationLevel	String	Sí	Defineix el tipus de notificació. Els valors vàlids són ERROR o RECOMMENDATION.
uniqueId	String	Sí	L'identificador que s'utilitzarà per esborrar aquesta notificació quan s'utilitza el mètode clearNotification.

actions propietat

La actions propietat conté una matriu d'objectes amb les propietats següents:

Nom	Type	Necessari	Descripció
message	String	No	El missatge del cos de la notificació que es mostrarà a l'usuari. Limiteu el vostre missatge a 100 caràcters per obtenir una experiència d'usuari òptima.
actions	Matriu de funcions	No	Les accions corresponents per al missatge.

Valor de retorn

Tipus: Booleà

Descripció: indica si el mètode s'ha realitzat correctament.

Observacions

Al client web, el mètode addNotification mostra una notificació amb els missatges que heu especificat i dos botons estàndard: Aplica i Descarta. Si feu clic a Aplica, s'executa l'acció que definiu; fent clic a Descarta es tanca el missatge de notificació.

A la interfície unificada:

• No hi ha cap botó Descarta.
• El botó Aplica només apareix quan el nivell de notificació està definit a RECOMANACIÓ, no a ERROR.

Exemple

El codi d'exemple següent mostra una notificació a la columna Nom del compte del formulari de compte per definir el símbol de cotització si la columna Nom del compte conté "Microsoft" i el símbol de cotització encara no està definit com a "MSFT". En fer clic a Aplica a la notificació, la columna Símbol de cotització s'establirà a "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");
}

Així es mostra la notificació a les aplicacions basades en models:

Articles relacionats

clearNotificació
setNotificació