addGlobalNotification (sklic na API odjemalca)

Prikaže obvestilo o napaki, informacijah, opozorilih ali uspehih za aplikacijo in omogoča, da določite dejanja, ki jih želite izvesti na podlagi obvestila.

Sintaksa

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

Parametrov

Ime	Vrsta	Zahtevano	Opis
notification	Predmet	Da	Obvestilo, ki ga želite dodati. Oglejte si parameter obvestila
successCallback	Function	Ne	Funkcija, ki jo pokličete, ko se prikaže obvestilo. Posredovana je vrednost GUID za enolično prepoznavanje obvestila. Z vrednostjo GUID lahko zaprete ali zaprete obvestilo z metodo clearGlobalNotification.
errorCallback	Function	Ne	Funkcija, ki jo pokličete, ko operacija ne uspe.

lastnost obvestila

Predmet vsebuje te lastnosti:

Lastnost	Vrsta	Zahtevano	Opis
action	Predmet	Ne	Predmet s temi lastnostmi: - actionLabel(Izbirno) Niz. Oznaka dejanja v sporočilu. - eventHandler: (Izbirno) Sklic funkcije. Funkcija, ki se izvede, ko kliknete oznako dejanja.
level	Številka	Da	Določi raven obvestila. Veljavne vrednosti so: 1: Uspeh 2: Napaka 3: Opozorilo 4: Informacije
message	String	Da	Sporočilo, ki bo prikazano v obvestilu.
showCloseButton	Bool	Ne	Označuje, ali lahko uporabnik zapre ali opusti obvestilo. Če tega parametra ne določite, uporabniki ne bodo mogli privzeto zapreti ali zapreti obvestila.
type	Številka	Da	Določi vrsto obvestila. Trenutno je podprta le vrednost 2, ki na vrhu aplikacije prikaže vrstico za sporočila.

Vrednost vračila

Ob uspehu vrne predmet, ki vsebuje vrednost GUID, da enolično prepozna obvestilo, kot je opisano zgoraj v opisu parametra successCallback .

Primeri

Prikaz obvestila o napaki, ki ga uporabnik ne more zapreti ali opustiti

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

Tako bo obvestilo o napaki prikazano v aplikaciji:

Prikaži opozorilo, ki ga lahko uporabnik zapre ali opusti

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

Tako se bo opozorilo prikazalo v aplikaciji:

Prikaz obvestila o informacijah s povezavo »Več o tem«, ki jo lahko kliknejo uporabniki

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

Tako bo obvestilo o informacijah prikazano v aplikaciji:

Povezani članki

clearGlobalNotification