Freigeben über


Anpassen von Tabellendefinitionen

Indem Sie die Tabellendefinitionen definieren oder ändern, können Sie die Funktionalitäten einer Tabelle steuern. Um die Tabellendefinitionen für Ihre Umgebung anzuzeigen, verwenden Sie den Metadaten-Browser. Tabellendefinitionen in Ihrer Umgebung durchsuchen.

Weitere Informationen: Durchsuchen der Tabellendefinitionen für Ihre Umgebung

In diesem Artikel geht es darum, wie Sie programmatisch mit Tabellen arbeiten können. Informationen zum Arbeiten mit Tabellen in Power Apps finden Sie unter Tabellen in Dataverse.

Tabellen können entweder mit dem SDK für .NET oder mit der Web-API erstellt werden. Die folgenden Informationen können auf beide angewendet werden.

Operationen mit Tabellendefinitionen

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

Da die Web-API ein RESTful-Endpunkt ist, verwendet sie eine andere Art, Tabellendefinitionen zu erstellen, abzurufen, zu aktualisieren und zu löschen. Verwenden Sie die HTTP-Verben POST, GET, PUT und DELETE, um mit den Entitätstypen für Tabellendefinitionen zu arbeiten. Erfahren Sie, wie Sie Tabellendefinitionen mit der Web-API erstellen und aktualisieren

Eine Ausnahme hiervon ist die RetrieveMetadataChanges Function, die eine Möglichkeit bietet, Tabellendefinitionen abzufragen und Änderungen im Laufe der Zeit zu verfolgen.

Verwenden Sie die RetrieveMetadataChangesRequest-Klasse, wenn Sie mit dem SDK für .NET arbeiten. Diese Klasse enthält die Daten, die benötigt werden, um eine Sammlung von Tabellendefinitions-Datensätzen abzurufen, die die angegebenen Kriterien erfüllen. Die RetrieveMetadataChangesResponse gibt einen Zeitstempelwert zurück, der mit dieser Anforderung zu einem späteren Zeitpunkt verwendet werden kann, um Informationen darüber zurückzugeben, wie sich Tabellendefinitionen seit der letzten Anforderung geändert haben.

Nachricht Internet-API SDK-Assembly
CreateEntity Verwenden Sie eine POST-Anfrage, um Daten zu senden, um eine Tabelle zu erstellen. CreateEntityRequest
DeleteEntity Verwenden Sie eine DELETE-Anfrage, um eine Tabelle zu löschen. DeleteEntityRequest
RetrieveAllEntities Verwenden Sie eine GET-Anfrage, um Tabellendaten abzurufen. RetrieveAllEntitiesRequest
RetrieveEntity RetrieveEntity Function RetrieveEntityRequest
UpdateEntity Verwenden Sie eine PUT-Anfrage, um eine Tabelle zu aktualisieren. UpdateEntityRequest
RetrieveMetadataChanges
Wird zusammen mit Objekten im Microsoft.Xrm.Sdk.Metadata.Query-Namensraum verwendet, um eine Abfrage zum effizienten Abrufen und Erkennen von Änderungen an bestimmten Tabellendefinitionen zu erstellen. Weitere Informationen: Abrufen und Erkennen von Änderungen bei Tabellendefinitionen.
RetrieveMetadataChanges Function RetrieveMetadataChangesRequest

Verfügbare Optionen beim Erstellen einer angepassten Tabelle

Im Folgenden sind die Optionen aufgeführt, die beim Erstellen einer angepassten Tabelle verfügbar sind. Sie können diese Eigenschaften nur festlegen, wenn Sie eine angepasste Tabelle erstellen.

Option Beschreibung
Erstellen einer benutzerdefinierten Aktivität Sie können eine Tabelle erstellen, die eine Aktivität ist, indem Sie die Eigenschaft IsActivity festlegen, wenn Sie das SDK für .NET bzw. die Web-API verwenden. Für weitere Informationen siehe Benutzerdefinierte Aktivitäten in Dynamics 365.
Tabellennamen Es gibt zwei Arten von Namen, und beide müssen mit einem Anpassungspräfix versehen sein:

LogicalName: Name, der die Version des Tabellennamens ist, der in Kleinbuchstaben festgelegt 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 der logische Name vom Schemanamen abweicht, überschreibt der Schemaname den Wert, den Sie für den logischen Namen festlegen.

Wenn eine Tabelle in der Anwendung im Zusammenhang mit einer bestimmten Lösung erstellt wird, wird das angepasste Präfix verwendet, das für die Publisher der Lösung festgelegt wurde. Wenn eine Tabelle programmatisch erstellt wird, können Sie das Anpassungspräfix auf eine Zeichenfolge festlegen, die zwischen zwei und acht Zeichen lang ist, alle alphanumerischen Zeichen enthält und mit einem Buchstaben beginnen muss. Sie kann mit mscrm beginnen. Die bewährte Methode besteht darin, das Anpassungspräfix zu verwenden, das vom Herausgeber festgelegt wurde, dem die Lösung zugeordnet ist. Diese Best Practice wird aber nicht durchgesetzt. Ein Unterstrichzeichen muss zwischen dem Anpassungspräfix und dem logischen Namen oder Schemanamen angegeben sein.
Besitz Benutzen Sie die OwnershipType-Eigenschaft, um die Art des Besitzes für Tabellendatensätze festzulegen. Verwenden Sie die Aufzählung OwnershipTypes oder OwnershipTypes EnumType, um die Art des Tabellenbesitzes festzulegen. Die einzigen gültigen Werte für angepasste Tabellen sind OrgOwned oder UserOwned. Weitere Informationen finden Sie unter Tabellenbesitz.
Primäre Spalte Mit dem SDK für .NET verwenden Sie CreateEntityRequest.PrimaryAttribute Eigenschaft zum Festlegen der primären Spalte.

Bei der Web-API muss das JSON, das die Tabelle festlegt, eine StringAttributeMetadata enthalten, wobei die IsPrimaryName-Eigenschaft auf wahr 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 Funktionalitäten für Tabellen

Im Folgenden werden Funktionalitäten für Tabellen aufgelistet. Sie können diese Funktionalitäten festlegen, wenn Sie eine Tabelle erstellen, oder sie später aktivieren. Nachdem diese Funktionen aktiviert wurden, können sie nicht mehr deaktiviert werden.

Funktion Eigenschaft
Geschäftsprozessflüsse Legen Sie IsBusinessProcessEnabled auf true fest, um die Tabelle für Business Process Flows zu aktivieren.
Hinweise So erstellen Sie eine Beziehung mit der Tabelle Annotation und aktivieren die Aufnahme eines Notizen-Bereichs in das Formular. Durch den Einschluss von Notizen können Sie auch Anlagen zu Datensätzen hinzufügen.

Verwenden Sie mit dem SDK für .NET die CreateEntityRequest oder UpdateEntityRequest HasNotes-Eigenschaft

Legen Sie mit der Web-API die EntityMetadata.HasNotes Eigenschaft fest.
Aktivitäten Um eine Beziehung mit der Tabelle ActivityPointer zu erstellen, damit alle Aktivitätstyp-Tabellen mit dieser Tabelle verknüpft werden können.

Verwenden Sie mit dem SDK für .NET die CreateEntityRequest oder UpdateEntityRequest HasActivities-Eigenschaft.

Bestimmen Sie mit der Web-API EntityMetadata.HasActivities anzugeben.
Verbindungen Um das Erstellen von Verbindungsdatensätzen zu ermöglichen, um diese Tabelle mit anderen Verbindungstabellen zu verknüpfen, legen Sie den Wert der Eigenschaft IsConnectionsEnabled.Value auf true fest.
Warteschlangen Verwenden Sie die IsValidForQueue-Eigenschaft, um Unterstützung für Warteschlangen hinzuzufügen. Wenn Sie diese Option aktivieren, können Sie auch die AutoRouteToOwnerQueue-Eigenschaft festlegen, um Datensätze automatisch in die Standardwarteschlange des Besitzenden zu verschieben, wenn ein Datensatz dieses Typs erstellt oder zugewiesen wird.
E-Mail Legen Sie die IsActivityParty-Eigenschaft fest, sodass Sie eine E-Mail an die E-Mail-Adresse in diesem Datensatztyp senden können.

Bearbeitbare Tabelleneigenschaften

Im Folgenden sind Tabelleneigenschaften aufgeführt, die Sie bearbeiten können. Sie können diese Optionen jederzeit aktualisieren, es sei denn, dass eine verwaltete Eigenschaft sie nicht zulässt.

Eigenschaft Beschreibung
Schnellerfassung erlauben Verwenden Sie IsQuickCreateEnabled, um das schnelle Erstellen von Formularen für die Tabelle zu aktivieren. Damit Sie Schnellerfassungsformulare verwenden können, müssen Sie zunächst ein Schnellerfassungsformular erstellen und veröffentlichen.
Hinweis:
Aktivitätstabellen unterstützen keine Schnellerfassungsformulare.
Zugriffsteams Verwenden Sie AutoCreateAccessTeams, um die Tabelle für Zugriffsteams zu aktivieren. Weitere Informationen finden Sie unter Infos zur Zusammenarbeit mit Teamvorlagen.
Primäres Bild Wenn eine Tabelle eine Bildspalte hat, können Sie die Anzeige dieses Bildes in der Anwendung mit PrimaryImageAttribute aktivieren oder deaktivieren. Erfahren Sie, wie Sie mithilfe von Code mit Bildspaltendefinitionen 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 werden kann. Sie können die Beschriftungen jedoch programmgesteuert ändern, indem Sie die Description-Eigenschaft aktualisieren.
Aktivieren für die Verwendung im Offlinemodus Verwenden Sie IsAvailableOffline, um die Möglichkeit von Dynamics 365 for Microsoft Office Outlook mit Offline Access-Benutzern, Daten für diese Tabelle offline zu nehmen, zu aktivieren oder zu deaktivieren.
Aktivieren des Outlook-Lesebereichs Hinweis:

Die IsReadingPaneEnabled Eigenschaft ist nur für den internen Gebrauch bestimmt.

Verwenden Sie den Outlook-Lesebereich, um die Fähigkeit von Office Outlook-Benutzern zu aktivieren oder zu deaktivieren, Daten für diese Tabelle zu sehen. Sie müssen diese Eigenschaft in der Anwendung festlegen.
Aktivieren des Seriendrucks Verwenden Sie IsMailMergeEnabled, um die Fähigkeit zu aktivieren oder zu deaktivieren, mit Office Word zusammengeführte Dokumente zu erzeugen, die Daten aus dieser Tabelle verwenden.
Duplikaterkennung aktivieren Verwenden Sie IsDuplicateDetectionEnabled, um die Duplikaterkennung für die Tabelle zu aktivieren bzw. zu deaktivieren. Weitere Informationen finden Sie unter Erkennen von doppelten Daten
Aktivieren der SharePoint-Integration Verwenden Sie IsDocumentManagementEnabled, um die SharePoint-Server-Integration für die Tabelle zu aktivieren oder zu deaktivieren. Mehr Informationen: Aktivieren der SharePoint-Dokumentenverwaltung für bestimmte Einheiten.
Aktivieren von Dynamics 365 for phones Verwenden Sie IsVisibleInMobile, um die Fähigkeit von Dynamics 365 für Smartphones-Benutzern zu aktivieren oder zu deaktivieren, Daten für diese Tabelle zu sehen.
Dynamics 365 für Tablets Verwenden Sie IsVisibleInMobileClient, um die Fähigkeit von Dynamics 365 für Tablets-Benutzern, Daten für diese Tabelle zu sehen, zu aktivieren oder zu deaktivieren.

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 Prüfung für die Tabelle zu aktivieren oder zu deaktivieren. Weitere Informationen finden Sie unter Konfigurieren Sie Tabelle und Spalten für Auditing.
Flächen, die die Tabelle anzeigen, ändern Sie können steuern, wo Tabellenraster im Navigationsbereich der Anwendung angezeigt werden. Dies wird durch die Siteübersicht gesteuert.
Spalten hinzufügen oder entfernen Solange die verwaltete Eigenschaft CanCreateAttributes.Value das Erstellen von Spalten zulässt, können Sie der Tabelle Spalten hinzufügen. Weitere Informationen finden Sie in diesem Spaltendefinitionen.
Hinzufügen oder Entfernen von Ansichten Solange die verwaltete Eigenschaft CanCreateViews.Value das Erstellen von Ansichten zulässt, können Sie die Tabelle SavedQuery 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 zulässt und die Tabelleneigenschaft IsEnabledForCharts true ist, können Sie die Tabelle SavedQueryVisualization verwenden, um Diagramme für eine Tabelle zu erstellen. Weitere Informationen finden Sie unter Daten mit Visualisierungen (Diagrammen) anzeigen.
Hinzufügen oder Entfernen von Tabellenbeziehungen Es gibt mehrere verwaltete Eigenschaften, die die Arten von Beziehungen steuern, die Sie für eine Tabelle erstellen können. Weitere Informationen finden Sie unter Tabellenbeziehungen definieren.
Ändern von Symbolen Sie können die Symbole ändern, die für angepasste Tabellen verwendet werden. Weitere Informationen finden Sie unter Benutzerdefinierte Tabellensymbole der modellgesteuerten App ändern
Hierarchische Beziehung kann geändert werden CanChangeHierarchicalRelationship.Value steuert, ob der hierarchische Status von Beziehungen, die in Ihren verwalteten Lösungen enthalten sind, geändert werden kann.
Entitätssatzname EntitySetName gibt den Namen an, der zur eindeutigen Identifizierung der Tabelle mithilfe der Dataverse-Web-API verwendet wird. Dies ist normalerweise derselbe wie der LogicalCollectionName, Sie können den LogicalCollectionName aber nicht ändern. Sie sollten EntitySetName nur ändern, bevor Code mit dem Standardentitätssatznamen geschrieben wird. Weitere Informationen zu Entitätssatznamen

Von angepassten Tabellen unterstützte Nachrichten

Angepasste Tabellen unterstützen die gleichen Basis-Nachrichten wie Systemtabellen. Welche Nachrichten festgelegt sind, hängt davon ab, ob die angepasste Tabelle benutzer- oder organisationseigen ist. Benutzereigene Tabellen unterstützen Freigaben, sodass Nachrichten wie GrantAccess, ModifyAccess, und RevokeAccess zur Verfügung stehen.

Siehe auch

Verwenden Sie die Web-API mit Tabellendefinitionen
Arbeiten mit Tabellendefinitionen unter Verwendung des SDK für .NET

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