addNotification (kliendi API viide)

Kuvab juhtelemendi tõrke- või soovitusteatise ja võimaldab teatise põhjal määrata käivitatavad toimingud. Kui määrate teatise tõrketüübi, kuvatakse juhtelemendi kõrval punane ikoon "X". Kui määrate teatise soovitustüübi, kuvatakse juhtelemendi kõrval ikoon "i". Dynamics 365 mobiiliklientide puhul kuvatakse sõnum ikooni puudutamisel ja saate konfigureeritud toimingu sooritamiseks klõpsata nuppu Rakenda või sõnumi sulgeda.

Toetatud juhtelemenditüübid

Kõik

Süntaks

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

Parameetrid

Nimetus	Liik	Nõutav	Kirjeldus
notification	Ese	Ja	Lisatav teatis. Kuva notification parameeter

notification parameeter

Parameeter notification aktsepteerib järgmiste atribuutidega objekti

Nimetus	Liik	Nõutav	Kirjeldus
actions	Objektide massiiv	No	Kuva actions atribuut
messages	Stringide massiiv	Ja	Teatises kuvatav sõnum. Praeguses väljaandes kuvatakse ainult selles massiivis määratud esimene teade. Siin määratud string kuvatakse teatises paksus kirjas tekstina ja seda kasutatakse tavaliselt teatise pealkirja või teema jaoks. Optimaalse kasutuskogemuse saamiseks peaksite sõnumit piirama 50 märgiga.
notificationLevel	String	Ja	Määratleb teatise tüübi. Kehtivad väärtused on ERROR või RECOMMENDATION.
uniqueId	String	Ja	ID, mida kasutada selle teatise kustutamiseks meetodi clearNotification kasutamisel.

actions vara

actions Atribuut sisaldab objektide massiivi, millel on järgmised atribuudid.

Nimetus	Liik	Nõutav	Kirjeldus
message	String	No	Kasutajale kuvatava teatise kehateade. Optimaalse kasutuskogemuse saamiseks piirake oma sõnumit 100 märgiga.
actions	Funktsioonide massiiv	No	Sõnumi vastavad toimingud.

Tagastatav väärtus

Tüüp: kahendmuutuja

Kirjeldus. Näitab, kas meetod õnnestus.

Märkused

Veebikliendis kuvab lisamismeetod teie määratud sõnumite ja kahe standardnupuga teatise: Rakenda ja Sule. Nupu Rakenda klõpsamisel käivitatakse teie määratletud toiming; Nupu Sule klõpsamisel suletakse teatisesõnum.

Ühtses liideses:

• Nuppu Sule pole.
• Nupp Rakenda kuvatakse ainult siis, kui teatisetasemeks on seatud SOOVITUS, mitte TÕRGE.

Näide

Järgmine näidiskood kuvab teatise kontovormi veerus Konto nimi , et määrata tikseri sümbol , kui veerg Konto nimi sisaldab "Microsoft" ja kriipstähis pole veel "MSFT". Kui klõpsate teatises nuppu Rakenda , määratakse veeru Kriipssümbol väärtuseks "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");
}

Teatis kuvatakse mudelipõhistes rakendustes järgmiselt.

Seotud artiklid

clearNotification
setNotification