addActionHandler (referenca API-ja klijenta)

Registrira prilagođenu funkciju rukovatelja za Microsoft 365 Copilot akciju.

Sintaksa

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

Parametri

Naziv parametra Vrsta Obavezno Opis
actionId niz Da Jedinstveni identifikator akcije za rukovanje.
actionHandler Funkcija Da Funkcija koja se poziva kada se aktivira akcija. Prima podatke o korisnim podacima radnje kao argument.
successCallback Funkcija Da Funkcija koja se poziva kada operacija uspije.
errorCallback Funkcija Da Funkcija za pozivanje kada operacija ne uspije.

Vrijednost vraćanja

Tip: Promise<void>

Napomene

Možete registrirati više rukovatelja za isti actionId. Pokreću se sekvencijalno. API u pozadini zanemaruje registriranje iste reference funkcije dvaput za istu actionId. API ne čini ništa Microsoft 365 Copilot nije omogućen.

ID-ovi ugrađenih akcija

Id-jevi akcije u nastavku automatski su registrirani rukovatelja po zadanom na platformi. Možete dodati prilagođene rukovatelje uz njih ili najprije ukloniti zadane rukovatelje pomoću naredbe removeDefaultActionHandlers.

ID akcije Opis Svojstva podataka
MS.PA.CopilotChat.OpenRecord Otvara zapis. entity (niz) — logički naziv tablice; recordId (niz) – ID zapisa
MS.PA.CopilotChat.NavigateToView Navigacija do prikaza. entity (niz) — logički naziv tablice; fetchXml (niz) – FetchXML upit

Primjer

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 metoda
Xrm.Copilot (referenca klijentskog API-ja)

  • Last updated on