removeActionHandler (クライアント API リファレンス)

Microsoft 365 Copilot アクションの以前に登録されたカスタム ハンドラーを削除します。

Syntax

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

Parameters

パラメーター名 タイプ 必須 Description
actionId 文字列 はい アクションの一意識別子。
actionHandler Function はい 削除するハンドラー。 addActionHandler に渡される関数参照と同じである必要があります。
successCallback Function はい 処理が成功したときに呼び出す関数。
errorCallback Function はい 処理が失敗したときに呼び出す関数。

戻り値

タイプ: Promise<void>

Remarks

このメソッドは、渡した特定の関数参照のみを削除します。 同じ actionIdの他のハンドラーには影響しません。 Microsoft 365 Copilotが有効になっていない場合、メソッドは何も行いません。

Example

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 (クライアント API 参照)