addNotification (kliento API nuoroda)

Rodo valdiklio klaidos arba rekomendacijos pranešimą ir leidžia nurodyti veiksmus, kuriuos reikia vykdyti, atsižvelgiant į pranešimą. Kai nurodote pranešimo klaidos tipą, šalia valdiklio rodoma raudona "X" piktograma. Kai nurodote rekomendacijos pranešimo tipą, šalia valdiklio rodoma piktograma "i". "Dynamics 365" mobiliesiems klientams bakstelėjus piktogramą bus rodomas pranešimas ir bus galima atlikti sukonfigūruotą veiksmą spustelint mygtuką Taikyti arba atmetant pranešimą.

Palaikomi valdiklių tipai

Visas

Sintaksė

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

Parametrus

Vardas, pavadinimas	Rūšis	Privalomas	Aprašą
notification	Daiktas	Taip	Pranešimas, kurį norite įtraukti. Žr.notification parametrą

notification Parametras

Parametras notification priima objektą su šiomis ypatybėmis

Vardas, pavadinimas	Rūšis	Privalomas	Aprašą
actions	Objektų masyvas	No	Peržiūrėti actions ypatybę
messages	Eilučių masyvas	Taip	Pranešimas, rodomas pranešime. Dabartiniame leidime bus rodomas tik pirmas šiame masyve nurodytas pranešimas. Čia nurodyta eilutė pranešime rodoma kaip paryškintasis tekstas ir paprastai naudojama pranešimo pavadinimui ar temai. Kad galėtumėte optimaliai naudoti, pranešimą turėtumėte apriboti iki 50 simbolių.
notificationLevel	String	Taip	Apibrėžia pranešimo tipą. Leidžiamos reikšmės yra ERROR arba RECOMMENDATION.
uniqueId	String	Taip	ID, naudojamas šiam pranešimui išvalyti naudojant metodą clearNotification.

actions nuosavybė

Ypatybėje actions yra objektų masyvas su šiomis ypatybėmis:

Vardas, pavadinimas	Rūšis	Privalomas	Aprašą
message	String	No	Pagrindinis pranešimas apie pranešimą, kuris bus rodomas vartotojui. Kad galėtumėte optimaliai naudoti, pranešimą apribokite iki 100 simbolių.
actions	Funkcijų masyvas	No	Atitinkami pranešimo veiksmai.

Grąžinimo reikšmė

Tipas: Bulio logika

Aprašas: nurodo, ar metodas pavyko.

Pastabos

Žiniatinklio kliente metodas addNotification rodo pranešimą su jūsų nurodytais pranešimais ir dviem standartiniais mygtukais: Taikyti ir Atmesti. Spustelėjus Taikyti vykdomas jūsų apibrėžtas veiksmas; spustelėjus Atsisakyti , uždaromas pranešimas.

Vieningojoje sąsajoje:

• Nėra mygtuko Atsisakyti .
• Mygtukas Taikyti rodomas tik tada, kai pranešimo lygis nustatytas kaip REKOMENDACIJA, o ne KLAIDA.

Pavyzdys

Toliau pateiktame kodo pavyzdyje rodomas pranešimas paskyros formos stulpelyje Paskyros pavadinimas , kad būtų galima nustatyti kurso simbolį , jei stulpelyje Paskyros pavadinimas yra "Microsoft", o kurso simbolis dar nenustatytas kaip "MSFT". Pranešime spustelėjus Taikyti , stulpelis Ticker Symbol bus nustatytas kaip 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");
}

Tai, kaip pranešimas rodomas modeliu pagrįstose programėlėse:

Susiję straipsniai

clearNotification
setNotification