Tabellen-/Entitätsreferenz für Dynamics 365-fähige Apps

Dataverse-Tabellen stellen den gemeinsamen Satz von Tabellen bereit, über den alle Umgebungsdatenbanken verfügen. Die hier aufgeführten Tabellen werden hinzugefügt oder geändert, wenn Sie Dynamics 365-Apps aktivieren auswählen, während Sie Dataverse zu einer von Ihnen erstellten Umgebung hinzufügen.

Wenn Sie über die erforderlichen Lizenzen verfügen, können Sie Dynamics 365-Produkte installieren, die möglicherweise noch mehr Tabellen hinzufügen oder die vorhandenen Dynamics 365- oder Dataverse-Tabellen anpassen.

In dieser Tabelle sind andere Dynamics 365-Produkte aufgeführt, die von dieser Referenz abhängen:

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

Diese Referenz umfasst nur die Tabellen, in denen

• IsPrivate ist gleich false

  • Ausgenommen sind Tabellen, für die keine externen Anwendungsfälle vorhanden sind. Erfahren Sie mehr über private Tische

• IsIntersect ist false gleich oder IsIntersect ist true gleich, und die Tabelle enthält mehr als 4 Spalten.

  • Die meisten Überschneidungstabellen enthalten nur die 4 Spalten, die zur Unterstützung der m:n-Beziehung erforderlich sind. Sie sind nicht nützlich. Interessanter sind Überschneidungstabellen mit mehr als vier Spalten.

Messages

Die Meldungen in dieser Liste gelten für die Entität. Tabellen im Besitz eines Benutzers unterstützen z. B. die AssignTabellen GrantAccess , ModifyAccessund RevokeAccessNachrichten, während Tabellen im Besitz der Organisation dies nicht tun.

SDK für .NET

Wenn Sie das SDK für .NET verwenden, können Sie in der Regel die entsprechende Anforderungsklasse aufrufen, die entweder zum Microsoft.Crm.Sdk.Messages-Namespace oder zum Microsoft.Xrm.Sdk.Messages-Namespace gehört. Diese Klassen haben Namen, die das Präfix enthalten, das Request dem Nachrichtennamen hinzugefügt wurde.

Einige Nachrichten werden als benutzerdefinierte Aktionen für die von ihnen unterstützten Lösungen hinzugefügt. Diese Meldungen sind nicht in den SDK-Assemblys definiert, aber es gibt mehrere Möglichkeiten, sie zu verwenden.

Web-API

Wenn Sie die Web-API verwenden, finden Sie die allgemeinen Dataverse-OData-Funktionen und -Aktionen, die in dieser Referenz definiert sind:

• Referenz für Web-API-Aktionen
• Referenz zur Web-API-Funktion

Für diese Funktionen und Aktionen und alle zusätzlichen hinzugefügten Funktionen und Aktionen können Sie herausfinden, wie Sie sie verwenden können, indem Sie:

1. Untersuchen Sie das $metadata Servicedokument auf Details zu den Parametern und Rückgabewerten. Weitere Informationen finden Sie unter Aktionsdefinitionen und Funktionsdefinitionen .
2. Aufrufen von Aktionen und Funktionen. Weitere Informationen finden Sie unter Verwenden von Web-API-Aktionen und Verwenden von Web-API-Funktionen .

Ereignisse

Ereignisse sind Nachrichten, die vorhanden sind, damit Sie sie abonnieren können. Wenn Sie das Ereignis nicht hinzugefügt haben, sollten Sie die Nachricht nicht aufrufen, sondern nur abonnieren. Sie können Ereignisse auf verschiedene Arten abonnieren, z. B.:

• Verwenden Sie den Power Automate Dataverse-Konnektor mit dem Trigger Wenn eine Aktion ausgeführt wird .
• Registrieren Sie ein Dataverse-Plug-In, um auf das Ereignis zu reagieren.
• Senden Sie Ereignisdaten an Azure oder einen Web-Hook mit Dataverse Azure-Integration

Eigenschaften

Dieser Abschnitt enthält ausgewählte Entitätseigenschaften und nicht alle. Es werden nur die Eigenschaften berücksichtigt, von denen erwartet wird, dass sie für Entwickler am nützlichsten sind. Einige Entitätseigenschaftswerte können geändert werden.

Columns

Die Spalten werden in zwei separaten Abschnitten aufgelistet: Beschreibbare Spalten/Attribute und schreibgeschützte Spalten/Attribute. Der Zweck dieser Trennung besteht darin, 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 tun kann, die über das Abrufen der Werte hinausgeht.

Die Spalten im Abschnitt Beschreibbare Spalten/Attribute geben true für dieIsValidForCreate-Eigenschaft oder die IsValidForUpdate-Eigenschaft (in der Regel beide) zurück. Wenn eine dieser Eigenschaften false zurückgibt, wird dies angezeigt.

Schreibgeschützte Spalten/Attribute geben für die Eigenschaften IsValidForCreateundIsValidForUpdate immer false zurück.

Die Optionen für Auswahlspalten in dieser Referenzdokumentation stammen aus einer Bereitstellung, bei der Englisch die Ausgangssprache ist. Einige Auswahloptionen können je nach der Ausgangssprache variieren, die beim Erstellen der Umgebung ausgewählt wurde. Diese Unterschiede orientieren sich eher an den Optionen, die am besten zur Sprache oder Kultur passen. Es steht Ihnen frei, diese Optionen anzupassen, indem Sie die Beschriftungen ändern oder Optionen nach Bedarf hinzufügen und entfernen.

Beziehungen

Die EntityMetadata-Klasse enthält drei Eigenschaften zum Darstellen von Beziehungen:

Eigentum	Typ	Description
Eins-zu-VieleBeziehungen	OneToManyRelationshipMetadata[]	Ruft das Array der Eins-zu-Viele-Beziehungen für die Entität ab.
ManyToOneBeziehungen	OneToManyRelationshipMetadata[]	Ruft das Array der m:eins-Beziehungen für die Entität ab.
VieleToVieleBeziehungen	ManyToManyRelationshipMetadata[]	Ruft das Array der m:n-Beziehungen für die Entität ab.

Hinweis

Es ist wichtig zu beachten, dass zwar jede Tabelle die Beziehungen auflistet, die auf sie zutreffen, jede Beziehung jedoch von beiden Tabellen gemeinsam genutzt wird. Die Beziehungen bestehen zwischen den Tabellen. Es gibt zwar Eins-To-Many-Beziehungen, aber Viele-zu-Eins-Beziehungen sind lediglich eine Ansicht einer Eins-To-Many-Beziehung aus der verweisenden Tabelle.

Viele-zu-Eins-Beziehungen

Enthält die folgenden OneToManyRelationship Eigenschaften:

Eigentum	Description
ReferencedEntity	Der logische Name der verknüpften Tabelle.
ReferencedAttribute	Der logische Name des Primärschlüssels der verknüpften Tabelle.
ReferencingEntity	Der logische Name der verknüpften Tabelle, die die Nachschlagespalte enthält.
ReferencingAttribute	Der logische Name der Nachschlagespalte in der verknüpften Tabelle, die einen Verweis auf den Primärschlüssel der Primärtabelle enthält.
IsHierarchical	Gibt an, ob die Beziehung eine selbstreferentielle hierarchische Beziehung darstellt
CascadeConfiguration	Daten, die beschreiben, welche Vorgänge für die übergeordnete Entität ausgeführt werden, werden an verknüpfte Entitäten kaskadiert. Weitere Informationen: Kaskadierte Konfiguration

Eins-zu-Viele-Beziehungen

Enthält die folgenden OneToManyRelationship Eigenschaften:

Eigentum	Description
ReferencingEntity	Der logische Name der verknüpften Tabelle.
ReferencingAttribute	Der logische Name der Spalte in der verknüpften Tabelle, die einen Verweis auf den Primärschlüssel der Primärtabelle enthält.
IsCustomizable	Gibt an, ob die Eigenschaften der Beziehung geändert werden können.
ReferencedEntityNavigationPropertyName	Der Name der Web-API-Auflistungswert-Navigationseigenschaft für diese Beziehung. Weitere Informationen: Eigenschaften der Web-API-Navigation
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 m:n-Beziehung umfasst Entity1LogicalName und Entity2LogicalName. In dieser Dokumentation werden Beziehungsdetails im Kontext der aktuellen Tabelle bereitgestellt. Ob es wirklich wichtig ist Entity1 oder Entity2 nicht.

Für jede m:n-Beziehung sind die folgenden Eigenschaften enthalten:

Eigentum	Description
IntersectEntityName	Der logische Name der Überschneidungstabelle, die diese m:n-Beziehung unterstützt. Sie können diesen Wert verwenden, wenn Sie Tabellenspalten mit FetchXml verknüpfen
IsCustomizable	Gibt an, ob die Eigenschaften der Beziehung geändert werden können.
SchemaName	Der Schemaname der Beziehung.
IntersectAttribute	Der Name der Spalte in der Überschneidungstabelle, die als Primärschlüssel für Datensätze dieses Typs dient.
NavigationPropertyName	Der Name der Web-API-Auflistungswert-Navigationseigenschaft für diese Beziehung. Weitere Informationen: Eigenschaften der Web-API-Navigation
AssociatedMenuConfiguration	Daten, die von modellgesteuerten Apps verwendet werden, um zu steuern, ob und wie über diese Tabelle auf die Daten der zweiten Tabelle in der Benutzeroberfläche zugegriffen werden kann.

In den seltenen Fällen, in denen eine m:n-Beziehung selbstreferenzierend ist, z. B. für die Verbindungsrolle (ConnectionRole) connectionroleassociation_association, Entity1 oder Entity2 der Eigenschaft vorangestellt wird.

Eigentum	Wert
Entity1IntersectAttribute	Der Name der Spalte in der Überschneidungstabelle, die als Primärschlüssel für Datensätze dieses Typs als erste Tabelle dient.
Entity2IntersectAttribute	Der Name der Spalte in der Überschneidungstabelle, die als Primärschlüssel für Datensätze dieses Typs als zweite Tabelle dient.
Entity1NavigationPropertyName	Der Name der Web-API-Auflistungswert-Navigationseigenschaft für diese Beziehung als erste Tabelle.
Entity2NavigationPropertyName	Der Name der Web-API-Auflistungswert-Navigationseigenschaft für diese Beziehung als zweite Tabelle.
Entity1AssociatedMenuConfiguration	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 erster 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 zweiter Tabelle zugegriffen werden kann