OData v4 資料提供者設定和最佳做法
本主題適用於 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 個標頭或查詢字串。
