addActionHandler (препратка към API на клиент)

Регистрира потребителска функция за манипулатор за Microsoft 365 Copilot действие.

Синтаксис

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

Параметри

Име на параметър	Тип	Задължителни	Описание
actionId	низ	Да	Еднозначният идентификатор на действието, което трябва да се обработи.
actionHandler	Функция	Да	Функцията за извикване при активиране на действието. Получава полезния обем от данни на действието като аргумент.
successCallback	Функция	Да	Функция, която да извика, когато операцията е успешна.
errorCallback	Функция	Да	Функция, която да се извика, когато операцията е неуспешна.

Върната стойност

Вид: Promise<void>

Забележки

Можете да регистрирате няколко манипулатора за един и същ actionId. Те се изпълняват последователно. API негласно игнорира регистрирането на една и съща препратка към функция два пъти за един и същ actionId. API не прави нищо, ако Microsoft 365 Copilot не е разрешен.

Вградени ИД на действия

Следните ИД на действия имат автоматично регистрирани манипулатори по подразбиране за платформата. Можете да добавите манипулатори по избор до тях или първо да премахнете манипулаторите по подразбиране, като използвате removeDefaultActionHandlers.

ИД на действие	Описание	Свойства на данни
MS.PA.CopilotChat.OpenRecord	Отваря запис.	entity (низ) – логическо име на таблица; recordId (низ) – ИД на запис
MS.PA.CopilotChat.NavigateToView	Преминава към изглед.	entity (низ) – логическо име на таблица; fetchXml (низ) – Заявка FetchXML

Пример

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
Xrm.Copilot (препратка към API на клиент)