Anpassen von Tabellendefinitionen

Durch Definieren oder Ändern der Tabellendefinitionen können Sie die Funktionen einer Tabelle steuern. Verwenden Sie den Metadatenbrowser, um die Tabellendefinitionen für Ihre Umgebung anzuzeigen. Durchsuchen Sie Tabellendefinitionen in Ihrer Umgebung.

In diesem Artikel wird erläutert, wie Sie programmgesteuert mit Tabellen arbeiten. Informationen zum Arbeiten mit Tabellen in Power Apps finden Sie unter "Tabellen in Dataverse".

Sie können Tabellen mithilfe des SDK für .NET, des Dataverse SDK für Python oder der Web-API erstellen. Die folgenden Informationen gelten für alle drei Methoden.

Method	Interface	Weitere Informationen
Web-API	EntityMetadata-Entitätstyp	Tabellendefinitionen über die Web-API erstellen und aktualisieren
SDK für .NET	EntityMetadata-Klasse	Erstellen einer benutzerdefinierten Tabelle mit Code Abrufen, Aktualisieren und Löschen von Tabellen
Dataverse SDK für Python	`client.tables`	Verwenden von Metadaten zum Anpassen von Tabellen und Spalten

Erstellen, Abrufen, Aktualisieren und Löschen von Tabellendefinitionen

Wie Sie mit Tabellendefinitionen arbeiten, hängt davon ab, welchen Dienst Sie verwenden.

Nachricht	Web-API	.NET SDK	SDK für Python
`CreateEntity`	Verwenden Sie eine `POST` Anforderung zum Senden von Daten zum Erstellen einer Tabelle.	CreateEntityRequest-Klasse	Dient `client.tables.create` zum Erstellen einer benutzerdefinierten Tabelle und optional deren Spalten.
`DeleteEntity`	Verwenden Sie eine `DELETE` Anforderung zum Löschen einer Tabelle.	DeleteEntityRequest-Klasse	Dient `client.tables.delete` zum Löschen einer benutzerdefinierten Tabelle.
`RetrieveAllEntities`	Verwenden Sie `GET` die Anforderung zum Abrufen von Tabellendaten.	RetrieveAllEntitiesRequest-Klasse	Dient `client.tables.list` zum Auflisten von Tabellendefinitionen.
`RetrieveEntity`	RetrieveEntity-Funktion	RetrieveEntityRequest-Klasse	Dient `client.tables.get` zum Abrufen einer Tabellendefinition.
`UpdateEntity`	Verwenden Sie eine PUT-Anforderung, um eine Tabelle zu aktualisieren.	UpdateEntityRequest-Klasse	Wird derzeit nicht unterstützt. Das SDK für Python stellt keine Tabellenaktualisierungsmethode bereit.
`RetrieveMetadataChanges` Wird zusammen mit Objekten im Metadata.Query-Namespace verwendet, um eine Abfrage zu erstellen, um Änderungen an bestimmten Tabellendefinitionen effizient abzurufen und zu erkennen. Weitere Informationen: Abfrageschemadefinitionen.	RetrieveMetadataChanges-Funktion	RetrieveMetadataChangesRequest-Klasse	Wird derzeit nicht unterstützt. Das SDK für Python bietet keine Möglichkeit, diese Funktion aufzurufen.

Beim Erstellen einer benutzerdefinierten Tabelle verfügbare Optionen

In der folgenden Liste werden die Optionen beschrieben, die beim Erstellen einer benutzerdefinierten Tabelle verfügbar sind. Sie können diese Eigenschaften nur festlegen, wenn Sie eine benutzerdefinierte Tabelle erstellen.

Option	Description
Erstellen einer benutzerdefinierten Aktivität	Erstellen Sie eine Tabelle, die eine Aktivität ist, indem Sie die `IsActivity` Eigenschaft festlegen, wenn Sie das SDK für .NET oder Web-API verwenden. Weitere Informationen finden Sie unter "Benutzerdefinierte Aktivitäten".
Tabellennamen	Es gibt zwei Typen von Namen. Benutzerdefinierte Tabellen müssen über ein Anpassungspräfix verfügen: `LogicalName`: Name, der die Version des Tabellennamens in allen Kleinbuchstaben ist. `SchemaName`: Name, der zum Erstellen der Datenbanktabellen verwendet wird. Dieser Name kann Groß- und Kleinbuchstaben enthalten. Die verwendete Groß-/Kleinschreibung legt den Namen des Objekts fest, das für das Programmieren mit starker Typisierung generiert wird, oder wenn Sie den REST-Endpunkt verwenden. Hinweis: Wenn sich der logische Name vom Schemanamen unterscheidet, überschreibt der Schemaname den Wert, den Sie für den logischen Namen festgelegt haben. Wenn Sie eine Tabelle in der Anwendung im Kontext einer bestimmten Lösung erstellen, ist das verwendete Anpassungspräfix der für die `Publisher` Lösung festgelegte Satz. Wenn Sie eine Tabelle programmgesteuert erstellen, legen Sie das Anpassungspräfix auf eine Zeichenfolge fest, die zwischen zwei und acht Zeichen lang ist, alle alphanumerischen Zeichen und müssen mit einem Buchstaben beginnen. Er kann nicht mit `mscrm` beginnen. Die bewährte Methode besteht darin, das vom Herausgeber definierte Anpassungspräfix zu verwenden, dem die Lösung zugeordnet ist, aber diese bewährte Methode wird nicht erzwungen. Ein Unterstrichzeichen muss zwischen dem Anpassungspräfix und dem logischen Namen oder Schemanamen angegeben sein.
Besitz	Verwenden Sie die `OwnershipType` Eigenschaft, um festzulegen, wie Tabellendatensätze zugeordnet sind. Verwenden Sie die OwnershipTypes-Aufzählung oder den Enumerationstyp "OwnershipTypes ", um den Typ des Tabellenbesitzes festzulegen. Die einzigen gültigen Werte für benutzerdefinierte Tabellen sind `OrgOwned` oder `UserOwned`. Weitere Informationen finden Sie unter Tabellenbesitz.
Primäre Spalte	Verwenden Sie mit dem SDK für .NET die CreateEntityRequest.PrimaryAttribute-Eigenschaft, um die primäre Spalte festzulegen. Mit der Web-API muss der JSON-Code, der die Tabelle definiert, einen StringAttributeMetadata-Entitätstyp enthalten, wobei die `IsPrimaryName` Eigenschaft auf "true" festgelegt ist. In beiden Fällen muss die Zeichenfolgenspalte als `Text`formatiert werden. Der Wert dieser primären Spalte ist das, was in einer Suche für alle zugehörigen Tabellen angezeigt wird. Daher sollte der Wert der Spalte einen Namen für den Datensatz darstellen.

Aktivieren von Tabellenfunktionen

In der folgenden Liste werden die Tabellenfunktionen beschrieben. Sie können diese Funktionen festlegen, wenn Sie eine Tabelle erstellen oder sie später aktivieren.

Note

Sie können diese Funktionen nicht deaktivieren, nachdem Sie sie aktiviert haben.

Fähigkeit	Description
Geschäftsprozessflüsse	Legen Sie `IsBusinessProcessEnabled` "true" fest, um die Tabelle für Geschäftsprozessflüsse zu aktivieren.
Hinweise	Erstellen Sie eine Beziehung mit der `Annotation` Tabelle, und aktivieren Sie die Aufnahme eines Notizenbereichs in das Formular. Durch den Einschluss von Notizen können Sie auch Anlagen zu Datensätzen hinzufügen. Verwenden Sie mithilfe des SDK für .NET die Eigenschaft CreateEntityRequest oder UpdateEntityRequest`HasNotes` Legen Sie mithilfe der Web-API die EntityMetadata-Eigenschaft`.HasNotes` fest.
Aktivitäten	Erstellen Sie eine Beziehung mit der `ActivityPointer` Tabelle, damit alle Aktivitätstyptabellen dieser Tabelle zugeordnet werden können. Verwenden Sie mithilfe des SDK für .NET die Eigenschaft CreateEntityRequest oder UpdateEntityRequest`HasActivities`. Legen Sie mithilfe der Web-API die EntityMetadata-Eigenschaft`.HasActivities` fest.
Verbindungen	Legen Sie die `IsConnectionsEnabled.Value` Eigenschaft auf "true" fest, um das Erstellen von Verbindungsdatensätzen zu ermöglichen, um diese Tabelle anderen Verbindungstabellen zuzuordnen. Weitere Informationen zu Verbindungen finden Sie unter Konfigurieren von Verbindungsrollen und Verwenden von Verbindungen, um Datensätze miteinander zu verknüpfen.
Queues	Verwenden Sie die `IsValidForQueue`-Eigenschaft, um Unterstützung für Warteschlangen hinzuzufügen. Wenn Sie diese Option aktivieren, können Sie die `AutoRouteToOwnerQueue` Eigenschaft auch so festlegen, dass Datensätze automatisch in die Standardwarteschlange des Besitzers verschoben werden, wenn ein Datensatz dieses Typs erstellt oder zugewiesen wird. Weitere Informationen finden Sie unter "Weitere Informationen zu Warteschlangen und Warteschlangentabellen".
E-Mail	Legen Sie die `IsActivityParty`-Eigenschaft fest, sodass Sie eine E-Mail an die E-Mail-Adresse in diesem Datensatztyp senden können. Erfahren Sie mehr über Aktivitätsparteien.

Bearbeitbare Tabelleneigenschaften

Die folgende Liste enthält Tabelleneigenschaften, die Sie bearbeiten können. Sofern diese Optionen nicht von einer verwalteten Eigenschaft nicht zulässig sind, können Sie sie jederzeit aktualisieren. Weitere Informationen zu verwalteten Eigenschaften

Eigentum	Description
Schnellerstellung zulassen	Sie können `IsQuickCreateEnabled` verwenden, um Schnellerstellungsformulare für die Tabelle zu aktivieren. Bevor Sie Schnellerstellungsformulare verwenden können, müssen Sie zuerst ein Schnellerstellungsformular erstellen und veröffentlichen. Weitere Informationen zu modellgesteuerten App-Schnellerstellungsformularen Note: Aktivitätstabellen unterstützen keine Schnellerstellungsformulare.
Zugriffsteams	Verwenden Sie `AutoCreateAccessTeams`, um die Tabelle für Zugriffsteams zu aktivieren. Weitere Informationen finden Sie unter "Informationen zur Zusammenarbeit mit Teamvorlagen ".
Primäres Bild.	Wenn eine Tabelle über eine Bildspalte verfügt, können Sie die Anzeige dieses Bilds in der Anwendung mithilfe `PrimaryImageAttribute`von . Lernen Sie, mit Bildspaltendefinitionen mithilfe von Code zu arbeiten
Ändern des Anzeigetexts	Die verwaltete Eigenschaft`IsRenameable` verhindert, dass der Anzeigename in der Anwendung geändert wird. Sie können die Beschriftungen jedoch programmgesteuert ändern, indem Sie die `DisplayName`- und `DisplayCollectionName`-Eigenschaft aktualisieren.
Bearbeiten der Tabellenbeschreibung	Die verwaltete Eigenschaft`IsRenameable` verhindert, dass die Tabellenbeschreibung in der Anwendung geändert wird. Sie können die Beschriftungen jedoch programmgesteuert ändern, indem Sie die `Description`-Eigenschaft aktualisieren.
Aktivieren des Outlook-Lesebereichs	Hinweis:Die `IsReadingPaneEnabled` Eigenschaft ist nur für die interne Verwendung vorgesehen. Um die Möglichkeit von Office Outlook-Benutzern zum Anzeigen von Daten für diese Tabelle zu aktivieren oder zu deaktivieren, verwenden Sie den Outlook-Lesebereich. Sie müssen diese Eigenschaft in der Anwendung festlegen.
Aktivieren des Seriendrucks	Dient `IsMailMergeEnabled` zum Aktivieren oder Deaktivieren der Möglichkeit, zusammengeführte Office Word-Dokumente zu generieren, die Daten aus dieser Tabelle verwenden.
Aktivieren der Duplikaterkennung	Verwenden Sie `IsDuplicateDetectionEnabled` , um die Duplikaterkennung für die Tabelle zu aktivieren oder zu deaktivieren. Weitere Informationen finden Sie unter Erkennen doppelter Daten mithilfe von Code
SharePoint-Integration aktivieren	Verwenden Sie `IsDocumentManagementEnabled`, um die SharePoint-Serverintegration für die Tabelle zu aktivieren oder zu deaktivieren. Mehr Informationen: Aktivieren der SharePoint-Dokumentenverwaltung für bestimmte Entitäten
Aktivieren von Dynamics 365 für Smartphones	Verwenden Sie `IsVisibleInMobile`, um die Fähigkeit von Dynamics 365 für die Nutzung auf Telefonen zu aktivieren oder zu deaktivieren, um Daten in dieser Tabelle anzuzeigen.
Dynamics 365 für Tablets	Verwenden Sie `IsVisibleInMobileClient`, um die Möglichkeit für Benutzer von Dynamics 365 für Tablets zu aktivieren oder zu deaktivieren, Daten in dieser Tabelle anzeigen zu können. Wenn die Tabelle für Dynamics 365 für Tablets verfügbar ist, können Sie `IsReadOnlyInMobileClient` verwenden, um festzulegen, dass die Daten für den Datensatz schreibgeschützt sind.
Aktivieren der Überwachung	Verwenden Sie `IsAuditEnabled` , um die Überwachung für die Tabelle zu aktivieren oder zu deaktivieren. Weitere Informationen finden Sie unter Konfigurieren von Tabellen und Spalten für die Überwachung.
Hinzufügen oder Entfernen von Spalten	Solange die verwaltete Eigenschaft`CanCreateAttributes.Value` das Erstellen von Spalten ermöglicht, können Sie der Tabelle Spalten hinzufügen. Weitere Informationen finden Sie unter Spaltendefinitionen.
Hinzufügen oder Entfernen von Ansichten	Solange die verwaltete Eigenschaft`CanCreateViews.Value` das Erstellen von Ansichten ermöglicht, können Sie die `SavedQuery` Tabelle verwenden, um Ansichten für eine Tabelle zu erstellen.
Hinzufügen oder Entfernen von Diagrammen	Solange die verwaltete Eigenschaft`CanCreateCharts.Value` das Erstellen von Diagrammen und die `IsEnabledForCharts` Tabelleneigenschaft zulässt, können Sie die SavedQueryVisualization-Tabelle verwenden, um Diagramme für eine Tabelle zu erstellen. Weitere Informationen finden Sie unter Anzeigen von Daten mit Visualisierungen (Diagrammen).For more information, see View data with visualizations (charts).
Hinzufügen oder Entfernen von Tabellenbeziehungen	Mehrere verwaltete Eigenschaften steuern die Typen von Beziehungen, die Sie für eine Tabelle erstellen können. Weitere Informationen finden Sie unter Tabellenbeziehungsdefinitionen.
Ändern von Symbolen	Sie können die Symbole ändern, die für benutzerdefinierte Tabellen verwendet werden. Weitere Informationen finden Sie unter Ändern von benutzerdefinierten Tabellensymbolen für eine modellgesteuerte App
Hierarchische Beziehung kann geändert werden	`CanChangeHierarchicalRelationship.Value` steuert, ob der hierarchische Zustand von Beziehungen, die in Ihren verwalteten Lösungen enthalten sind, geändert werden kann. Weitere Informationen: Definieren und Abfragen hierarchischer Daten und hierarchische Abfragedaten
Entitätssatzname	`EntitySetName` Gibt den Namen an, der verwendet wird, um die Tabelle mithilfe der Dataverse-Web-API eindeutig zu identifizieren. Dieser Name ist in der Regel identisch mit dem `LogicalCollectionName`, aber Sie können den `LogicalCollectionName`. Sie sollten nur `EntitySetName` ändern, bevor Code mit dem Standard-Entitätssatznamen geschrieben wird. Weitere Informationen zu Entitätssatznamen

Von benutzerdefinierten Tabellen unterstützte Nachrichten

Benutzerdefinierte Tabellen unterstützen dieselben Basismeldungen wie Systemtabellen. Der Satz von Nachrichten, die Sie verwenden können, hängt davon ab, ob die benutzerdefinierte Tabelle im Besitz des Benutzers oder der Organisation ist. Benutzereigene Tabellen unterstützen die Freigabe, sodass Sie Nachrichten wie GrantAccess, , ModifyAccessund RevokeAccess.

Siehe auch

Verwenden der Web-API mit Tabellendefinitionen
Arbeiten mit Tabellendefinitionen mithilfe des SDK für .NET

Feedback

War diese Seite hilfreich?

Last updated on 2026-08-13