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

إزالة معالج مخصص مسجل مسبقا لإجراء Microsoft 365 Copilot.

إعراب

Xrm.Copilot.removeActionHandler(actionId, actionHandler).then(successCallback, errorCallback);

Parameters

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

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

نوع: Promise<void>

الملاحظات

يزيل الأسلوب مرجع الدالة المحدد الذي تمرره فقط. لا يؤثر على المعالجات الأخرى لنفس actionId. إذا لم يتم تمكين Microsoft 365 Copilot، فإن الأسلوب لا يفعل شيئا.

مثال

const handler = async (data) => { /* ... */ };

await Xrm.Copilot.addActionHandler("My.Namespace.MyActionMessage", handler);

// Later, when no longer needed:
await Xrm.Copilot.removeActionHandler("My.Namespace.MyActionMessage", handler);

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