addActionHandler (ügyfél API-referencia)

Egyéni kezelőfüggvényt regisztrál egy Microsoft 365 Copilot művelethez.

Syntax

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

Parameters

Paraméter neve	Típus	Required	Description
actionId	karakterlánc	Igen	A kezelendő művelet egyedi azonosítója.
actionHandler	Funkció	Igen	A művelet aktiválásakor meghívandó függvény. Argumentumként fogadja a művelet adat-hasznos adatait.
successCallback	Funkció	Igen	A művelet sikeres végrehajtása esetén meghívandó függvény.
errorCallback	Funkció	Igen	A művelet sikertelensége esetén meghívandó függvény.

Visszaadott érték

Típus: Promise<void>

Remarks

Ugyanahhoz actionIda kezelőhöz több kezelőt is regisztrálhat. Egymás után futnak. Az API csendben figyelmen kívül hagyja ugyanazt a függvényhivatkozást kétszer ugyanahhoz actionIda függvényhez. Az API nem tesz semmit, ha Microsoft 365 Copilot nincs engedélyezve.

Beépített műveleti azonosítók

Az alábbi műveletazonosítók automatikusan regisztrálják a platform alapértelmezett kezelőit. A removeDefaultActionHandlers használatával egyéni kezelőket is hozzáadhat hozzájuk, vagy először eltávolíthatja az alapértelmezett kezelőket.

Műveletazonosító	Description	Adattulajdonságok
MS.PA.CopilotChat.OpenRecord	Megnyitja a rekordot.	entity (karakterlánc) – tábla logikai neve; recordId (karakterlánc) – rekordazonosító
MS.PA.CopilotChat.NavigateToView	Egy nézetre navigál.	entity (karakterlánc) – tábla logikai neve; fetchXml (karakterlánc) – FetchXML-lekérdezés

Example

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

Kapcsolódó cikkek

removeActionHandler metódus
Xrm.Copilot (Ügyfél API-referencia)