addNotification (Rujukan API Klien)

Memaparkan pemberitahuan ralat atau pengesyoran untuk kawalan dan membolehkan anda menentukan tindakan untuk dilaksanakan berdasarkan pemberitahuan. Apabila anda menentukan jenis pemberitahuan ralat, ikon "X" merah muncul di sebelah kawalan. Apabila anda menentukan jenis pemberitahuan pengesyoran, ikon "i" muncul di sebelah kawalan. Pada klien mudah alih Dynamics 365, mengetik pada ikon akan memaparkan mesej dan membolehkan anda melaksanakan tindakan yang dikonfigurasikan dengan mengklik butang Gunakan atau tolak mesej.

Jenis kawalan yang disokong

Semua

Sintaks

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

Parameter

Nama	Jenis	Wajib	Penerangan
notification	Objek	Ya	Pemberitahuan untuk ditambah. Lihat notification parameter

notification Parameter

Parameter menerima notification objek dengan sifat berikut

Nama	Jenis	Wajib	Penerangan
actions	Pelbagai objek	Tidak	Lihat actions hartanah
messages	Tatasusunan Rentetan	Ya	Mesej yang akan dipaparkan dalam pemberitahuan. Dalam keluaran semasa, hanya mesej pertama yang dinyatakan dalam tatasusunan ini akan dipaparkan. Rentetan yang anda tentukan di sini muncul sebagai teks tebal dalam pemberitahuan dan biasanya digunakan untuk tajuk atau subjek pemberitahuan. Anda harus mengehadkan mesej anda kepada 50 aksara untuk pengalaman pengguna yang optimum.
notificationLevel	String	Ya	Mentakrifkan jenis pemberitahuan. Nilai yang sah ialah ERROR atau RECOMMENDATION.
uniqueId	String	Ya	ID yang akan digunakan untuk mengosongkan pemberitahuan ini apabila menggunakan kaedah clearNotification.

actions Hartanah

Sifat ini actions mengandungi tatasusunan objek dengan sifat berikut:

Nama	Jenis	Wajib	Penerangan
message	String	Tidak	Mesej badan pemberitahuan yang akan dipaparkan kepada pengguna. Hadkan mesej anda kepada 100 aksara untuk pengalaman pengguna yang optimum.
actions	Pelbagai fungsi	Tidak	Tindakan yang sepadan untuk mesej.

Nilai Pulangan

Jenis: Boolean

Perihalan: Menunjukkan sama ada kaedah berjaya.

Ucapan

Dalam klien web, kaedah addNotification memaparkan pemberitahuan dengan mesej yang anda tentukan dan dua butang standard: Gunakan dan Tolak. Mengklik Gunakan melaksanakan tindakan yang anda takrifkan; mengklik Tolak menutup mesej pemberitahuan.

Dalam Antara Muka Bersatu:

• Tiada butang Tolak .
• Butang Gunakan hanya muncul apabila tahap pemberitahuan ditetapkan kepada CADANGAN, bukan RALAT.

Contoh

Kod sampel berikut memaparkan pemberitahuan pada lajur Nama Akaun borang akaun untuk mengesetkan Simbol Ticker jika lajur Nama Akaun mengandungi "Microsoft", dan simbol ticker belum ditetapkan kepada "MSFT". Mengklik Gunakan dalam pemberitahuan akan menetapkan lajur Simbol Ticker kepada "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");
}

Beginilah cara pemberitahuan muncul dalam apl dipacu model:

Artikel berkaitan

jelasPemberitahuan
setPemberitahuan