Anpassen von Entitätsbeziehungsmetadaten

  • Artikel

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Entitätsbeziehungen definieren die Möglichkeiten, auf welche Weise Entitätsdatensätze Datensätzen anderer Entitäten oder der gleichen Entität zugeordnet werden können. Beim Erstellen neuer Entitätsbeziehungen werden neue Tabellenbeziehungen in der Datenbank erstellt. Verwenden Sie Entitätsbeziehungen, um spezielle Zuordnungen zu definieren, die häufig verwendet werden, um Datensätze für Berichte oder in der Benutzeroberfläche zuzuordnen. Nachdem eine Beziehung vorhanden ist, können Sie Datensätze basierend auf der Beziehung mithilfe der Methoden Associate und Disassociate zuordnen und ihre Zuordnung aufheben.Weitere Informationen:Aktionen für Entitätsdatensätze

Informationen zu Beziehungen zwischen einzelnen Datensätzen, die weniger formell und flexibler sind, finden Sie unter Verbindungsentitäten.

Dieses Thema behandelt das programmatische Arbeiten mit Entitätsbeziehungen. Informationen zum Verwenden von Entitätsbeziehungen in der Anwendung finden Sie unter Erstellen und Bearbeiten von Entitätsbeziehungen.

In diesem Thema

Typen von Entitätsbeziehungen

Eins-zu-viele-Beziehungen

Viele-zu-viele-Beziehungen

Konfigurieren von zugehörigen Menüs

Typen von Entitätsbeziehungen

Microsoft Dynamics 365 enthält zwei Typen von Entitätsbeziehungen. Beide erben von der Klasse RelationshipMetadataBase:

  • Eins-zu-viele-Beziehungen

  • Viele-zu-viele-Beziehungen

Bevor Sie eine neue Entitätsbeziehung programmgesteuert erstellen, müssen Sie überprüfen, ob Entitäten geeignet sind, an der Beziehung teilnehmen. Es gibt Einschränkungen, die auf beliebigen Entitätsbeziehungen mit den folgenden EntityMetadata-Eigenschaften angewendet werden: CanBeInManyToMany, CanBePrimaryEntityInRelationship und CanBeRelatedEntityInRelationship. Diese Einschränkungen werden berücksichtigt, wenn Entitätsbeziehungen manuell in den Anpassungstools erstellt werden. es gibt Nachrichten, die Sie verwenden können, um zu bestimmen, welche Beziehungen einer Entität verwenden können, die für diesen Beziehungstyp gültig sind.Weitere Informationen:Entitätsbeziehungseignung

Beide Typen von Entitätsbeziehungen lassen Optionen zu, die Navigationslinks zwischen verknüpften Datensätzen anzeigen.Weitere Informationen:Konfigurieren von zugehörigen Menüs

Eins-zu-viele-Beziehungen

Bei Eins-zu-viele-Entitätsbeziehung können viele verweisende (zugehörige) Entitätsdatensätze einem einzigen referenzierten (primären) Entitätsdatensatz zugeordnet werden. Der referenzierte Entitätsdatensatz wird manchmal als "übergeordneter Datensatz" bezeichnet, und Datensätze der verweisenden Entität als "untergeordnete Datensätze".

In einem Entitätsknoten auf einer Lösungsseite wird diese Art der Entitätsbeziehung entweder als (1-zu-viele (1:n)-Beziehung) oder als (Viele-zu-1 (n:1)-Beziehung) angezeigt. Diese Begriffe werden verwendet, da Sie zu Entitätsbeziehungen durch eine der Entitäten navigieren. Die Bezeichnung gibt an, welche Rolle die aktuelle Entität in der Beziehung hat.

Sie verwenden eine Instanz der Klasse OneToManyRelationshipMetadata, wenn Sie mit dieser Art von Entitätsbeziehung arbeiten. Jede Entitätsbeziehung verfügt über einen eindeutigen Schemanamen, den Sie verwenden, um diese abzurufen. Weitere Informationen finden Sie unter SchemaName. Jede Entitätsbeziehung dieser Art enthält auch eine referenzierte Entität (Primäre Entität) mit einem referenzierten Attribut und einer verweisenden Entität (Verknüpfte Entität) mit einem verweisenden Attribut. Das verweisende Attribut kann als Suchfeld in einem Entitätsformular angezeigt werden. Weitere Informationen finden Sie unter ReferencedEntity, ReferencedAttribute, ReferencingEntity und ReferencingAttribute.

Sie können bei Bedarf einer verweisenden Entität einen Verweis zuordnen, indem AttributeRequiredLevel auf ApplicationRequired im verweisenden Attribut festgelegt wird. Um die Datenintegrität zu erhalten, wenn Sie diesen Schritt ausführen, sollten Sie auch angeben, welche Aktion ausgeführt werden soll, wenn der primäre Datensatz gelöscht wird. Verwenden Sie die Eigenschaft CascadeConfiguration, um zu verhindern, dass der primäre Datensatz gelöscht wird, oder um den verknüpften Datensatz automatisch zu löschen sowie einen verwaisten Datensatz zu verhindern.

Sie können auch kaskadierende Konfiguration verwenden, um Verhalten zu automatisieren, wenn bestimmte Aktionen für verknüpfte Datensätze in der Organisation ausgeführt werden.Weitere Informationen:Entitätenbeziehungsverhalten

Zuordnen von Daten zu neuen Datensätzen

Liegt eine 1: n-Entitätsbeziehung vor, können Sie angeben, dass Daten aus bestimmten Feldern in der referenzierten Entität an alle neuen verknüpften Datensätzen übertragen werden können, die im Rahmen der Beziehung erstellt werden. Dies kann die Dateneingabe optimieren, wenn Sie neue verknüpfte Datensätze erstellen. Weitere Informationen finden Sie unter Anpassen von Entitäts- und Attributzuordnungen.

Auf sich selbst verweisende Eins-zu-viele-Entitätsbeziehungen

Bei einer auf sich selbst verweisenden Beziehung ist die verweisende und die referenzierte Entität identisch. Beispielsweise enthält die Firmenentität eine auf sich selbst verweisende 1: n-Beziehung, die eine Suche mit der Bezeichnung Übergeordnete Firma zulässt. Wenn das Entitätsbeziehungsverhalten als Übergeordnet definiert ist, kann ein Datensatz nicht auf sich selbst verweisen, da dies einen Zirkelverweis ergeben würde, wenn kaskadierende Verhaltensweisen angewendet werden.Weitere Informationen:Entitätenbeziehungsverhalten

Hierarchische Eins-zu-viele-Entitätsbeziehungen

Mit Microsoft Dynamics 365 (online und lokal) können Sie eine auf sich selbst verweisende Eins-zu-viele-Entitätsbeziehung als die für eine Entität bestimmte hierarchische Beziehung angeben. Die OneToManyRelationshipMetadata.IsHierarchical-Eigenschaft kennzeichnet die diese Beziehung als die Eins-zu-viele-Beziehung, die für die Entität zu verwenden ist.

Alle Eins-zu-viele-Entitätsbeziehungen stellen einen Typ von Hierarchie dar, doch Beziehungen, die mithilfe der IsHierarchical-Eigenschaft explizit gekennzeichnet sind, sind die einzigen Entitätsbeziehungen, die Hierarchienvisualisierungen in der Anwendung sowie in den neuen Abfrageoperatoren untersützen, um hierarchisch verknüpfte Datensätze abzurufen.Weitere Informationen:Abfragen von hierarchischen Daten

Ändern des Namens der Web-API-Navigationseigenschaften

Wenn Sie einen benutzerdefinierten Web-API-Navigationseigenschaftsnamen für eine 1:n-Beziehung anwenden, können Sie Werte für die OneToManyRelationshipMetadataReferencingEntityNavigationPropertyName Property und ReferencedEntityNavigationPropertyName Property-Eigenschaften festlegen.

Viele-zu-viele-Beziehungen

In einer Viele-zu-viele-Entitätsbeziehung können viele Entitätsdatensätze vielen anderen Entitätsdatensätzen zugeordnet werden. Anders als bei Eins-zu-viele-Beziehungen gibt es kein Suchfeld für eine Entität und daher keine intendierte Hierarchie. Mit einer n:n-Beziehung verknüpfte Datensätze gelten als gleichwertig, und die Beziehung ist reziprok. Eine n: n-Beziehung kann auch auf sich selbst verweisen. Da bei n:n-Beziehungen kein kaskadierender Verhalten vorhanden ist, können Sie einem einzelnen Datensatz einen Verweis auf sich selbst erlauben.

Sie verwenden eine Instanz der Klasse ManyToManyRelationshipMetadata, wenn Sie mit dieser Art von Entitätsbeziehung arbeiten. Jede Entitätsbeziehung verfügt über einen eindeutigen SchemaName, den Sie verwenden, um diese abzurufen.

Beim Erstellen einer n: n-Entitätsbeziehung wird eine neue Überschneidungsentität erstellt, für die die Eigenschaft IsIntersect true ist. Datensätze für diese Entität verfolgen jede einzelne n:n-Beziehung nach. Überschneidungsentitäten können keine benutzerdefinierten Attribute hinzugefügt werden.

Ändern des Namens der Web-API-Navigationseigenschaften

Wenn Sie einen benutzerdefinierten Web-API-Navigationseigenschaftsnamen für eine n:n-Beziehung anwenden, können Sie Werte für die  ManyToManyRelationshipMetadataEntity1NavigationPropertyName Property  und Entity2NavigationPropertyName Property-Eigenschaften festlegen.

Konfigurieren von zugehörigen Menüs

Beide Typen von Entitätsbeziehungen erlauben die Konfiguration von Navigationslinks zwischen verknüpften Datensätzen. Verwenden Sie die Eigenschaften AssociatedMenuConfiguration in jedem Typ von Entitätsbeziehungsdefinition, um anzugeben, wie die Navigationslinks in einem Entitätsformular angezeigt werden sollen.

Mithilfe dieser Werte wird die Standardkonfiguration für die Beziehung verfügbar. Sie können den Formular-Editor verwenden, um diese Optionen für jedes Formular zu überschreiben.Weitere Informationen:TechNet: Verwenden des Formulareditors: Bearbeiten der Navigation

  • Behavior
    Bietet die folgenden Optionen:

    • DoNotDisplay

    • UseCollectionName

    • UseLabel

  • Group
    Bietet die folgenden Optionen:

    • Kampagnenreaktionen

    • Marketing

    • Sales

    • Dienst

    Sie können keine neuen Gruppen hinzufügen, aber Sie können den für sie angezeigten Text mithilfe des Formular-Editors ändern.

  • Bezeichnung
    Wenn Sie AssociatedMenuBehavior.UseLabel auswählen, müssen Sie eine benutzerdefinierte Beschriftung angeben.

  • Reihenfolge
    Die für den Auftrag angegebene Ganzzahl steuert die relative Position von Navigationselementen in der Gruppe. Je niedriger der Wert, desto höher erscheint das Element im Verhältnis zu den Werten von anderen Elementen in der Gruppe.

Siehe auch

Verwenden des Organisationsdienstes mit Dynamics 365-Metadaten
Entitätsbeziehungsmetadatennachrichten
Entitätsbeziehungseignung
Entitätenbeziehungsverhalten
Erstellen und Abrufen von Entitätsbeziehungen
Beispiel: Erstellen und Abrufen von Entitätsbeziehungen
Beispiel: Dumpentitätsbeziehungsinformationen in einer Datei
Anpassen von Entitäts- und Attributzuordnungen
Rufen Sie Datensätze mit n: n-Beziehungen ab, die überschneidende Entitäten verwenden

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright