addNotification (Ügyfél API-referencia)

Hiba- vagy javaslatértesítést jelenít meg egy vezérlőhöz, és lehetővé teszi az értesítés alapján végrehajtandó műveletek megadását. Ha hiba típusú értesítést ad meg, egy piros "X" ikon jelenik meg a vezérlő mellett. Ha javaslat típusú értesítést ad meg, egy "i" ikon jelenik meg a vezérlő mellett. A Dynamics 365 mobilalkalmazásokon az ikonra koppintva megjelenik az üzenet, és az Alkalmaz gombra kattintva vagy az üzenet bezárásával hajthatja végre a konfigurált műveletet.

Támogatott vezérlőtípusok

All

Szemantika

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

Paraméterek

Név	Típus	Kötelező	Description
notification	Objektum	Igen	A hozzáadni kívánt értesítés. Paraméter megtekintésenotification

notification paraméter

A notification paraméter az alábbi tulajdonságokkal rendelkező objektumot fogad el

Név	Típus	Kötelező	Description
actions	Objektumok tömbje	Nem	A tulajdonság megtekintéseactions
messages	Sztringek tömbje	Igen	Az értesítésben megjelenítendő üzenet. Az aktuális kiadásban csak az ebben a tömbben megadott első üzenet jelenik meg. Az itt megadott sztring félkövér szövegként jelenik meg az értesítésben, és általában a címhez vagy az értesítés tárgyához használatos. Az optimális felhasználói élmény érdekében az üzenetet 50 karakterre kell korlátoznia.
notificationLevel	Lánc	Igen	Meghatározza az értesítés típusát. Az érvényes értékek ERROR vagy RECOMMENDATION.
uniqueId	Lánc	Igen	A clearNotification metódus használatakor az értesítés törléséhez használandó azonosító.

actions ingatlan

A actions tulajdonság egy objektumtömböt tartalmaz, amely a következő tulajdonságokkal rendelkezik:

Név	Típus	Kötelező	Description
message	Lánc	Nem	A felhasználó számára megjelenítendő értesítés törzsüzenete. Az optimális felhasználói élmény érdekében korlátozza az üzenetet 100 karakterre.
actions	Függvények tömbje	Nem	Az üzenet megfelelő műveletei.

Visszaadott érték

Típus: Logikai

Leírás: Azt jelzi, hogy a metódus sikeres volt-e.

Megjegyzések

A webes ügyfélen az addNotification metódus egy értesítést jelenít meg a megadott üzenetekkel és két szabványos gombbal: Alkalmaz és Elvetés. Az Alkalmaz gombra kattintva végrehajtja a megadott műveletet; Az Elvetés gombra kattintva bezárja az értesítési üzenetet.

Az egyesített felületen:

• Nincs Elzárás gomb.
• Az Alkalmaz gomb csak akkor jelenik meg, ha az értesítési szint JAVASLAT értékre van állítva, nem HIBA.

Example

Az alábbi mintakód egy értesítést jelenít meg a fiókűrlap Fióknév oszlopában, amely a Ticker szimbólumot állítja be, ha a Fióknév oszlopban a "Microsoft" szerepel, és az osztásjel még nincs beállítva "MSFT" értékre. Ha az értesítésben az Alkalmaz gombra kattint, az "MSFT" értékre állítja a Ticker Symbol oszlopot.

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");
}

Így jelenik meg az értesítés a modellalapú alkalmazásokban:

Kapcsolódó cikkek

clearNotification
setNotification