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
false
- Dies schließt Tabellen aus, für die keine externen Anwendungsfälle existieren.
- IsIntersect ist
false
- Dies schließt Tabellen aus, die zur Definition von 1:N-Beziehungen verwendet werden.
- Die Entität unterstützt eine Art direkten Datenmodifikationsvorgang.
- Dies schließt Tabellen aus, mit denen Sie nicht direkt arbeiten können.
Um Informationen über alle Tabellen in Ihrer Umgebung anzuzeigen, siehe Tabellendefinitionen in Ihrer 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: Schreibbare 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 für entweder die Eigenschaften IsValidForCreate oder IsValidForUpdate (normalerweise beide) den Wert true zurück. Wenn eine dieser Eigenschaften als „false” gesetzt wird, wird das angegeben.
Nur-Lese-Spalten/Attribute geben für die Eigenschaften IsValidForCreate und IsValidForUpdate immer false zurück.
Beziehungen
Die Klasse EntityMetadata enthält drei Eigenschaften zur Darstellung von Beziehungen:
Eigenschaft | Typ | Beschreibung |
---|---|---|
OneToManyRelationships | OneToManyRelationshipMetadata[] | Ruft das Array von 1:n-Beziehungen für die Entität aus. |
EntityMetadata.ManyToOneRelationships | OneToManyRelationshipMetadata[] | Ruft das Array von N:1-Beziehungen für die Entität aus. |
EntityMetadata.ManyToManyRelationships | ManyToManyRelationshipMetadata[] | Ruft das Array von N:n-Beziehungen für die Entität aus. |
Hinweis
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 bestehen zwischen den Tabellen. Während 1:N-Beziehungen existieren, sind N:1:-Beziehungen einfach eine Sicht auf eine 1:N-Beziehung aus der referenzierenden Tabelle.
Eins-zu-viele-Beziehungen
Um darzustellen, dass es keine tatsächlichen N:1:-Beziehungen mit einem Minimum an Verwirrung gibt, werden die Details jeder Beziehung nur einmal dokumentiert. Jede Eins-zu-Viel-Beziehung wird mit der referenzierten Tabelle aufgeführt und enthält ausgewählte Beziehungsdetails und einen Link zur entsprechenden Viel-zu-Eins-Beziehung. Jede N:1 aufgeführte Beziehung enthält nur einen Link zur entsprechenden 1:n-Beziehung.
Für jede Eins-zu-Viel-Beziehung sind die folgenden Eigenschaften enthalten:
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. |
IsHierarchical |
Ob die Beziehung eine auf sich selbst verweisende hierarchische Beziehung darstellt |
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. |
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: Konfiguration kaskadieren |
Viele-zu-viele-Beziehungen
Jede n: n-Beziehung enthält Entity1LogicalName und Entity2LogicalName. Für diese Dokumentation sind die Beziehungsdetails nur im Thema für Einheit1 enthalten. Jede N:n-Beziehung, in der die Entität Entity2 ist, enthält nur einen Link zu den Details, die im Thema Entity1 gefunden wurden.
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 |
Entity1LogicalName |
Der logische Name für die erste Tabelle in der Beziehung. |
Entity1IntersectAttribute |
Der logische Name der Spalte der Intersect-Tabelle, die einen Verweis auf den Primärschlüssel der ersten Tabelle enthält. |
Entity1NavigationPropertyName |
Der Name der von der Web-API-Sammlung bewerteten Navigationseigenschaft für diese Beziehung. Weitere Informationen: Web API-Navigationseigenschaften. |
Entity1AssociatedMenuConfiguration |
Daten, die von modellbasierten Apps verwendet werden, um zu steuern, ob und wie auf die Daten der ersten Tabelle in der Benutzeroberfläche von der zweiten Tabelle aus zugegriffen werden kann. |
Entity2LogicalName |
Der logische Name für die zweite Tabelle in der Beziehung. |
Entity2IntersectAttribute |
Der logische Name der Spalte der Intersect-Tabelle, die einen Verweis auf den Primärschlüssel der zweiten Tabelle enthält. |
Entity2NavigationPropertyName |
Hierbei handelt es sich in der Regel um denselben Wert wie bei dem Entity1NavigationPropertyName |
Entity2AssociatedMenuConfiguration |
Daten, die von modellbasierten Apps verwendet werden, um zu steuern, ob und wie auf die Daten der zweiten Tabelle in der Benutzeroberfläche von der ersten Tabelle aus zugegriffen werden kann. |
IsCustomizable |
Ob die Eigenschaften der Beziehung geändert werden können. |
Hinweis
Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)
Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für