addGlobalNotification (Αναφορά API προγράμματος-πελάτη)

Εμφανίζει μια ειδοποίηση σφάλματος, πληροφοριών, προειδοποίησης ή επιτυχίας για μια εφαρμογή και σας επιτρέπει να καθορίσετε ενέργειες για εκτέλεση με βάση την ειδοποίηση.

Σύνταξη

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

Παράμετροι

Όνομα	Δακτυλογραφώ	Απαιτούμενο	Περιγραφή
notification	Αντικείμενο	Όχι	Η ειδοποίηση που θα προστεθεί. Εμφάνιση παραμέτρου ειδοποίησης
successCallback	Function	όχι	Μια συνάρτηση για κλήση όταν εμφανίζεται ειδοποίηση. Μια τιμή GUID μεταβιβάζεται στον μοναδικό προσδιορισμό της ειδοποίησης. Μπορείτε να χρησιμοποιήσετε την τιμή GUID για να κλείσετε ή να κλείσετε την ειδοποίηση χρησιμοποιώντας τη μέθοδο clearGlobalNotification.
errorCallback	Function	όχι	Μια λειτουργία για κλήση όταν αποτύχει η λειτουργία.

ιδιότητα ειδοποίησης

Το αντικείμενο περιέχει τις ακόλουθες ιδιότητες:

Ιδιοκτησία	Δακτυλογραφώ	Απαιτούμενο	Περιγραφή
action	Αντικείμενο	όχι	Ένα αντικείμενο με τις ακόλουθες ιδιότητες: - actionLabel(Προαιρετικό) Σειρά. Η ετικέτα για την ενέργεια στο μήνυμα. - eventHandler: (Προαιρετικό) Αναφορά συναρτήσεων. Η συνάρτηση που θα εκτελεστεί όταν γίνεται κλικ στην ετικέτα ενέργειας.
level	Αριθμός	Όχι	Καθορίζει το επίπεδο ειδοποίησης. Οι έγκυρες τιμές είναι: 1: Επιτυχία 2: Σφάλμα 3: Προειδοποίηση 4: Πληροφορίες
message	Συμβλοσειρά	Όχι	Το μήνυμα που θα εμφανίζεται στην ειδοποίηση.
showCloseButton	Bool	όχι	Υποδεικνύει εάν ο χρήστης μπορεί ή όχι να κλείσει ή να κλείσει την ειδοποίηση. Εάν δεν καθορίσετε αυτή την παράμετρο, οι χρήστες δεν μπορούν να κλείσουν ή να κλείσουν την ειδοποίηση από προεπιλογή.
type	Αριθμός	Όχι	Καθορίζει τον τύπο της ειδοποίησης. Προς το παρόν, υποστηρίζεται μόνο η τιμή 2, η οποία εμφανίζει μια γραμμή μηνυμάτων στο επάνω μέρος της εφαρμογής.

Τιμή επιστροφής

Κατά την επιτυχία, επιστρέφει ένα αντικείμενο υπόσχεσης που περιέχει μια τιμή GUID για τη μοναδική αναγνώριση της ειδοποίησης, όπως περιγράφεται παραπάνω στην περιγραφή της παραμέτρου successCallback .

Παραδείγματα

Εμφάνιση ειδοποίησης σφάλματος που δεν είναι δυνατό να κλείσει ή να απορριφθεί από τον χρήστη

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

Με αυτόν τον τρόπο θα εμφανίζεται η ειδοποίηση σφάλματος στην εφαρμογή:

Εμφάνιση μιας ειδοποίησης προειδοποίησης που μπορεί να κλείσει ή να απορριφθεί από τον χρήστη

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

Με αυτόν τον τρόπο θα εμφανίζεται η ειδοποίηση προειδοποίησης στην εφαρμογή:

Εμφάνιση ειδοποίησης πληροφοριών με σύνδεση "Μάθετε περισσότερα" στην οποία μπορούν να κάνουν κλικ οι χρήστες

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

Με αυτόν τον τρόπο θα εμφανίζεται η ειδοποίηση πληροφοριών στην εφαρμογή:

Σχετικά άρθρα

clearGlobalNotification