addGlobalNotification (مرجع واجهة برمجة تطبيقات العميل)

يعرض إعلاما بالخطأ أو المعلومات أو التحذير أو النجاح لأحد التطبيقات، ويسمح لك بتحديد الإجراءات التي يجب تنفيذها استنادا إلى الإعلام.

بناء الجملة

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 فقط، والتي تعرض شريط رسائل في أعلى التطبيق.

قيمة الإرجاع

عند النجاح، ترجع كائن وعد يحتوي على قيمة 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