addGlobalNotification (referenca API-ja klijenta)

Prikazuje pogrešku, informacije, upozorenje ili obavijest o uspjehu za aplikaciju i omogućuje vam da odredite akcije koje želite izvršiti na temelju obavijesti.

Sintaksa

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

Parametri

Ime	Tip	Obvezno	Opis
notification	Objekt	Da	Obavijest koju želite dodati. Prikaz parametra obavijesti
successCallback	Function	Ne	Funkcija koja se poziva kada se prikazuje obavijest. Guid vrijednost prosljeđuje se radi jedinstvene identifikacije obavijesti. GUID vrijednost možete koristiti za zatvaranje ili odbacivanje obavijesti pomoću metode clearGlobalNotification.
errorCallback	Function	Ne	Funkcija za pozivanje kada operacija ne uspije.

svojstvo obavijesti

Objekt sadrži sljedeća svojstva:

Svojstvo	Tip	Obvezno	Opis
action	Objekt	Ne	Objekt sa sljedećim svojstvima: - actionLabel(Neobavezno) Gudački. Oznaka akcije u poruci. - eventHandler: (Neobavezno) Referenca funkcije. Funkcija koja će se izvršiti kada se klikne oznaka akcije.
level	Broj	Da	Definira razinu obavijesti. Valjane vrijednosti su: 1: Uspjeh 2: Pogreška 3: Upozorenje 4: Informacije
message	String	Da	Poruka koja će se prikazati u obavijesti.
showCloseButton	Booleova vrijednost	Ne	Označava može li korisnik zatvoriti ili odbaciti obavijest. Ako ne navedete taj parametar, korisnici ne mogu po zadanom zatvoriti ili odbaciti obavijest.
type	Broj	Da	Definira vrstu obavijesti. Trenutno je podržana samo vrijednost 2, koja prikazuje traku s porukama pri vrhu aplikacije.

Povratna vrijednost

Prilikom uspjeha vraća objekt obećanja koji sadrži GUID vrijednost radi jedinstvene identifikacije obavijesti na način opisan ranije u opisu parametra successCallback .

Primjeri

Prikaz obavijesti o pogrešci koju korisnik ne može zatvoriti ili odbaciti

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

Ovako će se prikazati obavijest o pogrešci u aplikaciji:

Prikaz obavijesti s upozorenjem koju korisnik može zatvoriti ili odbaciti

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

Ovako će se prikazati obavijest upozorenja u aplikaciji:

Prikaz obavijesti s informacijama s vezom "Saznajte više" koju mogu kliknuti korisnici

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

Ovako će se obavijest o informacijama prikazivati u aplikaciji:

Povezani članci

clearGlobalNotification