addGlobalNotification (kliendi API viide)

Kuvab rakenduse tõrke-, teabe-, hoiatus- või eduteatise ning võimaldab teil teatise põhjal määrata käivitatavad toimingud.

Süntaks

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

Parameetrid

Nimi	Liik	Nõutav	Kirjeldus
notification	Objekt	Jah	Lisatav teatis. Kuva teatiseparameeter
successCallback	Function	Ei	Funktsioon, mis helistab teatise kuvamisel. Teatise kordumatuks tuvastamiseks edastatakse GUID-väärtus. Saate GUID-väärtuse abil teatise sulgeda või sulgeda , kasutades meetodit ClearGlobalNotification.
errorCallback	Function	Ei	Funktsioon, mida kutsuda, kui toiming nurjub.

teatise atribuut

Objekt sisaldab järgmisi atribuute:

Vara	Liik	Nõutav	Kirjeldus
action	Objekt	Ei	Järgmiste atribuutidega objekt: - actionLabel(Valikuline) String. Sõnumi toimingu silt. - eventHandler: (Valikuline) Funktsiooniviide. Toimingusildi klõpsamisel käivitatav funktsioon.
level	Arv	Jah	Määratleb teatisetaseme. Kehtivad väärtused on järgmised: 1. Edu 2. Tõrge 3. Hoiatus 4. Teave
message	String	Jah	Teatises kuvatav sõnum.
showCloseButton	Bool	Ei	Näitab, kas kasutaja saab teatise sulgeda või sulgeda või mitte. Kui te seda parameetrit ei määra, ei saa kasutajad teatist vaikimisi sulgeda ega sulgeda.
type	Arv	Jah	Määratleb teatise tüübi. Praegu toetatakse ainult väärtust 2, mis kuvab rakenduse ülaosas teateriba.

Tagastatav väärtus

Kui õnnestub, tagastab lubatud objekti, mis sisaldab GUID-väärtust, et tuvastada teatis kordumatult, nagu on kirjeldatud parameetri successCallback kirjelduses eespool.

Näited

Kuva tõrketeatis, mida kasutaja ei saa sulgeda ega sulgeda

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

Tõrketeatis kuvatakse rakenduses järgmiselt.

Kuva hoiatusteatis, mille kasutaja saab sulgeda või sulgeda

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

Hoiatusteatis kuvatakse rakenduses järgmiselt.

Kuva teabeteatis lingiga Lisateave, mida kasutajad saavad klõpsata

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

Teabeteatis kuvatakse rakenduses järgmiselt.

Seotud artiklid

clearGlobalNotification