addActionHandler (kliendi API viide)

Registreerib Microsoft 365 Copilot toimingu kohandatud ohjurifunktsiooni.

Süntaks

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

Parameetrid

Parameetri nimi	Tüüp	Nõutav	Kirjeldus
actionId	string	Jah	Töödeldava toimingu ainuidentifikaator.
actionHandler	Funktsioon	Jah	Funktsioon, mis käivitatakse toimingu käivitamisel. Saab toimingu andmete lasti argumendina.
successCallback	Funktsioon	Jah	Funktsioon, mida kutsuda, kui toiming õnnestub.
errorCallback	Funktsioon	Jah	Funktsioon, mida kutsuda, kui toiming nurjub.

Tagastusväärtus

Liik: Promise<void>

Märkused

Sama actionIdjaoks saate registreerida mitu ohjurit. Nad töötavad järjest. API ignoreerib vaikselt sama funktsiooniviite registreerimist kaks korda sama actionIdjaoks. API ei tee midagi, kui Microsoft 365 Copilot pole lubatud.

Sisseehitatud toimingu-ID-d

Järgmistes toimingu ID-des on automaatselt registreeritud platvormi vaikeohjurid. Kohandatud ohjureid saate lisada nende kõrvale või eemaldada esmalt vaikeohjurid, kasutades selleks removeDefaultActionHandlereid.

Tegevuse ID	Kirjeldus	Andmeatribuudid
MS.PA.CopilotChat.OpenRecord	Avab kirje.	entity (string) — tabeli loogikanimi; recordId (string) – kirje ID
MS.PA.CopilotChat.NavigateToView	Viib vaatesse.	entity (string) — tabeli loogikanimi; fetchXml (string) – päring FetchXML

Näide

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

Seotud artiklid

removeActionHandler method
Xrm.Copilot (kliendi API viide)