Dataverse-Tabelle/-Entitätsreferenz

Verwenden Sie diesen Verweis, um die verfügbaren Vorgänge für bestimmte Tabellen, die Standardspalten jeder Tabelle und die Beziehungen zwischen Tabellen zu verstehen. Tabellendefinitionen verwenden die EntityMetadata-Klasse.

Diese Referenz umfasst nur solche Tabellen, bei denen:

• EntityMetadata.IsPrivate gleich false

  Diese Bedingung schließt Tabellen ohne externe Anwendungsfälle aus.

• EntityMetadata.IsIntersect false ist gleich oder IsIntersect gleichtrue, und die Tabelle enthält mehr als vier Spalten.

  Die meisten überschneidenden Tabellen enthalten nur die vier Spalten, die erforderlich sind, um die m:n-Beziehung zu unterstützen. Sie sind nicht nützlich. Intersect tables with more than four columns are not common and more interesting.

Informationen zu allen Tabellen in Ihrem Umgebung finden Sie unter Tabellendefinitionen in Ihrem Umgebung durchsuchen.

Dynamics 365 Products–Tabellenreferenz

Dynamics 365-Produkte verwenden Dataverse. Wenn Sie eine Umgebung für Dynamics 365-Produkte erstellen, verfügt die Umgebung über eine gemeinsame Gruppe von Tabellen für alle Dynamics 365-Produkte. Weitere Informationen finden Sie unter Dynamics 365 Tabelle/Entitätsreferenz für aktivierte Apps.

Jedes bestimmte Dynamics 365 Produkt kann weitere Tabellen hinzufügen. Die folgende Tabelle zeigt die Tabellenreferenz für bestimmte Dynamics 365-Produkte:

Produktdokumentation	Referenz der Produkttabelle
Umsatz	Verkaufstabelle/Entitätsreferenz
Kundendienst	Field Service-Tabelle/Entitätsreferenz
Kundendienst	Kundendiensttabelle/Entitätsreferenz

Eigenschaften

Zu diesem Abschnitt zählen eher ausgewählte Entitätseigenschaften als alle davon. Sie enthält nur die Eigenschaften, die für Entwickler am nützlichsten sind. Sie können einige Entitätseigenschaftswerte ändern.

Spalten

Spalten werden in zwei separaten Abschnitten aufgelistet:

Abschnitt	Beschreibung
Schreibbare Spalten/Attribute	Spalten, die Sie beim Erstellen oder Aktualisieren von Zeilen in einer Tabelle festlegen können. Diese Spalten werden entweder für die oder AttributeMetadata.IsValidForUpdate die Eigenschaften zurückgegebentrue, in der AttributeMetadata.IsValidForCreate Regel beide. Wenn eine der Eigenschaften zurückgegeben falsewird, wird diese Bedingung angegeben.
Schreibgeschützte Spalten/Attribute	Spalten, die Sie abrufen können, aber beim Erstellen oder Aktualisieren von Zeilen in einer Tabelle nicht festlegen können. Diese Spalten geben immer sowohl für die als AttributeMetadata.IsValidForUpdate auch für die AttributeMetadata.IsValidForCreate Eigenschaften zurückfalse.

Auswahlspaltenoptionen

Die Auswahlspaltenoptionen in dieser Referenzdokumentation stammen aus einer Bereitstellung, bei der Englisch die Basissprache ist. Einige Auswahlmöglichkeiten können je nach der bei der Erstellung von Umgebung ausgewählten Basissprache variieren. Diese Unterschiede richten sich stärker an Optionen, die am besten für die Sprache oder Kultur geeignet sind. Sie können diese Optionen anpassen, indem Sie die Bezeichnungen ändern oder optionen nach Bedarf hinzufügen und entfernen.

Beziehungen

Die EntityMetadata-Klasse enthält drei Eigenschaften zur Darstellung von Beziehungen:

Eigenschaft	Typ	Beschreibung
Eins-zu-viele-Beziehungen	OneToManyRelationshipMetadata[]	Ruft das Array von 1:n-Beziehungen für die Entität aus.
Viele-zu-eins-Beziehungen	OneToManyRelationshipMetadata[]	Ruft das Array von N:1-Beziehungen für die Entität aus.
Viele-zu-viele-Beziehungen	Viele-Zu-Viele-Beziehungsmetadaten[]	Ruft das Array von N:n-Beziehungen für die Entität aus.

Anmerkung

Während jede Tabelle die Beziehungen auflistet, die für sie gelten, wird jede Beziehung von beiden Tabellen gemeinsam verwendet. Die Beziehungen existieren zwischen den Tabellen. Während 1:n-Beziehungen vorhanden sind, sind m:1-Beziehungen einfach eine Ansicht einer 1:n-Beziehung aus der referenzierenden Tabelle.

n:1-Beziehungen

Enthält die folgenden OneToManyRelationshipMetadata Klasseneigenschaften :

Eigenschaft	Beschreibung
ReferencedEntity	Der logische Name der Bezugstabelle.
ReferencedAttribute	Der logische Name des Primärschlüssels der zugehörigen Tabelle.
ReferencingEntity	Der logische Name der verknüpften Tabelle, die die Nachschlagespalte enthält.
ReferencingAttribute	Der logische Name der Nachschlagespalte in der zugehörigen Tabelle, die einen Verweis auf den Primärschlüssel der Primärtabelle enthält.
IsHierarchical	Ob die Beziehung eine auf sich selbst verweisende hierarchische Beziehung darstellt
CascadeConfiguration	Daten, die beschreiben, welche Vorgänge für die übergeordnete Entität an verwandte Entitäten überlappen. Weitere Informationen finden Sie unter Cascade-Konfiguration.

Eins-zu-viele-Beziehungen

Enthält die folgenden OneToManyRelationshipMetadata Klasseneigenschaften :

Eigenschaft	Beschreibung
ReferencingEntity	Der logische Name der Bezugstabelle.
ReferencingAttribute	Der logische Name der Spalte in der Bezugstabelle, die einen Verweis auf den Primärschlüssel der Primärtabelle enthält.
IsCustomizable	Gibt an, ob Sie die Eigenschaften der Beziehung ändern können.
ReferencedEntityNavigationPropertyName	Der Name der von der Web-API-Sammlung bewerteten Navigationseigenschaft für diese Beziehung. Weitere Informationen finden Sie unter Web-API-Navigationseigenschaften.
AssociatedMenuConfiguration	Daten, die von modellgesteuerten Apps verwendet werden, um zu steuern, ob und wie auf die zugehörigen Entitätsdaten in der Benutzeroberfläche von der primären Entität aus zugegriffen werden kann.

Viele-zu-viele-Beziehungen

Jede Viele-zu-viele-Beziehung umfasst Entity1LogicalName und Entity2LogicalName. Für diese Dokumentation werden Beziehungsdetails im Kontext der aktuellen Tabelle bereitgestellt. Ob es Entity1 oder Entity2 ist, ist nicht wirklich wichtig.

Für jede n:n-Beziehung sind die folgenden ManyToManyRelationshipMetadata Klasseneigenschaften enthalten:

Eigenschaft	Beschreibung
IntersectEntityName	Der logische Name der Intersect-Tabelle, die diese n:n-Beziehung unterstützt.
IsCustomizable	Gibt an, ob Sie die Eigenschaften der Beziehung ändern können.
SchemaName	Der Schemaname der Beziehung.
IntersectAttribute (Entity1IntersectAttribute oder Entity2IntersectAttribute)	Der Name der Spalte in der Schnittmengentabelle, die der Primärschlüssel für Datensätze dieses Typs ist.
NavigationPropertyName (Entity1NavigationPropertyName oder Entity2NavigationPropertyName)	Der Name der von der Web-API-Sammlung bewerteten Navigationseigenschaft für diese Beziehung. Weitere Informationen: Web-API-Navigationseigenschaften
AssociatedMenuConfiguration (Entity1AssociatedMenuConfiguration oder Entity2AssociatedMenuConfiguration)	Von modellgesteuerten Apps verwendete Daten, um zu steuern, ob und wie von dieser Tabelle aus in der Benutzeroberfläche auf die Daten der zweiten Tabelle zugegriffen werden kann.

In dem seltenen Fall, dass eine Viele-zu-viele-Beziehung selbstreferenziell ist, wie z. B. bei Verbindungsrolle (ConnectionRole) wird der Eigenschaft connectionroleassociation_association, Entity1 oder Entity2 vorangestellt.

Eigenschaft	Wert
Entity1IntersectAttribute	Der Name der Spalte in der Schnittmengentabelle, die als erste Tabelle den Primärschlüssel für Datensätze dieses Typs darstellt.
Entity2IntersectAttribute	Der Name der Spalte in der Schnittmengentabelle, die der Primärschlüssel für Datensätze dieses Typs als zweite Tabelle ist.
Entity1NavigationPropertyName	Der Name der sammlungswertigen Navigationseigenschaft der Web-API für diese Beziehung als erste Tabelle.
Entity2NavigationPropertyName	Der Name der sammlungswertigen Navigationseigenschaft der Web-API für diese Beziehung als zweite Tabelle.
Entity1AssociatedMenuConfiguration	Von modellgesteuerten Apps verwendete Daten, um zu steuern, ob und wie in der Benutzeroberfläche von dieser Tabelle als erste Tabelle auf die Daten der zweiten Tabelle zugegriffen werden kann.
Entity2AssociatedMenuConfiguration	Daten, die von modellgesteuerten Apps verwendet werden, um zu steuern, ob und wie auf die zweite Tabellendaten in der Benutzeroberfläche aus dieser Tabelle als zweite Tabelle zugegriffen werden kann.