addNotification (İstemci API başvurusu)

Denetim için bir hata veya öneri bildirimi görüntüler ve bildirime göre yürütülecek eylemleri belirtmenize olanak tanır. Bir hata bildirimi türü belirttiğinizde, denetimin yanında kırmızı bir "X" simgesi görüntülenir. Bir öneri türü belirttiğinizde, denetimin yanında bir "i" simgesi görüntülenir. Dynamics 365 mobil istemcilerinde simgeye dokunduğunuzda ileti görüntülenir ve Uygula düğmesine tıklayarak veya iletiyi kapatarak yapılandırılan eylemi gerçekleştirmenize olanak tanır.

Desteklenen denetim türleri

Tümü

Sözdizimi

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

Parametreler

İsim	Türü	Gerekli	Description
notification	Nesne	Yes	Eklenecek bildirim. Bkz.notification parametre

notification parametresi

notification parametresi aşağıdaki özelliklere sahip bir nesneyi kabul eder

İsim	Türü	Gerekli	Description
actions	Nesneler dizisi	Hayı	Bkz.actions özellik
messages	Dize dizisi	Yes	Bildirimde görüntülenecek ileti. Geçerli sürümde, yalnızca bu dizide belirtilen ilk ileti görüntülenir. Burada belirttiğiniz dize bildirimde kalın metin olarak görünür ve genellikle bildirimin başlığı veya konusu için kullanılır. En iyi kullanıcı deneyimi için iletinizi 50 karakterle sınırlamanız gerekir.
notificationLevel	String	Yes	Bildirim türünü tanımlar. Geçerli değerler ERROR veya RECOMMENDATION.
uniqueId	String	Yes	clearNotification yöntemi kullanılırken bu bildirimi temizlemek için kullanılacak kimlik.

actions özellik

actions özelliği, aşağıdaki özelliklere sahip bir nesne dizisi içerir:

İsim	Türü	Gerekli	Description
message	String	Hayı	Kullanıcıya görüntülenecek bildirimin gövde iletisi. En iyi kullanıcı deneyimi için iletinizi 100 karakterle sınırlayın.
actions	İşlev dizisi	Hayı	İletiye karşılık gelen eylemler.

Dönüş Değeri

Tür: Boole dili

Açıklama: Yöntemin başarılı olup olmadığını gösterir.

Açıklamalar

Web istemcisinde addNotification yöntemi, belirttiğiniz iletileri içeren bir bildirim ve iki standart düğme görüntüler: Uygula ve Kapat. Uygula'ya tıklanması, tanımladığınız eylemi yürütür; Kapat'a tıklanması bildirim iletisini kapatır.

Birleşik Arabirimde:

• Kapat düğmesi yok.
• Uygula düğmesi yalnızca bildirim düzeyi HATA olarak değil, ÖNERİ olarak ayarlandığında görüntülenir.

Example

Aşağıdaki örnek kod, hesap formunun Hesap Adı sütununda, Hesap Adı sütununda "Microsoft" varsa ve değer işareti simgesi "MSFT" olarak ayarlanmadıysa, Değer İşaretleyici Simgesini ayarlamak için bir bildirim görüntüler. Bildirimde Uygula'ya tıklanması , Değer İşaretleyici Simgesi sütununu "MSFT" olarak ayarlar.

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

Bildirim model temelli uygulamalarda şu şekilde görünür:

İlgili makaleler

clearNotification
setNotification