Dataverse 資料表/實體參考

使用此參考來瞭解可針對特定資料表執行的可用作業、每個資料表的預設資料行，以及資料表之間的關聯性。

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

IsPrivate 等於 false
- 這不包括不存在外部使用案例的資料表。
IsIntersect 等於 false 或 IsIntersect 等於 true，且資料表包含超過 4 個資料行。
- 大部分的相交資料表只包含支援多對多關聯所需的 4 個資料行。它們沒有實質用途。包含超過四個欄位的交集資料表則更具參考價值。

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

Dynamics 365 產品資料表參考

Dynamics 365 產品使用 Dataverse。當您為 Dynamics 365 產品建立環境時，環境會為所有 Dynamics 365 產品提供一組通用資料表。這些資料表包含在 Dynamics 365 已啟用應用程式的資料表/實體參考中。

每個特定的 Dynamics 365 產品都可以新增其他資料表。下表顯示特定 Dynamics 365 產品的資料表參考：

此區段包括選取的實體屬性，而不是所有實體屬性。僅包括那些預計對開發人員最有用的屬性。某些實體屬性值可以變更。

資料行會列在兩個不同的區段中：可寫入的資料行/屬性和唯讀資料行/屬性。此區隔的目的是著重於開發人員在建立或更新資料表中的資料列時可以設定的資料行。瞭解這些資料行有助於開發人員瞭解除了擷取值之外，他們還可以使用資料表執行哪些動作。

可寫入資料行/屬性區段中的資料行，其 IsValidForCreate 或 IsValidForUpdate 屬性會傳回 true (通常是兩者)。如果這兩個屬性中的任一回傳 false，系統會加以標示。

唯讀資料行/屬性 的 IsValidForCreate和IsValidForUpdate 屬性皆會傳回 false。

本參考文件中的選擇欄選項來自以英文為基本語言的部署。某些選取選項可能會因建立環境時選取的基底語言而有所不同。這些差異更緊密地符合最適合語言或文化的選項。您可以根據需要透過變更標籤或新增和移除選項來自由自訂這些選項。

EntityMetadata 類別包含三個屬性來代表關聯性：

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

備註

請務必記住，雖然每個資料表都會列出適用於它的關聯性，但每個關聯性都由兩個資料表共用。這些關聯存在於資料表之間。雖然存在一對多關聯，但多對一關聯僅是參照資料表中一對多關聯的另一種呈現方式。

包括以下 OneToManyRelationship 屬性：

房產	Description
`ReferencedEntity`	相關資料表的邏輯名稱。
`ReferencedAttribute`	相關資料表主索引鍵的邏輯名稱。
`ReferencingEntity`	具有查閱資料行之相關資料表的邏輯名稱。
`ReferencingAttribute`	相關資料表中查閱資料行的邏輯名稱，其中包含對主要資料表主索引鍵的參考。
`IsHierarchical`	關聯是否代表自我參照階層關聯
`CascadeConfiguration`	描述在上層實體上執行哪些作業的資料將串聯至相關實體。其他資訊：串聯設定

包括以下 OneToManyRelationship 屬性：

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

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

對於每一個多對多關聯性，都會包含下列屬性：

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

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

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

此頁面對您有幫助嗎？