Tạo hoặc chỉnh sửa một thực thể ảo có chứa dữ liệu từ nguồn bên ngoài

Chủ đề này áp dụng cho Dynamics 365 Customer Engagement (on-premises). Đối với phiên bản Power Apps thuộc chủ đề này, hãy xem: Tạo và chỉnh sửa các thực thể ảo chứa dữ liệu từ nguồn dữ liệu bên ngoài

Một thực thể ảo là một thực thể tuỳ chỉnh trong Dynamics 365 Customer Engagement (on-premises) có các trường chứa dữ liệu từ một nguồn dữ liệu bên ngoài. Các thực thể ảo xuất hiện trong ứng dụng của bạn cho người dùng là các bản ghi thực thể thường, nhưng chứa dữ liệu mà có nguồn từ cơ sở dữ liệu bên ngoài, như một Cơ sở Dữ liệu Azure SQL. Các bản ghi dựa trên thực thể ảo có sẵn trong tất cả các máy khách, bao gồm cả các máy khách tùy chỉnh được phát triển bằng Dịch vụ web Dynamics 365 Customer Engagement.

Trước đây, để tích hợp các nguồn dữ liệu khác nhau, bạn sẽ cần tạo một trình kết nối để di chuyển dữ liệu hoặc phát triển một phần bổ trợ tùy chỉnh phía máy chủ hay máy khách. Tuy nhiên, với các thực thể ảo bạn có thể kết nối trực tiếp với một nguồn dữ liệu bên ngoài trong thời gian chạy để các dữ liệu cụ thể từ nguồn dữ liệu bên ngoài có sẵn trong môi trường mà không cần sao chép dữ liệu.

Các thực thể ảo được tạo thành từ ba thành phần chính, a trình cung cấp dữ liệu, a nguồn dữ liệu bản ghi và a thực thể ảo. Trình cung cấp dữ liệu bao gồm các phần bổ trợ và thực thể nguồn dữ liệu. Nguồn dữ liệu là một bản ghi thực thể trong Dynamics 365 Customer Engagement (on-premises), bao gồm siêu dữ liệu thể hiện sơ đồ của các thông số kết nối. Mỗi thực thể ảo tham chiếu một nguồn dữ liệu trong định nghĩa thực thể.

Dynamics 365 Customer Engagement (on-premises) bao gồm một Nhà cung cấp dữ liệu OData mà bạn có thể sử dụng để liên kết với một dịch vụ web OData v4 có thể truy cập dữ liệu bên ngoài.

Ngoài ra, các nhà phát triển cũng có thể xây dựng các trình cung cấp dữ liệu của riêng họ. Trình cung cấp dữ liệu được cài đặt trong môi trường dưới dạng một giải pháp. Thông tin thêm: Bắt đầu với thực thể ảo

Lợi ích của thực thể ảo

• Nhà phát triển có thể triển khai phần bổ trợ để đọc dữ liệu bên ngoài bằng cách sử dụng Dịch vụ web Dynamics 365 Customer Engagement và công cụ Đăng ký phần bổ trợ Customer Engagement.

• Người tùy chỉnh hệ thống sử dụng Dynamics 365 Customer Engagement (on-premises) để đặt cấu hình bản ghi nguồn dữ liệu và tạo các thực thể ảo được sử dụng để truy cập dữ liệu bên ngoài mà không cần viết mã.

• Người dùng cuối dùng những bản ghi mà thực thể ảo tạo ra để xem dữ liệu trong các trường, lưới, kết quả tìm kiếm, bảng thông tin và báo cáo dựa trên XML tìm nạp dữ liệu.

Thêm một nguồn dữ liệu để sử dụng cho thực thể ảo

Các nhà phát triển tạo ra một bổ trợ tuỳ chỉnh để sử dụng như nhà cung cấp dữ liệu cho một thực thể ảo. Ngoài ra, bạn có thể sử dụng nhà cung cấp dữ liệu OData v4 đã được cung cấp. Thông tin thêm: Cấu hình, yêu cầu và phương pháp hay nhất của OData v4 trình cung cấp dữ liệu

1. Đi tới Cài đặt>Quản trị>Nguồn dữ liệu thực thể ảo.

2. Trên thanh công cụ hành động, chọn Mới.

3. Trên hộp thoại Chọn trình cung cấp dữ liệu, chọn từ các nguồn dữ liệu sau rồi chọn OK.

   • Tùy chỉnh trình cung cấp dữ liệu. Nếu bạn đã nhập một phần bổ trợ trình cung cấp dữ liệu thì trình cung cấp dữ liệu sẽ xuất hiện ở đây. Thông tin thêm: Bắt đầu với thực thể ảo

   • OData v4 trình cung cấp dữ liệu. Dynamics 365 Customer Engagement (on-premises) bao gồm một Nhà cung cấp dữ liệu OData có thể sử dụng với các dịch vụ web OData v4. Thông tin thêm: Cấu hình, yêu cầu và phương pháp hay nhất của OData v4 trình cung cấp dữ liệu

Thêm một trường bảo đảm vào một Nguồn dữ liệu

Bạn tạo ra các trường cho một Nguồn dữ liệu theo cách giống với bất kỳ thực thể nào khác. Đối với dữ liệu được mã hóa hoặc nhạy cảm, kích hoạt thuộc tính bí mật Nguồn dữ liệu trên các trường tùy chỉnh của Nguồn dữ liệu. Ví dụ, để bảo đảm một trường có chứa một chuỗi kết nối cơ sở dữ liệu.

Lưu ý

Các thuộc tính bí mật Nguồn dữ liệu chỉ có sẵn với các trường được thêm vào một biểu mẫu Nguồn dữ liệu.

Tạo thực thể ảo

Bạn tạo một thực thể ảo giống như bất kỳ thực thể nào khác trong Customer Engagement bằng cách bổ sung một số thuộc tính bổ sung được mô tả ở đây.

Lưu ý

Mặc dù bạn có thể tạo một thực thể ảo bằng cách chọn Không làm nguồn dữ liệu, nhưng để thu thập dữ liệu, thực thể ảo cần có nguồn dữ liệu. Thông tin thêm: Thêm nguồn dữ liệu để sử dụng cho thực thể ảo

1. Chuyển đến Thiết đặt>Tùy chỉnh>Tùy chỉnh Hệ thống.

2. Trong trình khám phá giải pháp, hãy tạo một thực thể mới. Để thực hiện việc này, hãy chọn Thực thể trong ngăn điều hướng bên trái, sau đó chọn Mới.

3. Trên tab Chung của Định nghĩa thực thể, chọn Thực thể ảo, sau đó trong nguồn dữ liệu danh sách thả xuống, hãy chọn nguồn dữ liệu mà bạn muốn.

   

4. Trên Định nghĩa Thực thể, hoàn tất các trường bắt buộc sau.

   • Tên bên ngoài. Nhập tên bảng trong nguồn dữ liệu bên ngoài mà thực thể này gắn với.

   • Tên bộ sưu tập bên ngoài. Nhập tên số nhiều của bảng trong nguồn dữ liệu bên ngoài mà thực thể này gắn với.

     Dưới đây là ví dụ về một thực thể ảo có tên Phim sử dụng Azure Cosmos DB trình cung cấp dữ liệu để truy cập các tệp tài liệu.

   

   Quan trọng

   Một số tùy chọn, chẳng hạn như Nhóm truy cập, Hàng đợi và Tạo nhanh, không khả dụng với thực thể ảo. Thông tin thêm: Những điều cần cân nhắc khi bạn sử dụng thực thể ảo

   Hoàn thành các thuộc tính bắt buộc và tùy chọn bổ sung, chẳng hạn như tên hiển thị và tên số nhiều, nếu cần. Để biết thêm thông tin về các thuộc tính này, hãy xem Tạo và chỉnh sửa thực thể.

5. Tạo và thêm một hoặc nhiều trường cho thực thể ảo. Ngoài các thuộc tính trường tiêu chuẩn cần để tạo trường tùy chỉnh, những thuộc tính tùy chọn này có sẵn cho mỗi trường tùy chỉnh bạn tạo cho thực thể ảo.

   • Tên bên ngoài. Đây thường là tên duy nhất để xác định dữ liệu bạn muốn hiển thị trong trường.

   Lưu ý

   Nếu loại trường mà bạn tạo là Bộ Tùy chọn thì các trường bổ sung sau đây sẽ có sẵn.

   • Tên loại bên ngoài. Thuộc tính này ánh xạ đến tên bên ngoài của bộ giá trị trong dịch vụ bên ngoài cho bộ tùy chọn. Thông thường, đó có thể là giá trị enum hoặc tên của nhóm giá trị chuỗi. Có thể sử dụng Tên Loại Bên ngoài khi yêu cầu có tên đầy đủ điều kiện. Ví dụ: như Tên loại với OData trong đó các tham số trong truy vấn cần có tên đủ điều kiện, chẳng hạn như [Tên loại].[Giá trị].
   • Giá trị bên ngoài. Thuộc tính này ánh xạ đến giá trị tương ứng trong nguồn dữ liệu bên ngoài cho mục bộ tùy chọn. Giá trị được nhập này dùng để xác định hiển thị mục bộ tùy chọn nào trong ứng dụng.

   Hoàn thành các thuộc tính bổ sung nếu cần. Để biết thêm thông tin về các thuộc tính này, hãy xem Tạo và chỉnh sửa các trường.

6. Chọn Lưu và đóng trên trang thuộc tính Trường .

7. Trên thanh công cụ của trình khám phá giải pháp, hãy chọn Lưu.

8. Trên thanh công cụ của trình khám phá giải pháp, hãy chọn Xuất bản.

9. Đóng trình khám phá giải pháp.

Các cân nhắc khi bạn sử dụng thực thể ảo

Thực thể ảo có các hạn chế.

• Tất cả các thực thể ảo đều thuộc loại chỉ đọc.

• Các thực thể đã có không thể chuyển đổi thành thực thể ảo.

• Theo mặc định, các thực thể ảo chỉ chứa một trường Id và Tên. Các trường khác do hệ thống quản lý, chẳng hạn như Trạng thái hoặc Ngày tạo/Ngày sửa đổi được hỗ trợ.

• Các thực thể ảo không hỗ trợ các trường tùy chỉnh với các loại dữ liệu Tiền tệ, Hình ảnh, hoặc Khách hàng.  

• Các thực thể ảo không hỗ trợ tính năng kiểm tra.

• Không thể sử dụng các trường thực thể ảo trong các trường tính toán hoặc tổng số.  

• Một thực thể ảo không thể là loại thực thể hoạt động.

• Nhiều tính năng ảnh hưởng đến hàng bảng của thực thể không thể được kích hoạt với các thực thể ảo. Các ví dụ bao gồm các hàng đợi, quản lý kiến thức, SLA, phát hiện trùng lặp, theo dõi sự thay đổi, tính năng Mobile Offline, bảo mật trường, Tìm kiếm liên quan, giải pháp cổng thông tin web Cổng thông tin cho Dynamics 365 Customer Engagement (on-premises) và mối quan hệ N:N giữa các thực thể ảo.

• Các thực thể ảo là của riêng các tổ chức và không hỗ trợ các khái niệm bảo mật Commond Data Service for Apps cấp hàng. Bạn nên triển khai mô hình bảo mật của riêng mình đối với nguồn dữ liệu bên ngoài.

• Bạn nên nhắm mục tiêu nguồn dữ liệu đơn lẻ khi sử dụng các thực thể ảo trong Tìm kiếm Nâng cao. Ví dụ: việc tạo một Tìm kiếm Nâng cao cuối cùng tạo ra một liên kết giữa dữ liệu gốc Dataverse và dữ liệu bên ngoài thực thể ảo không được hỗ trợ.

• Các thuộc tính siêu dữ liệu của trường được kiểm duyệt trong bản cập nhật không áp dụng cho các thực thể ảo. Ví dụ, một trường số nguyên trong một trường thực thể ảo có thể được đặt với giá trị tối thiểu là 0. Tuy nhiên, vì giá trị được lấy từ một nguồn dữ liệu bên ngoài nên một truy vấn sẽ trả lại giá trị nhỏ hơn 0 khi được truy xuất từ một thực thể ảo. Thuộc tính giá trị tối thiểu không được áp dụng trong truy vấn này. Bạn vẫn cần phải lọc các giá trị để chúng lớn hơn 0 nếu đó là điều được mong muốn.

• Thực thể ảo không hỗ trợ theo dõi thay đổi và không thể đồng bộ hóa bằng cách sử dụng tính năng Customer Engagement, chẳng hạn như Dịch vụ Xuất dữ liệu.

• Luồng quy trình công việc không được hỗ trợ với các thực thể ảo. Thông tin thêm: Đã nhận được lỗi không mong muốn khi người dùng kích hoạt dòng quy trình công việc

Đã nhận được lỗi không mong muốn khi người dùng kích hoạt dòng quy trình công việc

Khi người dùng cố gắng kích hoạt dòng quy trình công việc, họ có thể nhận được thông báo "lỗi không mong muốn". Xem tệp nhật ký, mục nhật ký sau được hiển thị.

Mã lỗi: 0x80040216 Thông báo: System.Web.HttpUnhandledException: Ngoại lệ của loại 'System.Web.HttpUnhandledException' đã xảy ra. ---> Microsoft.Crm.CrmException: không thể bật dòng quy trình công việc cho Thực thể ảo

Sự cố này xảy ra do các thực thể ảo không hỗ trợ dòng quy trình công việc.

Xem thêm

Các yêu cầu và phương pháp hay nhất của OData v4 trình cung cấp dữ liệu
Tạo và chỉnh sửa các thực thể
Tạo và chỉnh sửa các trường