addGlobalNotification (Rujukan API Pelanggan)

Memaparkan ralat, maklumat, amaran atau pemberitahuan kejayaan untuk app dan membolehkan anda menentukan tindakan untuk dilaksanakan berdasarkan pemberitahuan.

Sintaks

Xrm.App.addGlobalNotification(notification).then(successCallback, errorCallback);

Parameter

Nama	Jenis	Wajib	Keterangan
notification	Objek	Ya	Pemberitahuan untuk ditambah. Lihat parameter pemberitahuan
successCallback	Function	Tidak	Fungsi untuk memanggil apabila pemberitahuan dipaparkan. Nilai GUID dihantar untuk mengenal pasti pemberitahuan secara unik. Anda boleh menggunakan nilai GUID untuk menutup atau menolak pemberitahuan menggunakan kaedah clearGlobalNotification.
errorCallback	Function	Tidak	Fungsi untuk memanggil apabila operasi gagal.

Sifat pemberitahuan

Objek mengandungi sifat berikut:

Hartanah	Jenis	Wajib	Keterangan
action	Objek	Tidak	Objek dengan sifat berikut: - actionLabel(Pilihan) Rentetan. Label untuk tindakan dalam mesej. - eventHandler: (Pilihan) Rujukan fungsi. Fungsi untuk dilaksanakan apabila label tindakan diklik.
level	Nombor	Ya	Mentakrifkan tahap pemberitahuan. Nilai yang sah ialah: 1: Kejayaan 2: Ralat 3: Amaran 4: Maklumat
message	String	Ya	Mesej yang akan dipaparkan dalam pemberitahuan.
showCloseButton	Bool	Tidak	Menunjukkan sama ada pengguna boleh menutup atau menolak pemberitahuan atau tidak. Jika anda tidak menentukan parameter ini, pengguna tidak boleh menutup atau menolak pemberitahuan secara lalai.
type	Nombor	Ya	Mentakrifkan jenis pemberitahuan. Pada masa ini, hanya nilai 2 disokong, yang memaparkan bar mesej di bahagian atas apl.

Nilai Pulangan

Apabila berjaya, mengembalikan objek janji yang mengandungi nilai GUID untuk mengenal pasti pemberitahuan secara unik seperti yang diterangkan sebelum ini dalam perihalan parameter successCallback .

Contoh

Paparkan pemberitahuan ralat yang tidak boleh ditutup atau ditolak oleh pengguna

// define notification object
var notification = 
{
  type: 2,
  level: 2, //error
  message: "Test error notification"
}

Xrm.App.addGlobalNotification(notification).then(
    function success(result) {
        console.log("Notification created with ID: " + result);
        // perform other operations as required on notification display
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Beginilah cara pemberitahuan ralat akan muncul dalam apl:

Paparkan pemberitahuan amaran yang boleh ditutup atau ditolak oleh pengguna

// define notification object
var notification = 
{
  type: 2,
  level: 3, //warning
  message: "Test warning notification",
  showCloseButton: true
}

Xrm.App.addGlobalNotification(notification).then(
    function success(result) {
        console.log("Notification created with ID: " + result);
        // perform other operations as required on notification display
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Beginilah cara pemberitahuan amaran akan muncul dalam apl:

Paparkan pemberitahuan maklumat dengan pautan "Ketahui lebih lanjut" yang boleh diklik oleh pengguna

// define action object
var myAction =
{
  actionLabel: "Learn more", 
  eventHandler: function () {
        Xrm.Navigation.openUrl("https://learn.microsoft.com/powerapps/");
        // perform other operations as required on clicking
    }
}

// define notification object
var notification = 
{
  type: 2,
  level: 4, // information
  message: "Test information notification",  
  action: myAction
}

Xrm.App.addGlobalNotification(notification).then(
    function success(result) {
        console.log("Notification created with ID: " + result);
        // perform other operations as required on notification display
    },
    function (error) {
        console.log(error.message);
        // handle error conditions
    }
);

Beginilah cara pemberitahuan maklumat akan muncul dalam apl:

Artikel berkaitan

clearGlobalNotification