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

إزالة المعالجات الافتراضية للنظام الأساسي لإجراء Microsoft 365 Copilot.

إعراب

Xrm.Copilot.removeDefaultActionHandlers(actionId).then(successCallback, errorCallback);

Parameters

اسم المعلمة	النوع	مطلوب	الوصف
actionId	سلسلة نصية	‏‏نعم‬	معرف الإجراء الذي تريد إزالة الإعدادات الافتراضية الخاصة به. يجب أن يكون أحد معرفات الإجراءات المضمنة المحددة في addActionHandler.
successCallback	الدالة	‏‏نعم‬	وظيفة للاتصال عند نجاح العملية.
errorCallback	الدالة	‏‏نعم‬	وظيفة للاتصال عند فشل العملية.

القيمة المرجعة

نوع: Promise<void>

الملاحظات

لا يؤثر هذا الأسلوب على المعالجات المخصصة المسجلة من خلال addActionHandler. لاستعادة المعالجات الافتراضية، استخدم addDefaultActionHandlers. إذا لم يتم تمكين Microsoft 365 Copilot، فإن هذا الأسلوب لا يفعل شيئا.

مثال

// Replace default record navigation with custom behavior
await Xrm.Copilot.removeDefaultActionHandlers("MS.PA.CopilotChat.OpenRecord");

await Xrm.Copilot.addActionHandler("MS.PA.CopilotChat.OpenRecord", async ({ entity, recordId }) => {
    // custom implementation
});

المقالات ذات الصلة

addDefaultActionHandlers
Xrm.Copilot (مرجع واجهة برمجة تطبيقات العميل)