共用方式為


Dynamics 365 Sales 資料表/實體參考

Dataverse 資料表提供所有環境資料庫都具有的通用資料表集。

Dynamics 365 已啟用的應用程式資料表/實體參考包含在安裝 Dynamics 365 應用程式 (例如 Sales) 之前所需的其他資料表。

當您選擇安裝 Dynamics 365 Sales 時,當您將 Dataverse 新增至您建立的環境時,會新增或修改此處列出的資料表。

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

  • IsPrivate 等於 false

  • IsIntersect 等於 falseIsIntersect 等於 true,且資料表包含超過 4 個資料行。

    • 大部分的相交資料表只包含支援多對多關聯所需的 4 個資料行。 它們沒有實質用途。 包含超過四個欄位的交集資料表則更具參考價值。

Messages

此清單中的訊息適用於實體。 例如,使用者擁有的資料表支援 AssignGrantAccessModifyAccessRevokeAccess 訊息,而組織擁有的資料表則不支援。

SDK for .NET

使用適用於 .NET 的 SDK 時,您通常可以叫用屬於 Microsoft.Crm.Sdk.MessagesMicrosoft.Xrm.Sdk.Messages 命名空間的對應要求類別。 這些類別的名稱包含 Request 新增至訊息名稱的字首。

某些訊息會新增為其支援的解決方案的自訂動作。 這些訊息並未在 SDK 程式庫中定義,但您仍可透過多種方式加以使用

網路應用程式介面

使用 Web API 時,您可以找到以下參考中定義的常見 Dataverse OData 函式和動作:

對於這些功能和動作,以及新增的任何其他功能和動作,您可以透過以下方式探索如何使用這些功能和動作:

  1. 請檢查 $metadata service 文件,以取得參數及傳回值的詳細資料。 如需詳細資料,請參閱動作定義函式定義
  2. 叫用動作和函式。 如需詳細資訊,請參閱使用 Web API 動作使用 Web API 函式

活動

事件是存在的訊息,讓您可以對其進行訂閱。 除非您新增事件,否則您不應該叫用訊息,而應僅對其進行訂閱。 您可以透過數種不同的方式訂閱事件,例如:

屬性

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

Columns

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

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

唯讀資料行/屬性IsValidForCreateIsValidForUpdate 屬性皆會傳回 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 中存取相關實體資料的資料。

多對多關聯性

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

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

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

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

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