Dataverse-Tabelle/-Entitätsreferenz
Verwenden Sie diese Referenz, um die verfügbaren Operationen, die für bestimmte Tabellen durchgeführt werden können, die Standardspalten jeder Tabelle und die Beziehungen zwischen den Tabellen zu verstehen.
Diese Referenz umfasst nur solche Tabellen, bei denen:
IsPrivate ist gleich
false- Dies schließt Tabellen aus, für die keine externen Anwendungsfälle existieren.
IsIntersect gleich
falseoder IsIntersect gleichtrueund die Tabelle enthält mehr als 4 Spalten.- Die meisten Schnittmengentabellen enthalten nur die vier Spalten, die zur Unterstützung der Viele-zu-viele-Beziehung erforderlich sind. Sie sind nicht nützlich. Interessanter sind Intersect-Tabellen mit mehr als vier Spalten.
Informationen zu allen Tabellen in Ihrem Umgebung finden Sie unter Tabellendefinitionen in Ihrem Umgebung durchsuchen.
Eigenschaften
Zu diesem Abschnitt zählen eher ausgewählte Entitätseigenschaften als alle davon. Nur Eigenschaften, die für Entwickler am hilfreichsten sein sollen, werden eingeschlossen. Einige Entitätseigenschaftswerte können geändert werden.
Spalten
Spalten werden in zwei separaten Abschnitten aufgelistet: Beschreibbare Spalten/Attribute und Nur-Lese-Spalten/Attribute. Der Zweck dieser Trennung ist es, sich auf die Spalten zu konzentrieren, die ein Entwickler beim Erstellen oder Aktualisieren von Zeilen in einer Tabelle festlegen kann. Das Verständnis dieser Spalten hilft einem Entwickler zu verstehen, was er mit der Tabelle über das Abrufen der Werte hinaus tun kann.
Die Spalten im Abschnitt Schreibbare Spalten/Attribute geben „true“ zurück für entweder die IsValidForCreate oder IsValidForUpdate Eigenschaften (normalerweise für beide). Wenn eine dieser Eigenschaften als „false” gesetzt wird, wird das angegeben.
Schreibgeschützte Spalten/Attribute geben für die Eigenschaften IsValidForCreateund IsValidForUpdate immer „false“ zurück.
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 ausrichten genauer auf Optionen, die am besten zur Sprache oder Kultur passen. Sie können diese Optionen beliebig anpassen, indem Sie die Beschriftungen ändern oder Optionen nach Bedarf hinzufügen bzw. entfernen.
Beziehungen
Die Klasse EntityMetadata umfasst 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
Es ist wichtig zu beachten, dass zwar jede Tabelle die Beziehungen auflistet, die für sie gelten, aber jede Beziehung wird von beiden Tabellen gemeinsam genutzt. Die Beziehungen existieren zwischen den Tabellen. Während Eins-zu-viele-Beziehungen existieren, sind Viele-zu-eins- Beziehungen lediglich eine Ansicht einer Eins-zu-viele-Beziehung aus der Referenztabelle.
Viele-zu-Eins Beziehungen
Enthält diese OneToManyRelationship Eigenschaften:
| Eigenschaften | Eigenschaft |
|---|---|
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 an der übergeordneten Entität ausgeführt werden, die bis zu den verknüpften Entitäten kaskadiert werden. Weitere Informationen: Kaskadenkonfiguration |
Eins-zu-viele-Beziehungen
Enthält diese OneToManyRelationship Eigenschaften:
| Eigenschaften | Eigenschaft |
|---|---|
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 |
Ob die Eigenschaften der Beziehung geändert werden können. |
ReferencedEntityNavigationPropertyName |
Der Name der von der Web-API-Sammlung bewerteten Navigationseigenschaft für diese Beziehung. Weitere Informationen: 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 folgende Eigenschaften enthalten:
| Eigenschaft | Beschreibung |
|---|---|
IntersectEntityName |
Der logische Name der Intersect-Tabelle, die diese N:N-Beziehung unterstützt |
IsCustomizable |
Ob die Eigenschaften der Beziehung geändert werden können. |
SchemaName |
Der Schemaname der Beziehung. |
IntersectAttribute |
Der Name der Spalte in der Schnittmengentabelle, die der Primärschlüssel für Datensätze dieses Typs ist. |
NavigationPropertyName |
Der Name der von der Web-API-Sammlung bewerteten Navigationseigenschaft für diese Beziehung. Weitere Informationen: Web-API-Navigationseigenschaften |
AssociatedMenuConfiguration |
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 den seltenen Fällen, in denen eine Viele-zu-viele-Beziehung selbstreferenziell ist, wie z. B. bei Verbindungsrolle (ConnectionRole) wird der Eigenschaft connectionroleassociation_association, Entity1 oder Entity2 vorangestellt.
| Eigenschaften | 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 Daten der zweiten Tabelle in der Benutzeroberfläche von dieser Tabelle als zweite Tabelle aus zugegriffen werden kann |