Chia sẻ qua

Cấu hình Trình dữ liệu OData v4 và phương pháp hay nhất

  • Bài viết

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: Cấu hình OData v4 trình cung cấp dữ liệu

Chủ đề này mô tả cách đặt cấu hình nhà cung cấp dữ liệu OData v4 cũng như các yêu cầu và biện pháp tốt nhất được đề xuất để sử dụng nhà cung cấp dữ liệu OData v4 kết nối với dịch vụ web OData v4.

Những điều tốt nhất về OData v4 data provider

  • Phiên bản của bạn yêu cầu tất cả các thực thể có một thuộc tính ID. ID này được gọi là một mã định danh duy nhất và giá trị phải là một guid. Bạn chỉ có thể sắp xếp trường ID bên ngoài với loại dữ liệu EDM.Guid. Bạn không thể ánh xạ loại dữ liệu EDM.Int32 với trường loại dữ liệu có mã định danh duy nhất.

  • Thực thể OData với thuộc rỗng phải được cài đặt để phù hợp với trường được sắp xếp trong thực thể ảo. Ví dụ: thuộc tính thực thể OData có Nullable=False phải có trường được ánh xạ với thuộc tính Yêu cầu trường được đặt thành Yêu cầu nghiệp vụ.

  • Để truy xuất nhiều truy vấn, như là khi bạn tải dữ liệu vào lưới, kiểm soát kích thước của tập dữ liệu trả về từ nguồn dữ liệu bên ngoài bằng cách sử dụng tham số truy vấn chọn và lọc.

  • Nếu bị vô hiệu hóa, quản trị viên hệ thống cần cho phép theo dõi phần bổ trợ. Một khi được cho phép, tất cả lỗi từ điểm cuối của OData được chụp lại trên nhật ký theo dõi phần bổ trợ. Thông tin thêm: Hộp thoại Cài đặt hệ thống - tab Tùy chỉnh

Sắp xếp loại dữ liệu

Bảng sau liệt kê các ánh xạ loại dữ liệu Mô hình Dữ liệu Thực thể (EDM) OData với loại dữ liệu phù hợp.

Loại Dữ liệu OData Loại Dữ liệu
Edm.Boolean Hai Tùy chọn
Edm.DateTime Ngày và Thời gian
Edm.DateTimeOffset Ngày và Thời gian
Edm.Decimal Tiền tệ và Số Thập phân
Edm.Double Số thực Dấu phẩy Động
Edm.Guid Mã định danh duy nhất
Edm.Int32 Số Nguyên
Edm.Int64 Số Nguyên
Edm.String Một Dòng Văn bản hoặc Nhiều Dòng Văn Bản

Loại dữ liệu OData EDM mà không hỗ trợ sắp xếp với thực thể ảo

  • Edm.Binary

  • Edm.Time

  • Edm.Float

  • Edm.Single

  • Edm.Int16

  • Edm.Byte

  • Edm.SByte

Thêm nguồn dữ liệu bằng cách sử dụng OData v4 Data Provider

Thủ tục này chỉ cho bạn cách sử dụng OData Data Provider sẵn có để sử dụng dưới dạng nguồn dữ liệu thực thể ảo.

  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.

    • OData v4 trình cung cấp dữ liệu. Môi trường của bạn bao gồm nhà cung cấp dữ liệu Odata v4 có thể được dùng để kết nối với các nguồn dữ liệu hỗ trợ tiêu chuẩn mở OData v4.

    • 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

  4. Trên trang thuộc tính Nguồn Dữ liệu Mới, hãy hoàn thành các trường sau, sau đó lưu bản ghi.

    • Tên. Nhập tên mô tả nguồn dữ liệu.

    • Uri. Nếu bạn đang sử dụng OData Data Provider, nhập uri cho dịch vụ web OData. Ví dụ: nếu bạn đang sử dụng nhà cung cấp OData để kết nối với dịch vụ web được lưu trữ trong Azure, URI có thể trông giống như https://contosodataservice.azurewebsites.net/odata/

    • Thời gian chờ tính bằng giây. Nhập số giây để chờ một phản hồi từ dịch vụ web trước thời gian chờ yêu cầu dữ liệu. Ví dụ, nhập 30 để chờ tối đa 30 giây trước khi chạy thời gian chờ.

    • Chế độ phân trang. Chọn để sử dụng dàn trang phía máy chủ hoặc phía khách hàng để kiểm soát xem kết quả truy vấn được dàn như thế nào. Giá trị mặc định là dàn trang phía khách hàng. Với dàn trang phía máy chủ, chủ kiểm soát kết quả được dàn như thế nào bằng cách sử dụng tham số $skiptoken được thêm vào chuỗi truy vấn. Thông tin thêm: Bỏ qua tùy chọn truy vấn hệ thống mã thông báo ($skiptoken)

      • Trả về số lượng nội tuyến. Quay lại tổng số bản ghi trong bộ kết quả. Thiết đặt này được dùng để bật chức năng trang tiếp theo khi bạn trả dữ liệu về lưới. Sử dụng giá trị sai nếu điểm cuối OData không hỗ trợ tham số $inclinecount của OData. Giá trị mặc định là sai.

    • Tham số yêu cầu. Hoặc bạn cũng có thể thêm các tham số chuỗi truy vấn hoặc đầu đề tùy chỉnh dùng để kết nối với dịch vụ web OData, chẳng hạn như các tham số xác thực dịch vụ ngoài. Chọn Chuỗi truy vấn để chuyển đổi giữa tham số và giá trị của tiêu đề và chuỗi truy vấn. Có thể thêm tối đa 10 chuỗi truy vấn hoặc đầu đề.

    Bản ghi ảo nguồn dữ liệu thực thể.

Xem thêm

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
Blog TechNet: Tương tác với dữ liệu từ các hệ thống bên ngoài bằng cách sử dụng các thực thể ảo mới