addActionHandler (Bezeroaren API erreferentzia)

Microsoft 365 Copilot ekintzarako kudeatzaile pertsonalizatu bat erregistratzen du.

Sintaxia

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

Parametroak

Parametroaren izena Mota Beharrezkoa Deskribapenak
actionId kate Bai Kudeatu beharreko ekintzaren identifikatzaile bakarra.
actionHandler Funtzioa Bai Ekintza aktibatzen denean deitzeko funtzioa. Ekintzaren datu-karga argumentu gisa jasotzen du.
successCallback Funtzioa Bai Eragiketa behar bezala egiten denean deitzen zaion funtzioa.
errorCallback Funtzioa Bai Eragiketan akats bat gertatzen denean deitzen zaion funtzioa.

Itzultze-balioa

Mota: Promise<void>

Oharrak

Hainbat kudeatzaile erregistratu ditzakezu aldi berean actionId. Sekuentzialki exekuzionatzen dira. APIak isilean alde batera uzten du funtzio erreferentzia bera bi aldiz erregistratzea.actionId APIak ez du ezer egiten Microsoft 365 Copilot gaituta ez badago.

Barneko ekintza IDak

Ondorengo ekintza IDek plataforma-lehenetsitako kudeatzaileak automatikoki erregistratzen dituzte. Handler pertsonalizatuak gehitu ditzakezu haiekin batera, edo lehenik lehenik kendu lehenetsitako handler-ak removeDefaultActionHandlers erabiliz.

Ekintza IDa Deskribapenak Datuen propietateak
MS.PA.CopilotChat.OpenRecord Erregistro bat irekitzen du. entity (katea) — taula logikoaren izena; recordId (katea) — erregistroaren IDa
MS.PA.CopilotChat.NavigateToView Ikuspegi batera nabigatzen du. entity (katea) — taula logikoaren izena; fetchXml (katea) — FetchXML kontsulta

Adibidea

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 metodoa
Xrm.Copilot (Bezeroaren APIaren erreferentzia)

  • Last updated on