Chia sẻ qua

executeEvent (Client API reference) (bản xem trước)

Quan trọng

  • Đây là một tính năng xem trước.
  • Các tính năng xem trước không được dùng cho sản xuất và có thể có chức năng bị hạn chế. Các tính năng này phải tuân theo các điều khoản sử dụng bổ sung và có sẵn trước khi phát hành chính thức để khách hàng có thể truy cập sớm và cung cấp phản hồi.

Thực hiện chủ đề Microsoft Copilot Studio dựa trên Tên Sự kiện đã đăng ký. Trả về mảng kiểu MCSResponse.

Cú pháp

Xrm.Copilot.executeEvent(eventName, eventParameters).then(successCallback, errorCallback);

Thông số

Tên tham số Loại Bắt buộc Sự miêu tả
eventName chuỗi Có Tên Sự kiện đã đăng ký trong chủ đề Microsoft Copilot Studio
eventParameters Không biết Có Các tham số cần thiết để thực hiện sự kiện. Những điều này phụ thuộc vào những gì chủ đề thực hiện.
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.

Trả về giá trị

Một mảng MCSResponse

Truy nhập ngữ cảnh ứng dụng

Khi một API Đại lý được gọi, ngữ cảnh cho ứng dụng được chuyển đến chủ đề Studio Copilot thông qua một tập hợp các biến. Sau đây là các biến ngữ cảnh có sẵn như Copilot Studio biến toàn cầu.

Biến Sự miêu tả
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID của bản ghi bảng trên biểu mẫu chính
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Tên lô-gic của bảng trong trang chính
Global.PA__Copilot_Model_PageContext.pageContext.pageName Tên của trang chính
Global.PA__Copilot_Model_PageContext.pageContext.pageType Loại trang chính
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Tên duy nhất của ứng dụng dựa trên mô hình

Ví dụ: sử dụng Global.PA__Copilot_Model_PageContext.pageContext.id.guid và Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, có thể truy xuất bản ghi của biểu mẫu từ Dataverse.

Truy nhập eventParameters

Trong chủ đề Copilot Studio, có thể truy eventParameters cập từ lệnh gọi API bằng cách sử dụng biến .Activity.Value Sử dụng nút giá trị Phân tích cú pháp để chuyển đổi JSON thành bản ghi có một hoặc nhiều trường. Việc chọn Từ dữ liệu mẫu cho Kiểu dữ liệu cho phép cung cấp ví dụ về JSON để tạo bản ghi.

Ví dụ:

Trong Microsoft Copilot Studio, nơi một chủ đề được đăng ký chấp nhận ID (ID bản ghi thực thể) làm tham số đầu vào. Dựa trên dữ liệu nhập, nó truy xuất các hoạt động liên quan của bản ghi thực thể đó và trả về kết quả dưới dạng hoạt động sự kiện Copilot Studio.

const response = await Xrm.Copilot.executeEvent( 
    "Microsoft.PowerApps.Copilot.RelatedActivities", 
    { id:"aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"});

Câu trả lời

[
    {
        "type": "event",
        "timestamp": "2025-02-05T16:05:53.4074714+00:00",
        "replyToId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "attachments": [],
        "value": {
            "@odata.context": "https://*.dynamics.com/api/data/v9.2/$metadata#activitypointers(subject,prioritycode)",
            "value": [
                {
                    "@odata.etag": "W/\"6825587\"",
                    "@odata.type": "#Microsoft.Dynamics.CRM.phonecall",
                    "activityid": "cccccccc-2222-3333-4444-dddddddddddd",
                    "activitytypecode": "phonecall",
                    "prioritycode": 2,
                    "subject": "Discuss new opportunity (sample)"
                },
                {
                    "@odata.etag": "W/\"6826236\"",
                    "@odata.type": "#Microsoft.Dynamics.CRM.phonecall",
                    "activityid": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
                    "activitytypecode": "phonecall",
                    "prioritycode": 2,
                    "subject": "Likes our new products (sample)"
                }
            ]
        },
        "name": "MS.CopilotApiDemo.RelatedActivities"
    }
]

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

  • Last updated on