addNotification (klient-API-referanse)

Viser en feil- eller anbefalingsvarsling for en kontroll, og lar deg angi handlinger som skal utføres basert på varselet. Når du angir en varslingstype for feil, vises et rødt X-ikon ved siden av kontrollen. Når du angir en anbefalingstype for varsling, vises et «i»-ikon ved siden av kontrollen. Når du trykker på ikonet på Dynamics 365-mobilklienter, vises meldingen og lar deg utføre den konfigurerte handlingen ved å klikke Bruk-knappen eller lukke meldingen.

Kontrolltyper som støttes

Alle

Syntaks

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

Parametere

Navn	Type	Obligatorisk	Bekrivelse
notification	Objekt	Ja	Varselet som skal legges til. Se notification parameter

notification parameter

Parameteren notification godtar et objekt med følgende egenskaper

Navn	Type	Obligatorisk	Bekrivelse
actions	Matrise av objekter	Nei	Se actions egenskap
messages	Matrise med strenger	Ja	Meldingen som skal vises i varselet. I den gjeldende versjonen vises bare den første meldingen som er angitt i denne matrisen. Strengen du angir her, vises som fet tekst i varselet, og brukes vanligvis til tittel eller emne for varselet. Du bør begrense meldingen til 50 tegn for optimal brukeropplevelse.
notificationLevel	Streng	Ja	Definerer varslingstypen. Gyldige verdier er ERROR eller RECOMMENDATION.
uniqueId	Streng	Ja	ID-en som skal brukes til å fjerne dette varselet når du bruker clearNotification-metoden.

actions eiendom

Egenskapen actions inneholder en matrise med objekter med følgende egenskaper:

Navn	Type	Obligatorisk	Bekrivelse
message	Streng	Nei	Brødtekstmeldingen for varselet som skal vises for brukeren. Begrens meldingen til 100 tegn for optimal brukeropplevelse.
actions	Matrise av funksjoner	Nei	De tilsvarende handlingene for meldingen.

Returverdi

Type: Boolsk

Beskrivelse: Angir om metoden var vellykket.

Merknader

I webklienten viser addNotification-metoden et varsel med meldingene du har angitt, og to standardknapper: Bruk og avvis. Når du klikker Bruk , utføres handlingen du definerer. Når du klikker Avvis , lukkes varslingsmeldingen.

I enhetlig grensesnitt:

• Det finnes ingen Avbryt-knapp .
• Bruk-knappen vises bare når varslingsnivået er satt til ANBEFALING, ikke FEIL.

Eksempel

Følgende eksempelkode viser et varsel i Kontonavn-kolonnen i kontoskjemaet for å angi Ticker-symbolet hvis kolonnen Kontonavn inneholder «Microsoft», og tickersymbolet er ikke allerede satt til MSFT. Hvis du klikker Bruk i varselet, settes tickersymbolkolonnen til 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");
}

Slik vises varslingen i modelldrevne apper:

Relaterte artikler

clearNotification
setNotification