removeActionHandler (Referência da API do cliente)

Remove um handler personalizado previamente registado para uma ação do Microsoft 365 Copilot.

Sintaxe

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

Parameters

Nome do parâmetro	Tipo	Obrigatório	Description
actionId	cadeia (de caracteres)	Yes	O identificador exclusivo da ação.
actionHandler	Function	Yes	O responsável para remover. Deve ser a mesma referência de função passada para addActionHandler.
successCallback	Function	Yes	Uma função a ser chamada quando a operação for bem-sucedida.
errorCallback	Function	Yes	Uma função para chamar quando a operação falhar.

Valor de retorno

Tipo: Promise<void>

Remarks

O método remove apenas a referência específica da função que passa. Não afeta outros tratadores pelo mesmo actionIdmotivo. Se o Microsoft 365 Copilot não estiver ativado, o método não faz 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 do cliente)