addGlobalNotification (क्लाइंट API संदर्भ)

किसी ऐप के लिए एक त्रुटि, जानकारी, चेतावनी या सफलता सूचना प्रदर्शित करता है, और आपको अधिसूचना के आधार पर निष्पादित करने के लिए क्रियाएं निर्दिष्ट करने देता है।

सिंटैक्स

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

पैरामीटर

नाम	प्रकार	आवश्य	वर्णन
notification	ऑब्जेक्ट	हाँ	जोड़ने के लिए अधिसूचना। अधिसूचना पैरामीटर देखें
successCallback	फ़ंक्शन	नहीं	अधिसूचना प्रदर्शित होने पर कॉल करने के लिए एक फ़ंक्शन. एक GUID मान अनन्य रूप से सूचना की पहचान करने के लिए पास किया जाता है। आप GUID मान को बंद करने या clearGlobalNotification विधि का उपयोग करके सूचना को खारिज करने के लिए उपयोग कर सकते हैं।
errorCallback	फ़ंक्शन	नहीं	ऑपरेशन विफल होने पर कॉल करने के लिए एक फ़ंक्शन।

अधिसूचना संपत्ति

ऑब्जेक्ट में निम्न गुण हैं:

जायदाद	प्रकार	आवश्य	वर्णन
action	ऑब्जेक्ट	नहीं	निम्न गुणों के साथ एक ऑब्जेक्ट: - actionLabel(वैकल्पिक) तार। संदेश में कार्रवाई के लिए लेबल. - eventHandler: (वैकल्पिक) फ़ंक्शन संदर्भ। क्रिया लेबल पर क्लिक करने पर निष्पादित करने के लिए फ़ंक्शन.
level	संख्या	हाँ	अधिसूचना के स्तर को परिभाषित करता है। मान्य मान हैं: 1: सफलता 2: त्रुटि 3: चेतावनी 4: जानकारी
message	तार	हाँ	अधिसूचना में प्रदर्शित करने के लिए संदेश।
showCloseButton	बूलियन	नहीं	इंगित करता है कि उपयोगकर्ता अधिसूचना को बंद या खारिज कर सकता है या नहीं। यदि आप यह पैरामीटर निर्दिष्ट नहीं करते हैं, तो उपयोगकर्ता डिफ़ॉल्ट रूप से सूचना को बंद या खारिज नहीं कर सकते हैं.
type	संख्या	हाँ	अधिसूचना के प्रकार को परिभाषित करता है। वर्तमान में, केवल 2 का मान समर्थित है, जो ऐप के शीर्ष पर एक संदेश पट्टी प्रदर्शित करता है।

वापसी मान

सफलता पर, successCallback पैरामीटर के विवरण में पहले वर्णित के रूप में सूचना की पहचान करने के लिए एक GUID मान युक्त एक वादा ऑब्जेक्ट देता है।

उदाहरण

एक त्रुटि सूचना प्रदर्शित करें जिसे उपयोगकर्ता द्वारा बंद या खारिज नहीं किया जा सकता है

// 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