removeActionHandler (Client-API-Referenz)

Entfernt einen zuvor registrierten benutzerdefinierten Handler für eine Microsoft 365 Copilot Aktion.

Syntax

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

Parameter

Parametername Typ Erforderlich Beschreibung
actionId string Yes Der eindeutige Bezeichner der Aktion.
actionHandler Funktion Yes Der zu entfernende Handler. Muss derselbe Funktionsverweis sein, der an addActionHandler übergeben wird.
successCallback Funktion Yes Eine Funktion zum Aufrufen, wenn der Vorgang erfolgreich war.
errorCallback Funktion Yes Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug.

Rückgabewert

Typ: Promise<void>

Remarks

Die Methode entfernt nur den spezifischen Funktionsverweis, den Sie übergeben. Es wirkt sich nicht auf andere Handler für dasselbe actionIdaus. Wenn Microsoft 365 Copilot nicht aktiviert ist, führt die Methode nichts aus.

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 (Client-API-Referenz)