OData v4 資料提供者設定和最佳做法

發行項
03/29/2023

本主題適用於 Dynamics 365 Customer Engagement (on-premises)。有關本主題的 Power Apps 版本，請參閱： OData v4 資料提供者設定

本主題搭配如何設定 OData v4 資料提供者，以及使用 OData v4 資料提供者與 OData v4 Web 服務進行連接的需求和建議最佳做法。

OData v4 資料提供者最佳做法

您的執行個體需要所有的實體都有 ID 屬性。此 ID 稱為唯一識別碼，而且值必須是 GUID。您只能將 ID 欄位對應至資料類型為 EDM.Guid 的外部欄位。您不可將 EDM.Int32 資料類型對應至 uniqueidentifer 資料類型欄位。
具有可為 Null 屬性的 OData 實體必須設定成符合虛擬實體中的已對應欄位。例如，Nullable=False 的 OData 實體屬性 (Property) 必須有 [欄位需求] 屬性 (Attribute) 設定為業務需求的對應欄位。
擷取多個查詢時 (例如在網格中載入資料時)，請使用 select 和 filter 查詢參數來控制外部資料來源傳回的資料集大小。
如果尚未啟用外掛程式追蹤，則系統管理員必須啟用此功能。啟用後，OData 端點發生的所有錯誤都會擷取到外掛程式追蹤記錄檔中。其他資訊：系統設定對話方塊 - 自訂索引標籤

資料類型對應

下表列出與適當資料類型對應的 OData 實體資料模型 (EDM) 資料類型。

OData 資料類型	資料類型
Edm.Boolean	兩個選項
Edm.DateTime	日期及時間
Edm.DateTimeOffset	日期及時間
Edm.Decimal	十進位數或貨幣
Edm.Double	浮點數
Edm.Guid	唯一識別碼
Edm.Int32	整數
Edm.Int64	整數
Edm.String	單行文字或多行文字

不支援與虛擬實體對應的 OData EDM 資料類型

Edm.Binary
Edm.Time
Edm.Float
Edm.Single
Edm.Int16
Edm.Byte
Edm.SByte

使用 OData v4 資料提供者新增資料來源

此程序告訴您如何使用立即可用的 OData 資料提供者做為虛擬實體資料來源。

移至設定>管理>虛擬實體資料來源。
在動作工具列上選取新增。
在 [選取資料提供者] 對話方塊中，從下列資料來源選取，然後選取確定。
- OData v4 資料提供者。您的環境包含 Odata v4 資料提供者，可用來連接至支援 OData v4 開放標準的資料來源。
- 自訂資料提供者。如果您已匯入資料提供者外掛程式，這裡就會顯示此資料提供者。其他資訊：開始使用虛擬實體
在 [新增資料來源] 內容頁面中，完成下列欄位，然後儲存記錄。
- 名稱. 輸入描述資料來源的名稱。
- URI。如果您使用 OData 資料提供者，請輸入 OData Web 服務的 URI。例如，如果使用 OData 提供者連接至裝載於 Azure 的 Web 服務，URI 可能看起來類似 https://contosodataservice.azurewebsites.net/odata/
- 逾時 (秒)。輸入資料要求逾時之前等待 Web 服務回應的秒數。例如，輸入 30 表示最多先等待三十秒，然後才發生逾時。
- 分頁模式。選取要透過用戶端還是伺服器端分頁來控制查詢結果分頁方式。預設值為用戶端分頁。使用伺服器端分頁時，伺服器會使用新增至查詢字串的 $skiptoken 參數來控制結果分頁方式。其他資訊：跳過權杖系統查詢選項 ($skiptoken)
  - 傳回內嵌計數。傳回結果集中的記錄總數。將資料傳回至網格時，使用此設定來下一頁功能。如果 OData 端點不支援 OData $inclinecount 參數，請使用 false 的值。預設值為 false。
- 要求參數。或者，也可以新增用於連接至 OData Web 服務的自訂標頭或查詢字串參數，例如外部服務的驗證參數。選取查詢字串可在標頭與查詢字串參數及值之間切換。最多可新增 10 個標頭或查詢字串。

另請參閱

建立和編輯包含外部資料來源中的資料的虛擬實體
 TechNet 部落格：使用新的虛擬實體與外部系統的資料互動

共用方式為