Dataverse 資料表提供 所有環境資料庫都具有的通用資料表集。
已啟用 Dynamics 365 的應用程式資料表/實體參考 包含安裝 Dynamics 365 應用程式 (例如 Field Service) 之前所需的其他資料表。
當您選擇安裝 Dynamics 365 Field Service 並將 Dataverse 新增至您建立的環境時,會新增或修改此處列出的資料表。 如果您的 Dataverse 環境中安裝了其他應用程式,資料表結構描述的外觀可能會有所不同。
備註
本參考文件不包括您環境中存在的特定資料表。 例如,僅供內部使用的數據表,我們認為與 Field Service 開發人員不太相關。 資料表結構描述的變更不會立即反映,因為我們會在特定間隔內產生此文件。
我們已於 2025 年 2 月推出此參考文件。 當我們收集初步回饋並解決時,您可能會更頻繁地注意到變更。
若要檢視 Dataverse 環境中所有資料表的目前和未篩選的資訊,請使用資料表定義瀏覽器。 表格定義瀏覽器是瀏覽 環境中的表格定義中所述的受管理解決方案。
此參考僅包含下列資料表:
IsPrivate 等於
false- 這不包括不存在外部使用案例的資料表。 深入瞭解私人資料表
IsIntersect 等於或
falseIsIntersect 等於,true且資料表包含超過 4 個資料行。- 大部分的相交資料表只包含支援多對多關係所需的 4 個資料行。 它們沒有用。 具有四欄以上的相交表格更有趣。
Messages
此清單中的訊息適用於實體。 例如,使用者擁有的資料表支援 Assign、 GrantAccess、 ModifyAccess和 RevokeAccess 訊息,而組織擁有的資料表則不支援。
適用於 .NET 的 SDK
使用適用於 .NET 的 SDK 時,您通常可以叫用屬於 Microsoft.Crm.Sdk.Messages 或 Microsoft.Xrm.Sdk.Messages 命名空間的對應要求類別。 這些類別的名稱包含 Request 新增至訊息名稱的字首。
某些訊息會新增為其支援的解決方案的 自訂動作 。 這些訊息不會在 SDK 元件中定義,但 有數種方式可以使用它們。
網路應用程式介面
使用 Web API 時,您可以找到以下參考中定義的常見 Dataverse OData 函數和動作:
對於這些功能和動作,以及新增的任何其他功能和動作,您可以透過以下方式探索如何使用這些功能和動作:
- 請檢查 $metadata服務文件 ,以取得參數及傳回值的詳細資料。 如需詳細資料,請參閱 動作定義 和 函數定義 。
- 叫用動作和函數。 如需詳細資訊,請參閱 使用 Web API 動作 和 使用 Web API 函數 。
活動
事件是存在的訊息,以便您可以訂閱它們。 除非您新增事件,否則您不應該叫用訊息,而應該訂閱它。 您可以透過數種不同的方式訂閱事件,例如:
- 使用 Power Automate Dataverse 連接器,使用執行 動作時 觸發器。
- 註冊 Dataverse 外掛程式以回應事件。
- 將事件資料傳送至 Azure 或具有 Dataverse Azure 整合的 Web 勾點
屬性
此區段包括選取的實體屬性,而不是所有實體屬性。 僅包括那些預計對開發人員最有用的屬性。 某些實體屬性值可以變更。
Columns
資料行會列在兩個不同的區段中: 可寫入的資料行/屬性 和唯 讀資料行/屬性。 此區隔的目的是著重於開發人員在建立或更新資料表中的資料列時可以設定的資料行。 瞭解這些資料行有助於開發人員瞭解除了擷取值之外,他們還可以使用資料表執行哪些動作。
[可寫入資料行/屬性] 區段中的資料行會針對 IsValidForCreate 或 IsValidForUpdate屬性傳回 true (通常兩者)。 如果其中任一屬性傳回 false,則會指出這一點。
唯讀資料行/屬性 一律會針對 IsValidForCreate和IsValidForUpdate 屬性傳回 false。
本參考文件中的選擇欄選項來自以英文為基本語言的部署。 某些選擇選項可能會因建立環境時選取的基底語言而有所不同。 這些差異更緊密地符合最適合語言或文化的選項。 您可以根據需要透過變更標籤或新增和移除選項來自由自訂這些選項。
關係
EntityMetadata 類別包含三個屬性來代表關聯性:
| 房產 | 類型 | Description |
|---|---|---|
| OneToMany關係 | OneToManyRelationshipMetadata[] | 取得實體的一對多關聯性陣列。 |
| 多對一關係 | OneToManyRelationshipMetadata[] | 取得實體的多對一關聯性陣列。 |
| ManyToMany關係 | ManyToManyRelationshipMetadata[] | 取得實體的多對多關聯性陣列。 |
備註
請務必記住,雖然每個表格都會列出適用於它的關聯性,但每個關聯性都由兩個表格共用。 資料表 之間 存在關聯性。 雖然存在一對To-Many 關係,但 多對一 關係只是參照表中一To-Many 關係的檢視。
多對一關係
包括以下屬性 OneToManyRelationship :
| 房產 | Description |
|---|---|
ReferencedEntity |
相關資料表的邏輯名稱。 |
ReferencedAttribute |
相關資料表主索引鍵的邏輯名稱。 |
ReferencingEntity |
具有查閱資料行之相關資料表的邏輯名稱。 |
ReferencingAttribute |
相關資料表中查閱資料行的邏輯名稱,其中包含對主要資料表主索引鍵的參考。 |
IsHierarchical |
關係是否代表自我參照階層關係 |
CascadeConfiguration |
描述在父實體上執行哪些作業的資料將串聯至相關實體。 其他資訊: 串聯設定 |
一對多關係
包括以下屬性 OneToManyRelationship :
| 房產 | Description |
|---|---|
ReferencingEntity |
相關資料表的邏輯名稱。 |
ReferencingAttribute |
相關表格中包含主要表格主索引鍵參照的直欄的邏輯名稱。 |
IsCustomizable |
是否可以變更關係的屬性。 |
ReferencedEntityNavigationPropertyName |
此關聯性的 Web API 集合值導覽屬性名稱。 其他資訊: Web API 導覽屬性 |
AssociatedMenuConfiguration |
模型導向應用程式用來控制是否以及如何從主要實體在 UI 中存取相關實體資料的資料。 |
多對多關係
每個多對多關聯性都包含 Entity1LogicalName 和 Entity2LogicalName。 在本文件中,關係詳細資料會在目前表格的內容中提供。 它是否Entity1Entity2真正重要。
對於每一個多對多關係,都會包含下列屬性:
| 房產 | Description |
|---|---|
IntersectEntityName |
支援此多對多關聯性的相交資料表的邏輯名稱。 您可以使用 FetchXml 聯結資料表資料行時使用此值 |
IsCustomizable |
是否可以變更關係的屬性。 |
SchemaName |
關係的結構描述名稱。 |
IntersectAttribute |
交集表格中作為此類型記錄主索引鍵的直欄名稱。 |
NavigationPropertyName |
此關聯性的 Web API 集合值導覽屬性名稱。 其他資訊: Web API 導覽屬性 |
AssociatedMenuConfiguration |
模型導向應用程式用來控制是否以及如何從此資料表在 UI 中存取第二個資料表資料的資料。 |
在極少數情況下,多對多關聯性是自我參照的,例如連線角色 (ConnectionRole) connectionroleassociation_associationEntity1,或Entity2附加到屬性前面。
| 房產 | 價值觀 |
|---|---|
Entity1IntersectAttribute |
相交資料表中的資料行名稱,該資料行是此類型記錄為主索引鍵作為第一個資料表。 |
Entity2IntersectAttribute |
相交資料表中的資料行名稱,該資料行是此類型記錄為主索引鍵作為第二個資料表。 |
Entity1NavigationPropertyName |
此關聯性的 Web API 集合值導覽屬性名稱,作為第一個資料表。 |
Entity2NavigationPropertyName |
此關聯性的 Web API 集合值導覽屬性名稱,作為第二個資料表。 |
Entity1AssociatedMenuConfiguration |
模型導向應用程式用來控制是否以及如何從此資料表作為第一個資料表在 UI 中存取第二個資料表資料的資料。 |
Entity2AssociatedMenuConfiguration |
模型導向應用程式用來控制是否以及如何從此資料表作為第二個資料表在 UI 中存取第二個資料表資料的資料 |