addActionHandler (odkaz na klientske rozhranie API)

Zaregistruje funkciu vlastného obslužného programu na Microsoft 365 Copilot akciu.

Syntax

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

Parametre

Názov parametra	Type	Požaduje sa	Popis
actionId	reťazec	Yes	Jedinečný identifikátor akcie, ktorá sa má spracovať.
actionHandler	Function	Yes	Funkcia, ktorá sa má vyvolať pri spustení akcie. Prijíma údajovú časť akcie ako argument.
successCallback	Function	Yes	Funkcia, ktorá sa volá po úspešnej operácii.
errorCallback	Function	Yes	Funkcia, ktorá sa volá v prípade zlyhania operácie.

Vrátená hodnota

Typ: Promise<void>

Poznámky

Môžete zaregistrovať viacero obslužných programu pre rovnaké actionId. Spúšťajú sa postupne. Rozhranie API ticho ignoruje registráciu rovnakej funkcie odkaz dvakrát pre rovnaké actionId. Rozhranie API nerobí nič, ak Microsoft 365 Copilot nie je povolené.

Vstavané ID akcií

Nasledujúce ID akcie majú automaticky zaregistrované predvolené obslužné programy platformy. Môžete tiež pridať vlastné obslužné programy alebo najprv odstrániť predvolené obslužný program pomocou funkcie removeDefaultActionHandlers.

ID akcie	Popis	Vlastnosti údajov
MS.PA.CopilotChat.OpenRecord	Otvorí záznam.	entity (reťazec) – logický názov tabuľky; recordId (reťazec) – ID záznamu
MS.PA.CopilotChat.NavigateToView	Prejde do zobrazenia.	entity (reťazec) – logický názov tabuľky; fetchXml (reťazec) – dotaz FetchXML

Príklad

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

Súvisiace články

metóda removeActionHandler
Xrm.Copilot (odkaz na klientske rozhranie API)