addActionHandler (Tài liệu tham khảo về API máy khách)

Đăng ký hàm bộ xử lý tùy chỉnh cho một Microsoft 365 Copilot động mới.

Cú pháp

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

Tham số

Tên tham số Loại Bắt buộc Mô tả
actionId chuỗi Có Mã định danh duy nhất của hành động cần xử lý.
actionHandler Hàm Có Hàm để gọi khi kích hoạt hành động. Nhận tải trọng dữ liệu của hành động làm đối số.
successCallback Hàm Có Một hàm để gọi khi thao tác thành công.
errorCallback Hàm Có Một hàm để gọi khi hoạt động không thành công.

Giá trị trả về

Kiểu: Promise<void>

Nhận xét

Bạn có thể đăng ký nhiều bộ xử lý cho cùng một actionId. Chúng chạy tuần tự. API âm thầm bỏ qua việc đăng ký cùng một tham chiếu hàm hai lần cho cùng một actionId. API không làm gì nếu Microsoft 365 Copilot không được bật.

ID hành động tích hợp sẵn

ID hành động sau đây có bộ xử lý mặc định nền tảng được đăng ký tự động. Bạn có thể thêm các bộ xử lý tùy chỉnh cùng với chúng hoặc loại bỏ các bộ xử lý mặc định trước tiên bằng cách sử dụng removeDefaultActionHandlers.

ID Hành động Mô tả Thuộc tính dữ liệu
MS.PA.CopilotChat.OpenRecord Mở bản ghi. entity (chuỗi) — tên lô-gic của bảng; recordId (chuỗi) — ID bản ghi
MS.PA.CopilotChat.NavigateToView Dẫn hướng đến dạng xem. entity (chuỗi) — tên lô-gic của bảng; fetchXml (chuỗi) — Truy vấn FetchXML

Ví dụ:

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

phương pháp removeActionHandler
Xrm.Copilot (Tài liệu tham khảo về API máy khách)

  • Last updated on