Dataverse-Tabelle/-Entitätsreferenz

Hinweis

Unsicher bei Entität vs. Tabelle? Siehe Developers: Understand terminology in Microsoft Dataverse.

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).