addGlobalNotification (bezeroaren APIaren erreferentzia)

Aplikazio baten errorea, informazioa, abisua edo arrakastaren jakinarazpena bistaratzen du, eta jakinarazpenean oinarrituta exekutatu beharreko ekintzak zehazteko aukera ematen dizu.

Sintaxia

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

Parametroak

Izena	Mota	Beharrezkoa	Deskribapenak
notification	Objektua	Bai	Gehitu beharreko jakinarazpena. Ikusi jakinarazpenaren parametroa
successCallback	Function	Ez	Jakinarazpena bistaratzen denean deitzeko funtzioa. GUID balio bat pasatzen da jakinarazpena modu esklusiboan identifikatzeko. Jakinarazpena ixteko edo baztertzeko GUID balioa erabil dezakezu clearGlobalNotification metodoa erabiliz.
errorCallback	Function	Ez	Eragiketan akats bat gertatzen denean deitzen zaion funtzioa.

Jakinarazpenaren propietateak

Objektuak propietate hauek ditu:

Propietateak	Mota	Beharrezkoa	Deskribapenak
action	Objektua	Ez	Propietate hauek dituen objektua: - actionLabel(Aukerakoa) Katea. Mezuko ekintzaren etiketa. - eventHandler: (Aukerakoa) Funtzioaren erreferentzia. Ekintza-etiketan klik egitean exekutatu beharreko funtzioa.
level	Zenbakia	Bai	Jakinarazpen-maila definitzen du. Balio baliodunak honako hauek dira: 1: Arrakasta 2: Errorea 3: Abisua 4: Informazioa
message	String	Bai	Jakinarazpenean bistaratu beharreko mezua.
showCloseButton	Bool	Ez	Erabiltzaileak jakinarazpena itxi edo baztertu dezakeen ala ez adierazten du. Parametro hau zehazten ez baduzu, erabiltzaileek ezingo dute jakinarazpena itxi edo baztertu lehenespenez.
type	Zenbakia	Bai	Jakinarazpen mota zehazten du. Gaur egun, 2 balioa bakarrik onartzen da, eta horrek mezu-barra bat bistaratzen du aplikazioaren goialdean.

Itzuli balioa

Arrakasta izanez gero, GUID balioa duen promesa-objektu bat itzultzen du, jakinarazpena modu esklusiboan identifikatzeko, successCallback parametroaren deskribapenean lehen azaldu den bezala.

Adibideak

Erabiltzaileak itxi edo baztertu ezin duen errore-jakinarazpena bistaratu

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

Honela agertuko da errore-jakinarazpena aplikazioan:

Erabiltzaileak itxi edo baztertu dezakeen abisu-jakinarazpena bistaratu

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

Honela agertuko da abisu-jakinarazpena aplikazioan:

Bistaratu informazio-jakinarazpen bat erabiltzaileek klik egin dezaketen "Gehiago jakiteko" estekarekin.

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

Honela agertuko da informazioaren jakinarazpena aplikazioan:

Erlazionatutako artikuluak

clearGlobalNotification