Thiết lập, yêu cầu và những điều tốt nhất của OData v4 Data Provider

Chủ đề này mô tả cách thiết lập OData v4 Data Provider cũng như các yêu cầu và những điều tốt nhất được khuyến nghị khi sử dụng OData v4 data provider để 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

  • Microsoft Dataverse yêu cầu tất cả bảng có thuộc tính ID, ID này được biết đến như là mã định danh duy nhất và giá trị phải là một guid. Bạn chỉ có thể ánh xạ cột ID tới cột bên ngoài bằng loại dữ liệu Edm.Guid. Bạn không thể ánh xạ loại dữ liệu Edm.Int32 tới cột loại dữ liệu Mã định danh duy nhất trong Dataverse.
  • Bảng OData có thuộc tính rỗng phải được đặt sao cho phù hợp với cột được ánh xa trong bảng ảo. Ví dụ: một thuộc tính bảng OData với Nullable=False phải đặt cột ánh xạ trong thuộc tính Dataverse Yêu cầu của trường thành Bắt buộc đối với doanh nghiệp.
  • Để 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ướng dẫn cho Quản trị viên: hộp thoại Thiết đặt Hệ thống - tab Tùy chỉnh
  • Bạn không thể sử dụng Nhà cung cấp dữ liệu OData v4 để kết nối với môi trường khác.

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 bảng OData (EDM) với các loại dữ liệu Dataverse.

Loại Dữ liệu OData Dataverse 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ợ ánh xạ với bảng ả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 bảng ảo.

  1. Chuyển tới Thiết đặt > Quản trị > Nguồn Dữ liệu Thực thể Ảo.

  2. Trên thanh công cụ tác vụ, bấm vào Mới.

  3. Trên ô thoại Chọn Nhà cung cấp Dữ liệu, hãy chọn từ các nguồn dữ liệu sau rồi bấm vào OK.

    • Nhà cung cấp Dữ liệu OData v4. Dataverse bao gồm trì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.
    • Trình cung cấp dữ liệu tùy chỉnh. 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: Tài liệu dành cho nhà phát triển: Bắt đầu với các bảng ảo
  4. Trên trang thuộc tính Nguồn Dữ liệu Mới, hãy hoàn thành các cột sau rồi lưu hàng.

    • 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 một dịch vụ web được lưu trữ trong Azure, URI có thể tương tự như https://contosodataservice.azurewebsites.net/odata/.
    • Thời gian chờ tính theo 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ế độ dà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)
      • Quay lại bộ đếm nội tuyến. Quay lại tổng số hàng 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ố $inlinecount của OData. Giá trị mặc định là sai.
    • Yêu cầu Tham số. 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. Bấm vào Chuỗi Truy vấn để chuyển đổi giữa tham số và giá trị chuỗi truy vấn và đầu đề. Có thể thêm tối đa 10 chuỗi truy vấn hoặc đầu đề.

      Hàng nguồn dữ liệu bảng ảo.

Xem thêm

Tạo và chỉnh sửa các bảng ảo có chứa dữ liệu từ nguồn dữ liệu bên ngoài

Lưu ý

Bạn có thể cho chúng tôi biết bạn thích dùng ngôn ngữ nào cho tài liệu không? Làm một cuộc khảo sát ngắn. (xin lưu ý, khảo sát này bằng tiếng Anh)

Cuộc khảo sát sẽ mất khoảng bảy phút. Không có dữ liệu cá nhân nào được thu thập (điều khoản về quyền riêng tư).