addActionHandler (kliento API nuoroda)

Registruoja pasirinktinę apdorojimo programos funkciją Microsoft 365 Copilot veiksmui.

Sintaksė

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

Parametrai

Parametro pavadinimas	Tipas	Būtina	Aprašas
actionId	eilutė	Taip	Unikalusis apdorojamo veiksmo identifikatorius.
actionHandler	Funkcija	Taip	Iškviečiama funkcija, kai paleidžiamas veiksmas. Gauna veiksmo duomenų paketo turinį kaip argumentą.
successCallback	Funkcija	Taip	Funkcija, kurią reikia iškviesti, kai operacija sėkminga.
errorCallback	Funkcija	Taip	Funkcija, kurią reikia iškviesti, kai operacija nepavyksta.

Pateikta reikšmė

Rūšis: Promise<void>

Pastabos

Galite užregistruoti kelias apdorojimo programas tai pačiai actionId. Jie veikia nuosekliai. API automatiškai nepaiso tos pačios funkcijos nuorodos registravimo du kartus tam pačiam actionId. API nieko nedaro, jei neįgalinta Microsoft 365 Copilot.

Įtaisytieji veiksmo ID

Toliau nurodytų veiksmų ID platformos numatytosios apdorojimo programos užregistruojamos automatiškai. Galite įtraukti pasirinktines apdorojimo programas šalia jų arba pirmiausia pašalinti numatytąsias apdorojimo programas naudodami removeDefaultActionHandlers.

Veiksmo ID	Aprašas	Duomenų ypatybės
MS.PA.CopilotChat.OpenRecord	Atidaro įrašą.	entity (eilutė) – lentelės loginis pavadinimas; recordId (eilutė) – įrašo ID
MS.PA.CopilotChat.NavigateToView	Pereina į rodinį.	entity (eilutė) – lentelės loginis pavadinimas; fetchXml (eilutė) – "FetchXML" užklausa

Pavyzdžiui

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

Susiję straipsniai

removeActionHandler metodas
Xrm.Copilot (kliento API nuoroda)