removeActionHandler (referência da API do cliente)

Remove um manipulador personalizado registrado anteriormente para uma ação de Microsoft 365 Copilot.

Sintaxe

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

Parameters

Nome do parâmetro	Tipo	Obrigatório	Descrição
actionId	cadeia	Yes	O identificador exclusivo da ação.
actionHandler	Função	Yes	O manipulador a ser removido. Deve ser a mesma referência de função passada para addActionHandler.
successCallback	Função	Yes	Uma função a ser chamada quando a operação for bem-sucedida.
errorCallback	Função	Yes	Uma função a ser chamada quando a operação falhar.

Valor de retorno

Tipo: Promise<void>

Remarks

O método remove apenas a referência de função específica que você passa. Ele não afeta outros manipuladores para o mesmo actionId. Se Microsoft 365 Copilot não estiver habilitado, o método não fará nada.

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);

Artigos relacionados

addActionHandler
Xrm.Copilot (referência da API cliente)