addActionHandler (Referència a l'API del client)

Registra una funció de gestor personalitzada per a una acció de Microsoft 365 Copilot.

Sintaxi

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

Paràmetres

Nom del paràmetre Tipus Necessari Descripció
actionId cadena Sí L'identificador únic de l'acció a gestionar.
actionHandler Funció Sí La funció a invocar quan s'activa l'acció. Rep la càrrega útil de dades de l'acció com a argument.
successCallback Funció Sí Una funció per cridar quan l'operació té èxit.
errorCallback Funció Sí Una funció per cridar quan l'operació falla.

Valor retornat

Tipus: Promise<void>

Observacions

Pots registrar diversos gestors per al mateix actionId. Funcionen seqüencialment. L'API ignora silenciosament registrar dues vegades la mateixa referència de funció per a la mateixa actionId. L'API no fa res si Microsoft 365 Copilot no està activat.

IDs d'acció integrats

Els següents IDs d'acció tenen els gestors per defecte de la plataforma registrats automàticament. Pots afegir gestors personalitzats al costat, o eliminar primer els gestors per defecte utilitzant removeDefaultActionHandlers.

ID d'acció Descripció Propietats de les dades
MS.PA.CopilotChat.OpenRecord Obre un registre. entity (cadena) — nom lògic de la taula; recordId (cadena) — ID de registre
MS.PA.CopilotChat.NavigateToView Navega fins a una vista. entity (cadena) — nom lògic de la taula; fetchXml (cadena) — Consulta FetchXML

Exemple

const handler = async ({ entity, recordId }) => {
    // Open the record in a side pane instead of navigating away
    const pane = Xrm.App.sidePanes.createPane({ canClose: true });
    await pane.navigate({ pageType: "entityrecord", entityName: entity, entityId: recordId });
};

await Xrm.Copilot.addActionHandler("My.Namespace.MyActionMessage", handler);

mètode removeActionHandler
Xrm.Copilot (Referència de l'API del client)

  • Last updated on