addActionHandler (referință API client)

Înregistrează o funcție de rutină de tratare particularizată pentru o acțiune de Microsoft 365 Copilot.

Sintaxă

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

Parametri

Nume parametru	Tip	Obligatoriu	Descriere
actionId	șir	Da	Identificatorul unic al acțiunii de gestionat.
actionHandler	Funcție	Da	Funcția de invocat atunci când se declanșează acțiunea. Primește sarcina de date a acțiunii ca argument.
successCallback	Funcție	Da	O funcție de apelat atunci când operațiunea reușește.
errorCallback	Funcție	Da	O funcție de apelat atunci când operațiunea eșuează.

Valoare retur

Tip: Promise<void>

Observații

Puteți înregistra mai multe rutine de tratare pentru același actionId. Se execută secvențial. API-ul ignoră silențios înregistrarea aceleiași referințe de funcție de două ori pentru același actionId. API-ul nu face nimic dacă Microsoft 365 Copilot nu este activat.

ID-uri de acțiune predefinite

URMĂTOARELE ID-uri de acțiune au rutine de tratare implicite pentru platformă înregistrate automat. Puteți să adăugați rutine de tratare particularizate împreună sau să eliminați mai întâi rutinele de tratare implicite utilizând removeDefaultActionHandlers.

ID acțiune	Descriere	Proprietăți date
MS.PA.CopilotChat.OpenRecord	Deschide o înregistrare.	entity (șir) — nume logic de tabel; recordId (șir) — ID înregistrare
MS.PA.CopilotChat.NavigateToView	Navighează la o vizualizare.	entity (șir) — nume logic de tabel; fetchXml (șir) — interogare FetchXML

Exemplu

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

Articole asociate

removeActionHandler metoda
Xrm.Copilot (referință API client)