removeActionHandler (référence de l’API cliente)

Supprime un gestionnaire personnalisé précédemment inscrit pour une action de Microsoft 365 Copilot.

Syntax

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

Paramètres

Nom du paramètre Catégorie Required Description
actionId string Oui Identificateur unique de l’action.
actionHandler Function Oui Gestionnaire à supprimer. Doit être la même référence de fonction passée à addActionHandler.
successCallback Function Oui Fonctionnalité à appeler lorsque l’opération aboutit.
errorCallback Function Oui Fonction à appeler lorsque l’opération échoue.

Valeur de retour

Type : Promise<void>

Remarks

La méthode supprime uniquement la référence de fonction spécifique que vous passez. Il n’affecte pas d’autres gestionnaires pour le même actionId. Si Microsoft 365 Copilot n'est pas activé, la méthode ne fait rien.

Exemple

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 (référence de l’API client)