addActionHandler (sklic na API odjemalca)

Registrira funkcijo rutine za obravnavo po meri za Microsoft 365 Copilot dejanje.

Sintaksa

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

Parametri

Ime parametra Tip Zahtevano Opis
actionId niz Da Enolični identifikator dejanja, ki ga želite odpreti.
actionHandler Funkcija Da Funkcija, ki jo želite priklicati, ko je dejanje sproženo. Prejme koristno obremenitev podatkov dejanja kot argument.
successCallback Funkcija Da Funkcija, ki jo pokličete, ko je operacija uspešna.
errorCallback Funkcija Da Funkcija, ki jo pokličete, ko operacija ne uspe.

Vrnjena vrednost

Vrsta: Promise<void>

Pripombe

Za isto napravo lahko registrirate več rutin za obravnavo actionId. Tečejo zaporedno. API tiho prezre registracijo istega sklica funkcije dvakrat za isto actionId. API ne naredi ničesar, Microsoft 365 Copilot ni omogočen.

VGRAJENI ID-ji dejanj

Ti ID-ji dejanj imajo samodejno registrirane rutine za obravnavo, ki so privzete za platformo. Poleg njih lahko dodate rutine za obravnavo po meri ali pa najprej odstranite privzete rutine za obravnavo tako, da uporabite removeDefaultActionHandlers.

ID dejanja Opis Lastnosti podatkov
MS.PA.CopilotChat.OpenRecord Odpre zapis. entity (niz) – logično ime tabele; recordId (niz) – ID zapisa
MS.PA.CopilotChat.NavigateToView Krmari do pogleda. entity (niz) – logično ime tabele; fetchXml (niz) – poizvedba FetchXML

Primer

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

removeActionHandler method
Xrm.Copilot (sklic na API odjemalca)

  • Last updated on