Freigeben über


Verwenden Sie die Web-API mit Tabellendefinitionen

Sie können beliebige Tabellen- und Spaltendefinitionen (Metadatenvorgänge) mit der Web-API ausführen, die Sie mithilfe des SDK für .NET ausführen können. Dieser Abschnitt enthält Anweisungen dazu, wie die Web-API mit Entitätstypen, die in der Web API Metadata Entity Type Reference enthalten sind, verwendet werden.

Es gibt vier Entitätssatzpfade, die verfügbar sind, um Operationen mit Definitionsentitäten auszuführen, wie in der folgenden Tabelle beschrieben.

Festgelegter Pfad der Entität Beschreibung
[Organisations-URI]/api/data/v9.2/EntityDefinitions Enthält eine Sammlung von EntityMetadata EntityType.
[Organisations-URI]/api/data/v9.2/RelationshipDefinitions Enthält ManyToManyRelationshipMetadata EntityType und OneToManyRelationshipMetadata EntityType, da beide von RelationshipMetadataBase EntityType erben.
[Organisations-URI]/api/data/v9.2/GlobalOptionSetDefinitions Enthält eine Sammlung von global definierten BooleanOptionSetMetadata EntityType und OptionSetMetadata EntityType wie beide erben von OptionSetMetadata EntityType.
[Organisations-URI]/api/data/v9.2/ManagedPropertyDefinitions Nur zur internen Verwendung

Jeder Definitionsentitätstyp verwendet MetadataId als eindeutige Bezeichner-Eigenschaft, die es von der MetadataBase EntityType erbt. Während alle Definitionsentitäten eine MetadataId haben, können Sie nicht alle direkt abfragen. Beispielsweise können Sie Operationen an Attributen (Tabellenspalten) nur im Kontext von EntityMetadata Entität abfragen und ausführen, die sie enthält.

Diese Definitionsentitäten unterscheiden sich erheblich von den Tabellen, in denen Geschäfts- und Anwendungsdaten gespeichert sind, z. B.:

  • Die Eigenschaften für Definitionsentitäten verwenden viele der in Web API Complex Type Reference und Web API Enum Type Reference definierten komplexen und Aufzählungstypen anstelle der primitiven Datentypen, die für Eigenschaften in Entitäten verwendet werden, von denen crmbaseentity EntityType geerbt wird.

  • Definitionsentitäten folgen einer anderen Namenskonvention und behalten den in den Assemblys des SDK für .NET verwendeten Pascal Case-Namensstil bei.

  • Definitionsentitäten verwenden die Vererbung in größerem Umfang. Daher müssen Sie möglicherweise Casts durchführen, um die gewünschten Daten abzurufen.

In diesem Abschnitt

Abfragen von Tabellendefinitionen mithilfe der Web-API
Sie können die Web-API verwenden, um Tabellen- oder Spaltendefinitionen mithilfe eines RESTful-Abfragestils abzufragen.

Rufen Sie Tabellendefinitionen nach Name oder MetadataId ab
Ihre Anwendungen können sich an Konfigurationsänderungen anpassen, indem Sie die Tabellen- und Spaltendefinitionen abfragen. Wenn Sie eine der Schlüsseleigenschaften eines Definitionselements kennen, können Sie Definitionen mithilfe der Web-API abrufen.

Tabellendefinitionen über die Web-API erstellen und aktualisieren
Sie können mithilfe der Web-API Tabellen erstellen und aktualisieren, um die gleichen Ergebnisse zu erzielen wie mit CreateEntityRequest und UpdateEntityRequest im SDK für .NET.

Erstellen und Aktualisieren von Spaltendefinitionen mit der Web-API
Sie können mithilfe der Web-API Spalten erstellen und aktualisieren, um die gleichen Ergebnisse zu erzielen wie mit CreateAttributeRequest und UpdateAttributeRequest im SDK für .NET.

Tabellendefinitionen über die Web-API erstellen und aktualisieren
Sie können überprüfen, ob Tabellen zur Teilnahme an einer Beziehung mit anderen Tabellen berechtigt sind, und diese Beziehungen mithilfe der Web-API erstellen oder aktualisieren.

Suchen mit mehreren Tabellen
Suchtypspalten mit mehreren Tabellen ermöglichen es einem Benutzer, eine bestimmte Tabelle zu verwenden, die mehrere Eins-zu-Viele-(1:N-)Beziehungen mit anderen Tabellen in der Umgebung hat. Eine einzelne Suchtypspalte kann auf mehrere andere Tabellen verweisen. Ein Suchwert, der an die Spalte mit mehreren Tabellen übermittelt wird, wird mit einem Datensatz in einer der verknüpften Tabellen abgeglichen. Suchvorgänge in mehreren Tabellen können sowohl mit lokalen Tabellen und virtuellen Tabellen als auch mit referenzierten Tabellen erstellt werden.

Erstellen und Aktualisieren von Optionen (Optionseinstellungen) über die Web-API
Erklärt, wie Sie mit globalen und lokalen Auswahlspalten arbeiten. Wie Sie Optionswerte abrufen, Optionen hinzufügen, aktualisieren, löschen und neu anordnen.

Siehe auch

Tabellendefinitionen in Ihrer Umgebung durchsuchen
Verwenden Sie die Microsoft Dataverse Web-API Beispiel für Web-API-Tabellenschemavorgänge
Beispiel für Web-API-Tabellenschemavorgänge (C#)

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