共用方式為

自訂實體關聯中繼資料

  • 發行項

 

發行︰ 2017年1月

適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

實體關聯定義實體記錄可與其他實體或相同實體的相關記錄方式。 建立新實體關聯在資料庫建立新的工作表關聯。 使用實體關聯來定義通常用來關聯報表記錄，或在使用者介面中的關聯。 一旦關聯存在，您可以依據關聯來使用 Associate 和 Disassociate 方法建立與取消關聯紀錄。其他資訊：實體記錄上的動作

如需個體紀錄間較不正式且更具彈性的關聯，請參閱 關係實體。

本主題為關於如何以程式設計方式使用實體關聯。 如需在應用程式中使用實體關聯的資訊，請參閱建立及編輯實體關聯。

本主題內容

實體關聯的類型

一對多關聯

多對多關聯

設定關聯選單

實體關聯的類型

Microsoft Dynamics 365 兩種實體關聯的類型。 兩者都繼承自 RelationshipMetadataBase 從類別：

  • 一對多關聯

  • 多對多關聯

以程式設計方式建立新的實體關聯之前，請查看實體是否有資格接受參與關聯。 使用下列 EntityMetadata 屬性的實體關聯有適用限制：CanBeInManyToMany、CanBePrimaryEntityInRelationship 和 CanBeRelatedEntityInRelationship。 當您在自訂工具中手動建立實體關聯時，請考慮這些限制。 有訊息可用來決定實體可使用的關聯，以及對該關聯類型有效的其他實體。其他資訊：實體關聯適用性

兩奘實體關聯類型允許選項顯示相關記錄之間的導覽連結。其他資訊：設定關聯選單

一對多關聯

在一對多實體關聯，參照 (相關的) 實體記錄可使用單一參照 (主要的) 實體記錄。 參照實體有時會稱為「上層」，而記錄參照稱為「下層」。

在解決方案頁面的實體節點中，這種實體關連顯示為 1 對多 (1:N) 關聯或多對 1 (N:1) 關聯。 這些用語會因為透過其中一個實體瀏覽至實體關聯而使用。 標籤以反映目前實體有關聯的角色。

您可以在使用 OneToManyRelationshipMetadata 類別的執行個體，當您使用這種實體關係時。 每個實體關聯都有一個獨特的結構名稱供您擷取。 如需詳細資訊，請參閱SchemaName。 此種類的每個實體關連也有參照實體 (主要實體) 搭配參照屬性，而參照屬性 (關聯實體) 搭配參照屬性。 參照屬性會顯示為實體表單中的查詢欄位。 如需詳細資訊，請參閱 ReferencedEntity、ReferencedAttribute、ReferencingEntity，以及 ReferencingAttribute。

您可能需要在參照屬性上透過將 AttributeRequiredLevel 設定為 ApplicationRequired 來擁有一個具備參照的參照實體 為了維護資料完整性，當您這樣做時應該指定您希望發生的項目，如果來源記錄刪除遭到刪除的話。 使用 CascadeConfiguration 屬性來避免刪除主要記錄或自動刪除相關記錄，也避免產生孤兒記錄。

您也可以使用串聯設定，在組織中對相關記錄執行特定動作時，將行為自動化。其他資訊：實體關聯行為

對應資料至到新記錄中

當有一對多實體關聯時，您可以從在參照實體中的特定欄位指定資料，會移轉至任何建立在關聯內容中的新相關記錄。 當您建立新的相關記錄時，此功能可簡化資料輸入。 如需詳細資訊，請參閱自訂實體和屬性對應。

自我參照的一對多實體關聯

自我參照關聯是的參照實體和參照位置相同。 例如，客戶實體擁有自我參照的一對多關聯，允許查詢已標籤的上層客戶。 如果實體關聯行為定義為上層，則紀錄無法自我參照，因為這在套用串聯行為時會產生循環參考。其他資訊：實體關聯行為

階層式一對多實體關聯

在 Microsoft Dynamics 365 (線上和內部部署)，您可以指定自我參考一對多實體關聯做為實體的指定階層式關聯。OneToManyRelationshipMetadata.IsHierarchical 屬性標示此關聯為要用於實體的一對多關聯。

所有一對多實體關聯代表一種階層類型，但是，使用 IsHierarchical 屬性明確標記的關聯是唯一實體關聯，支援應用程式中的階層視覺效果以及新查詢運算子以取得階層式相關記錄。其他資訊：查詢階層式資料

變更 Web API 導覽屬性的名稱

如果您想對一對多關聯套用自訂 Web API 導覽屬性名稱，可以設定 OneToManyRelationshipMetadataReferencingEntityNavigationPropertyName Property 和 ReferencedEntityNavigationPropertyName Property 屬性的值。

多對多關聯

在多對多實體關聯中，許多實體記錄可與許多其他實體記錄建立關聯。 不像一對多關聯，因為沒有任何實體的查詢欄位，也沒有適用階層。 使用多對多關聯相關的記錄可以視為對等，且關聯是相互的。 多對多關聯也可以是自我參照。 因為沒有多對多關聯相關的串聯的行為，您可以允許個別記錄擁有自己的參照。

您可以在使用 ManyToManyRelationshipMetadata 類別的執行個體，當您使用這種實體關係時。 每個實體關聯都有一個獨特的 SchemaName 供您擷取

建立多對多實體關聯建立新相交，IsIntersect 屬性為 true 時。 此實體的記錄追蹤每一個多對多關聯。 您無法將自訂屬性加至相交實體。

變更 Web API 導覽屬性的名稱

如果您想對多對多關聯套用自訂 Web API 導覽屬性名稱，可以設定 ManyToManyRelationshipMetadataEntity1NavigationPropertyName Property 和 Entity2NavigationPropertyName Property 屬性的值。

設定關聯選單

這兩個實體關連類型允許設定相關記錄之間的導覽連結。 使用 AssociatedMenuConfiguration 各種關聯類型定義的屬性指定您在導覽連結時的方式，用實體表單方式顯示。

這些值提供關聯的預設設定。 您可以使用表單編輯器覆寫每個表單的選項。其他資訊：TechNet：使用表單編輯器：編輯導覽

  • Behavior
    提供下列選項：

    • DoNotDisplay

    • UseCollectionName

    • UseLabel

  • Group
    提供下列選項：

    • 詳細資料

    • 行銷

    • 銷售

    • 服務

    您不能新增群組，但是您可以使用表單編輯器，變更為他們顯示的文字。

  • 標籤
    如果選取 AssociatedMenuBehavior.UseLabel，您必須提供自訂標籤。

  • 訂單
    在命令提供的整數會控制群組導覽項目的相對位置。 值越低，項目就更與該其他群組項目的值相關。

另請參閱

搭配使用組織服務與 Dynamics 365 中繼資料
實體關聯中繼資料訊息
實體關聯適用性
實體關聯行為
建立並擷取實體關聯
範例：建立並擷取實體關聯
範例：將實體關聯資訊傾印至檔案
自訂實體和屬性對應
使用交集實體擷取多對多關聯的記錄

Microsoft Dynamics 365

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權