addNotification (Referensi API Klien)

Menampilkan pemberitahuan kesalahan atau rekomendasi untuk kontrol, dan memungkinkan Anda menentukan tindakan yang akan dijalankan berdasarkan pemberitahuan. Saat Anda menentukan jenis pemberitahuan kesalahan, ikon "X" merah muncul di samping kontrol. Saat Anda menentukan jenis pemberitahuan rekomendasi, ikon "i" muncul di samping kontrol. Pada klien seluler Dynamics 365, mengetuk ikon akan menampilkan pesan, dan memungkinkan Anda melakukan tindakan yang dikonfigurasi dengan mengklik tombol Terapkan atau menutup pesan.

Jenis kontrol yang didukung

All

Syntax

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

Parameter-parameternya

Nama	Tipe	Diperlukan	Description
notification	Objek	Yes	Pemberitahuan yang akan ditambahkan. Lihat notification parameter

parameter notification

Parameter notification menerima objek dengan properti berikut

Nama	Tipe	Diperlukan	Description
actions	Array dari objek-objek	Tidak.	Lihat actions properti
messages	Array String	Yes	Pesan yang akan ditampilkan dalam pemberitahuan. Dalam rilis saat ini, hanya pesan pertama yang ditentukan dalam array ini yang akan ditampilkan. String yang Anda tentukan di sini muncul sebagai teks tebal dalam pemberitahuan, dan biasanya digunakan untuk judul atau subjek pemberitahuan. Anda harus membatasi pesan Anda hingga 50 karakter untuk pengalaman pengguna yang optimal.
notificationLevel	String	Yes	Menentukan jenis pemberitahuan. Nilai yang valid adalah: ERROR atau RECOMMENDATION.
uniqueId	String	Yes	ID yang digunakan untuk menghapus pemberitahuan ini saat menggunakan metode clearNotification.

actions Properti

Properti actions berisi array objek dengan properti berikut:

Nama	Tipe	Diperlukan	Description
message	String	Tidak.	Pesan isi pemberitahuan yang akan ditampilkan kepada pengguna. Batasi pesan Anda hingga 100 karakter untuk pengalaman pengguna yang optimal.
actions	Array fungsi	Tidak.	Tindakan yang sesuai untuk pesan.

Mengembalikan Nilai

Jenis: Boolean

Deskripsi: Menunjukkan apakah metode berhasil.

Komentar

Di klien web, metode addNotification menampilkan pemberitahuan dengan pesan yang Anda tentukan dan dua tombol standar: Terapkan dan Tutup. Mengklik Terapkan menjalankan tindakan yang Anda tentukan; mengklik Tutup menutup pesan pemberitahuan.

Di Antarmuka Terpadu:

• Tidak ada tombol Tutup .
• Tombol Terapkan hanya muncul ketika tingkat pemberitahuan diatur ke REKOMENDASI, bukan KESALAHAN.

Example

Kode sampel berikut menampilkan pemberitahuan pada kolom Nama Akun formulir akun untuk mengatur Simbol Ticker jika kolom Nama Akun berisi "Microsoft", dan simbol ticker belum diatur ke "MSFT". Mengklik Terapkan di pemberitahuan akan mengatur kolom Simbol Ticker ke "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");
}

Inilah cara pemberitahuan muncul di aplikasi berbasis model:

Artikel terkait

clearNotification
setNotification