Dataverse 資料表提供所有環境資料庫都具有的通用資料表集。
Dynamics 365 已啟用的應用程式資料表/實體參考包含在安裝 Dynamics 365 應用程式 (例如 Sales) 之前所需的其他資料表。
當您選擇安裝 Dynamics 365 Sales 時,當您將 Dataverse 新增至您建立的環境時,會新增或修改此處列出的資料表。
此參考僅包含下列資料表:
IsPrivate 等於
false- 這不包括不存在外部使用案例的資料表。 深入了解私人資料表
IsIntersect 等於
false或 IsIntersect 等於true,且資料表包含超過 4 個資料行。- 大部分的相交資料表只包含支援多對多關聯所需的 4 個資料行。 它們沒有實質用途。 包含超過四個欄位的交集資料表則更具參考價值。
Messages
此清單中的訊息適用於實體。 例如,使用者擁有的資料表支援 Assign、GrantAccess、ModifyAccess 和 RevokeAccess 訊息,而組織擁有的資料表則不支援。
SDK for .NET
使用適用於 .NET 的 SDK 時,您通常可以叫用屬於 Microsoft.Crm.Sdk.Messages 或 Microsoft.Xrm.Sdk.Messages 命名空間的對應要求類別。 這些類別的名稱包含 Request 新增至訊息名稱的字首。
某些訊息會新增為其支援的解決方案的自訂動作。 這些訊息並未在 SDK 程式庫中定義,但您仍可透過多種方式加以使用。
網路應用程式介面
使用 Web API 時,您可以找到以下參考中定義的常見 Dataverse OData 函式和動作:
對於這些功能和動作,以及新增的任何其他功能和動作,您可以透過以下方式探索如何使用這些功能和動作:
- 請檢查 $metadata service 文件,以取得參數及傳回值的詳細資料。 如需詳細資料,請參閱動作定義和函式定義。
- 叫用動作和函式。 如需詳細資訊,請參閱使用 Web API 動作和使用 Web API 函式。
活動
事件是存在的訊息,讓您可以對其進行訂閱。 除非您新增事件,否則您不應該叫用訊息,而應僅對其進行訂閱。 您可以透過數種不同的方式訂閱事件,例如:
- 使用 Power Automate Dataverse 連接器,搭配當執行動作時觸發程序。
- 註冊 Dataverse 外掛程式以回應事件。
- 將事件資料傳送至 Azure 或具有 Dataverse Azure 整合的 Webhook
屬性
此區段包括選取的實體屬性,而不是所有實體屬性。 僅包括那些預計對開發人員最有用的屬性。 某些實體屬性值可以變更。
Columns
資料行會列在兩個不同的區段中:可寫入的資料行/屬性和唯讀資料行/屬性。 此區隔的目的是著重於開發人員在建立或更新資料表中的資料列時可以設定的資料行。 瞭解這些資料行有助於開發人員瞭解除了擷取值之外,他們還可以使用資料表執行哪些動作。
可寫入資料行/屬性區段中的資料行,其 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 |
支援此多對多關聯性的相交資料表的邏輯名稱。 您可以在使用 FetchXml 聯結資料表資料行時使用此值 |
IsCustomizable |
是否可以變更關聯的屬性。 |
SchemaName |
關聯性的結構描述名稱。 |
IntersectAttribute |
交集資料表中作為此類型記錄主索引鍵的資料行名稱。 |
NavigationPropertyName |
此關聯性的 Web API 集合值導覽屬性名稱。 其他資訊:Web API 導覽屬性 |
AssociatedMenuConfiguration |
模型導向應用程式用來控制是否以及如何從此資料表在使用者介面存取第二個資料表資料的資料。 |
在極少數情況下,多對多關聯性為自我參照時,例如連線角色 (ConnectionRole) connectionroleassociation_association,會在屬性前加上 Entity1 或 Entity2。
| 房產 | 價值觀 |
|---|---|
Entity1IntersectAttribute |
交集資料表中作為此類型記錄第一個資料表主索引鍵的資料行名稱。 |
Entity2IntersectAttribute |
交集資料表中作為此類型記錄第二個資料表主索引鍵的資料行名稱。 |
Entity1NavigationPropertyName |
此關聯性作為第一個資料表時,Web API 集合值導覽屬性的名稱。 |
Entity2NavigationPropertyName |
此關聯性作為第二個資料表時,Web API 集合值導覽屬性的名稱。 |
Entity1AssociatedMenuConfiguration |
模型導向應用程式用來控制是否以及如何從此資料表 (作為第一個資料表) 在使用者介面存取第二個資料表資料的資料。 |
Entity2AssociatedMenuConfiguration |
模型導向應用程式用來控制是否以及如何從此資料表 (作為第二個資料表) 在使用者介面存取第二個資料表資料的資料 |