addNotification (referenční dokumentace k rozhraní API klienta)

Zobrazí oznámení o chybě nebo doporučení ovládacího prvku a umožňuje zadat akce, které se mají provést na základě oznámení. Když zadáte typ oznámení chyby, vedle ovládacího prvku se zobrazí červená ikona X. Když zadáte typ oznámení doporučení, zobrazí se vedle ovládacího prvku ikona i. V mobilních klientech Dynamics 365 se klepnutím na ikonu zobrazí zpráva a umožní vám provést nakonfigurovanou akci kliknutím na tlačítko Použít nebo zprávu zavřít.

Podporované typy ovládacích prvků

Všechno

Syntaxe

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

Parametry

Název	Typ	Povinné	Description
notification	Object	Ano	Oznámení, které chcete přidat. Viz notification parametr

notification parametr

Parametr notification přijímá objekt s následujícími vlastnostmi.

Název	Typ	Povinné	Description
actions	Pole objektů	Ne	Zobrazit actions vlastnost
messages	Pole řetězců	Ano	Zpráva, která se má zobrazit v oznámení V aktuální verzi se zobrazí pouze první zpráva zadaná v tomto poli. Zadaný řetězec se v oznámení zobrazí jako tučný text a obvykle se používá pro název nebo předmět oznámení. Pro optimální uživatelské prostředí byste měli zprávu omezit na 50 znaků.
notificationLevel	String	Ano	Definuje typ oznámení. Platné hodnoty jsou ERROR nebo RECOMMENDATION.
uniqueId	String	Ano	ID, které se má použít k vymazání tohoto oznámení při použití metody clearNotification.

actions vlastnost

Vlastnost actions obsahuje pole objektů s následujícími vlastnostmi:

Název	Typ	Povinné	Description
message	String	Ne	Textová zpráva oznámení, která se má uživateli zobrazit. Pro optimální uživatelské prostředí omezte zprávu na 100 znaků.
actions	Pole funkcí	Ne	Odpovídající akce pro zprávu.

Návratová hodnota

Typ: Logická hodnota

Popis: Označuje, zda byla metoda úspěšná.

Poznámky

Ve webovém klientovi metoda addNotification zobrazí oznámení se zadanými zprávami a dvěma standardními tlačítky: Použít a Zavřít. Kliknutím na Použít provedete akci, kterou definujete; Kliknutím na Tlačítko Zavřít zavřete zprávu s oznámením.

V sjednocené rozhraní:

• Tlačítko Zavřít neexistuje.
• Tlačítko Použít se zobrazí pouze v případě, že je úroveň oznámení nastavená na DOPORUČENÍ, nikoli CHYBA.

Example

Následující ukázkový kód zobrazí oznámení ve sloupci Název účtu ve formuláři účtu, který nastaví symbol tickeru , pokud sloupec Název účtu obsahuje "Microsoft" a symbol tickeru ještě není nastavený na "MSFT". Kliknutím na Použít v oznámení nastavíte sloupec Symbol tickeru 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");
}

Tímto způsobem se oznámení zobrazí v modelem řízených aplikacích:

Související články

clearNotification
setNotification