Dataverse 資料表/實體參考

利用此參考資料了解特定資料表可用的操作、每個資料表的預設欄位,以及資料表間的關係。 資料表定義使用 EntityMetadata 類別。

此參考僅包含下列資料表:

  • EntityMetadata.IsPrivate 等人 false

    此條件排除無外部使用情境的資料表。

  • EntityMetadata.IsIntersect false等於 或 IsIntersect 等true於,且表格包含超過四欄。

    大多數交集表僅包含支持多對多關係所需的四欄。 它們沒什麼用。 超過四欄的交集表較少見,且更有趣。

若要檢視環境中所有資料表的相關資訊,請參閱瀏覽 環境中的資料表定義。

Dynamics 365 產品資料表參考

Dynamics 365 產品使用 Dataverse。 當您為 Dynamics 365 產品建立環境時,環境會為所有 Dynamics 365 產品提供一組通用資料表。 請參閱 Dynamics 365 啟用應用程式表/實體參考資料。

每個特定的 Dynamics 365 產品都可以新增更多資料表。 下表顯示特定 Dynamics 365 產品的資料表參考:

產品文檔 產品表參考
銷售 銷售資料表/實體參考
現場服務 Field Service 資料表/實體參考
客戶服務 客戶服務資料表/實體參考

屬性

此區段包括選取的實體屬性,而不是所有實體屬性。 它只包含對開發者最有用的屬性。 你可以更改某些實體的財產價值。

Columns

欄位分為兩個獨立區塊:

區段 Description
可寫欄位/屬性 欄位,可以在建立或更新資料表中的列時設定。 這些欄位會回傳 trueAttributeMetadata.IsValidForCreate 或 AttributeMetadata.IsValidForUpdate 屬性,通常兩者兼具。 若任一性質返回 false,則表示此條件。
唯讀欄位/屬性 欄位可以取回,但無法在建立或更新資料表的列時設定。 這些欄位總是會回傳 falseAttributeMetadata.IsValidForCreate 和 AttributeMetadata.IsValidForUpdate 屬性。

選擇資料行選項

本參考文件中的選擇欄選項來自以英文為基本語言的部署。 某些選取選項可能會因建立環境時選取的基底語言而有所不同。 這些差異更貼近最適合語言或文化的選項。 你可以透過更改標籤或新增或移除選項來自訂這些選項。

關係

EntityMetadata 類別包含三個屬性來表示關係:

房產 類型 Description
OneToManyRelationships OneToManyRelationshipMetadata[] 取得實體的一對多關聯性陣列。
ManyToOneRelationships OneToManyRelationshipMetadata[] 取得實體的多對一關聯性陣列。
ManyToManyRelationships ManyToManyRelationshipMetadata[] 取得實體的多對多關聯性陣列。

備註

雖然每個資料表列出了適用的關係,但每個關係是兩個資料表共同擁有的。 這些關聯存在於資料表之間。 雖然一對多關係存在,但 多對一 關係只是從參考表中對一對多關係的一種視角。

多對一關係

包含以下 OneToManyRelationshipMetadata 類別 性質:

房產 Description
ReferencedEntity 相關資料表的邏輯名稱。
ReferencedAttribute 相關資料表主索引鍵的邏輯名稱。
ReferencingEntity 具有查閱資料行之相關資料表的邏輯名稱。
ReferencingAttribute 相關資料表中查閱資料行的邏輯名稱,其中包含對主要資料表主索引鍵的參考。
IsHierarchical 關聯是否代表自我參照階層關聯
CascadeConfiguration 描述對母實體執行的操作會串連到相關實體的資料。
更多資訊請參見 級聯配置。

一對多關聯

包含以下 OneToManyRelationshipMetadata 類別 性質:

房產 Description
ReferencingEntity 相關資料表的邏輯名稱。
ReferencingAttribute 相關資料表中資料行的邏輯名稱,其中包含對主要資料表主索引鍵的參考。
IsCustomizable 你是否能改變關係的性質。
ReferencedEntityNavigationPropertyName 此關聯性的 Web API 集合值導覽屬性名稱。
欲了解更多資訊,請參閱 Web API 導覽屬性。
AssociatedMenuConfiguration 模型導向應用程式用來控制是否以及如何從主要實體在 UI 中存取相關實體資料的資料。

多對多關聯性

每個多對多關聯性都包含 Entity1LogicalName 和 Entity2LogicalName。 在本文件中,關聯性詳細資料會在目前資料表的內容中提供。 是 Entity1 還是 Entity2 其實並不重要。

對於每個多對多關係,包含以下 ManyToManyRelationshipMetadata 類別 屬性:

房產 Description
IntersectEntityName 支援此多對多關聯性的相交資料表的邏輯名稱。
IsCustomizable 你是否能改變關係的性質。
SchemaName 關聯性的結構描述名稱。
IntersectAttribute(Entity1IntersectAttribute 或 Entity2IntersectAttribute) 交集資料表中作為此類型記錄主索引鍵的資料行名稱。
NavigationPropertyName(Entity1NavigationPropertyName 或 Entity2NavigationPropertyName) 此關聯性的 Web API 集合值導覽屬性名稱。
其他資訊:Web API 導覽屬性
AssociatedMenuConfiguration(Entity1AssociatedMenuConfiguration 或 Entity2AssociatedMenuConfiguration) 模型導向應用程式用來控制是否以及如何從此資料表在使用者介面存取第二個資料表資料的資料。

在極少數情況下,多對多關聯性為自我參照時,例如連線角色 (ConnectionRole) connectionroleassociation_association,會在屬性前加上 Entity1 或 Entity2。

房產 價值觀
Entity1IntersectAttribute 交集資料表中作為此類型記錄第一個資料表主索引鍵的資料行名稱。
Entity2IntersectAttribute 交集資料表中作為此類型記錄第二個資料表主索引鍵的資料行名稱。
Entity1NavigationPropertyName 此關聯性作為第一個資料表時,Web API 集合值導覽屬性的名稱。
Entity2NavigationPropertyName 此關聯性作為第二個資料表時,Web API 集合值導覽屬性的名稱。
Entity1AssociatedMenuConfiguration 模型導向應用程式用來控制是否以及如何從此資料表 (作為第一個資料表) 在使用者介面存取第二個資料表資料的資料。
Entity2AssociatedMenuConfiguration 模型驅動應用程式用來控制是否以及如何從第二表存取第二個資料表的資料。