removeDefaultActionHandlers (חומר עזר עבור API של לקוח)

הסרת המטפלים בפלטפורמה המוגדרים כברירת מחדל עבור פעולת Microsoft 365 Copilot אישית.

תחביר

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

פרמטרים

שם פרמטר סוג חובה תיאור
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 (חומר עזר עבור API של לקוח)