addNotification (referenca klijentskog API-ja)

Prikazuje poruku o pogrešci ili preporuku za kontrolu i omogućuje vam da navedete akcije koje želite izvršiti na temelju obavijesti. Kada navedete vrstu obavijesti o pogrešci, pokraj kontrole prikazuje se crvena ikona "X". Kada navedete vrstu preporuke obavijesti, uz kontrolu će se pojaviti ikona "i". U mobilnim klijentima sustava Dynamics 365 dodirom na ikonu prikazat će se poruka i omogućiti izvođenje konfigurirane akcije klikom na gumb Primijeni ili odbacivanjem poruke.

Podržane vrste kontrola

Sve

Sintaksa

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

Parametri

Ime	Tip	Obvezno	Opis
notification	Objekt	Da	Obavijest koju želite dodati. Prikaz notification parametra

notification parametarski

Parametar notification prihvaća objekt sa sljedećim svojstvima

Ime	Tip	Obvezno	Opis
actions	Niz objekata	Ne	Prikaz svojstvaactions
messages	Polje nizova	Da	Poruka koja će se prikazati u obavijesti. U trenutnom izdanju prikazat će se samo prva poruka navedena u ovom polju. Niz koji ovdje navedete prikazuje se kao podebljani tekst u obavijesti i obično se koristi za naslov ili predmet obavijesti. Da biste postigli optimalan korisnički doživljaj, ograničite poruku na 50 znakova.
notificationLevel	String	Da	Definira vrstu obavijesti. Valjane su vrijednosti ERROR ili RECOMMENDATION.
uniqueId	String	Da	ID koji će se koristiti za brisanje ove obavijesti prilikom korištenja metode clearNotification.

actions svojstvo

Svojstvo actions sadrži polje objekata sa sljedećim svojstvima:

Ime	Tip	Obvezno	Opis
message	String	Ne	Tijelo poruke obavijesti koja će se prikazati korisniku. Ograničite poruku na 100 znakova radi optimalnog korisničkog doživljaja.
actions	Polje funkcija	Ne	Odgovarajuće akcije za poruku.

Povratna vrijednost

Vrsta: Booleova vrijednost

Opis: označava je li metoda uspjela.

Primjedbe

U web-klijentu metoda addNotification prikazuje obavijest s navedenim porukama i dva standardna gumba: Primijeni i Odbaci. Klikom na Primijeni izvršava se akcija koju definirate. Klikom na Odbaci zatvara se poruka s obavijesti.

U objedinjenom sučelju:

• Nema gumba Odbaci .
• Gumb Primijeni pojavljuje se samo kada je razina obavijesti postavljena na PREPORUKA, a ne POGREŠKA.

Primjer

U sljedećem se oglednom kodu prikazuje obavijest u stupcu Naziv računa obrasca računa da biste postavili simbol dionica ako stupac Naziv računa sadrži "Microsoft", a simbol burzovnog izvješća još nije postavljen na "MSFT". Klikom na Primijeni u obavijesti postavit ćete stupac Simbol dionica na "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");
}

Ovako će se obavijest prikazati u aplikacijama utemeljenima na modelu:

Povezani članci

clearNotification
setNotification