addNotification (Referenca klijentskog API-ja)

Prikazuje obaveštenje o grešci ili preporukama za kontrolu i omogućava vam da navedete radnje koje treba izvršiti na osnovu obaveštenja. Kada navedete tip obaveštenja o grešci, pored kontrole se pojavljuje crvena ikona "X". Kada navedete tip preporuke obaveštenja, pored kontrole se pojavljuje ikona "i". Na Dynamics 365 mobilnim klijentima, dodirivanje ikone će prikazati poruku i omogućiti vam da izvršite konfigurisanu radnju tako što ćete kliknuti na dugme Primeni ili odbaciti poruku.

Podržani tipovi kontrola

Sve

Sintaksa

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

Parametri

Ime	Tip	Potrebne	Opis
notification	Objekat	Da	Obaveštenje za dodavanje. Pogledajte parametarnotification

notification Parametar

Parametar notification prihvata objekat sa sledećim svojstvima

Ime	Tip	Potrebne	Opis
actions	Niz objekata	Ne	Prikaži svojstvoactions
messages	Niz niski	Da	Poruka koja će se prikazati u obaveštenju. U trenutnom izdanju biće prikazana samo prva poruka navedena u ovom nizu. Niska koju ovde navedete pojavljuje se kao podebljani tekst u obaveštenju i obično se koristi za naslov ili temu obaveštenja. Trebalo bi da ograničite poruku na 50 znakova radi optimalnog korisničkog iskustva.
notificationLevel	String	Da	Definiše tip obaveštenja. Važeće vrednosti su ERROR ili RECOMMENDATION.
uniqueId	String	Da	ID koji se koristi za brisanje ovog obaveštenja kada koristite metod clearNotification.

actions Svojstvo

Svojstvo actions sadrži niz objekata sa sledećim svojstvima:

Ime	Tip	Potrebne	Opis
message	String	Ne	Telo poruke obaveštenja koje će biti prikazano korisniku. Ograničite poruku na 100 znakova radi optimalnog korisničkog iskustva.
actions	Niz funkcija	Ne	Odgovarajuće radnje za poruku.

Povratna vrednost

Tip: Bulova vrednost

Opis: Ukazuje na to da li je metod uspeo.

Primedbe

U veb klijentu metod addNotification prikazuje obaveštenje sa porukama koje ste naveli i dva standardna dugmeta: Primeni i Odbaci. Klikom na dugme Primeni izvršava se radnja koju definišete; Klikom na dugme Odbaci zatvara se poruka sa obaveštenjem.

U objedinjeom interfejsu:

• Ne postoji dugme Odbaci .
• Dugme Primeni se pojavljuje samo kada je nivo obaveštenja postavljen na PREPORUKA, a ne na GREŠKU.

Primer

Sledeći uzorak koda prikazuje obaveštenje u koloni Ime naloga obrasca naloga da bi se postavio simbol tickera ako kolona Ime naloga sadrži "Microsoft", a simbol oznake nije već postavljen na "MSFT". Ako kliknete na dugme Primeni u obaveštenju, kolona Simbol oznake će biti "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");
}

Tako se obaveštenje pojavljuje u aplikacijama koje potiče iz modela:

Srodni članci

clearNotification
setNotification