addNotification (klienta API atsauce)

Parāda kļūdas vai ieteikuma paziņojumu vadīklai un ļauj norādīt darbības, kas jāizpilda, pamatojoties uz paziņojumu. Norādot paziņojuma kļūdas tipu, blakus vadīklai tiek parādīta sarkana ikona "X". Norādot ieteikuma paziņojuma veidu, blakus vadīklai tiek parādīta ikona "i". Dynamics 365 mobilajos klientos, pieskaroties ikonai, tiks parādīts ziņojums un varēsiet veikt konfigurēto darbību, noklikšķinot uz pogas Lietot vai noraidīt ziņojumu.

Atbalstītie vadīklu veidi

Viss

Sintakse

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

Parameters

Nosaukums/vārds	Tips	Nepieciešams	Apraksts
notification	Objektu	Jā	Paziņojums par pievienošanu. Skatīt notification parametru

notification Parametru

Parametrs notification akceptē objektu ar šādiem rekvizītiem

Nosaukums/vārds	Tips	Nepieciešams	Apraksts
actions	Objektu masīvs	Nē	Skatīt actions naktsmītni
messages	Stīgu masīvs	Jā	Ziņojums, kas jāparāda paziņojumā. Pašreizējā laidienā tiks parādīts tikai pirmais ziņojums, kas norādīts šajā masīvā. Šeit norādītā virkne paziņojumā tiek rādīta treknrakstā, un to parasti izmanto paziņojuma virsrakstam vai tēmai. Lai nodrošinātu optimālu lietotāja pieredzi, ziņojuma garums ir jāierobežo līdz 50 rakstzīmēm.
notificationLevel	String	Jā	Definē paziņojuma veidu. Derīgas vērtības ir ERROR vai RECOMMENDATION.
uniqueId	String	Jā	ID, kas jāizmanto, lai notīrītu šo paziņojumu, izmantojot clearNotification metodi.

actions īpašums

Rekvizīts actions satur objektu masīvu ar šādiem rekvizītiem:

Nosaukums/vārds	Tips	Nepieciešams	Apraksts
message	String	Nē	Lietotājam parādāmā paziņojuma pamatziņojums. Ierobežojiet ziņojumu līdz 100 rakstzīmēm, lai nodrošinātu optimālu lietotāja pieredzi.
actions	Funkciju masīvs	Nē	Atbilstošās ziņojuma darbības.

Atgrieztā vērtība

Tips: Būla

Apraksts: norāda, vai metode ir veiksmīga.

Piezīmes

Tīmekļa klientā addNotification metode parāda paziņojumu ar norādītajiem ziņojumiem un divām standarta pogām: Lietot un Noraidīt. Noklikšķinot uz Lietot , tiek izpildīta jūsu definētā darbība; noklikšķinot uz Noraidīt , tiek aizvērts paziņojuma ziņojums.

Vienotajā interfeisā:

• Nav pogas Noraidīt .
• Poga Apply tiek parādīta tikai tad, ja paziņojumu līmenis ir iestatīts uz RECOMMENDATION, nevis ERROR.

Piemērs

Tālāk sniegtajā koda paraugā konta veidlapas kolonnā Konta nosaukums tiek parādīts paziņojums, lai iestatītu rādītāja simbolu , ja kolonnā Konta nosaukums ir "Microsoft" un rādītāja simbols vēl nav iestatīts uz "MSFT". Noklikšķinot uz Lietot paziņojumā, kolonna Ticker Symbol tiks iestatīta uz "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");
}

Šādi paziņojums tiek parādīts modeļa vadītās programmās:

Saistītie raksti

clearPaziņojums
setPaziņojums