Die Web-API mit Tabellendefinitionen verwenden

Sie können alle Tabellen- und Spaltendefinitionsvorgänge (Metadaten) mit der Web-API ausführen, die Sie mit dem 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 für Vorgänge mit Definitionsentitäten verfügbar gemacht werden, wie in der folgenden Tabelle beschrieben.

Entitätensatz-Pfad	Description
[Organisations-URI]/api/data/v9.2/Entitätsdefinitionen	Enthält eine Auflistung 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 Auflistung von global definierten BooleanOptionSetMetadata EntityType und OptionSetMetadata EntityType , da beide von OptionSetMetadata EntityType erben.
[Organisations-URI]/api/data/v9.2/ManagedPropertyDefinitions	Nur zur internen Verwendung

Jeder Definitionsentitätstyp verwendet MetadataId als eindeutige Bezeichnereigenschaft, die er von der MetadataBase EntityType erbt. Obwohl alle Definitionsentitäten über ein MetadataIdElement verfügen, können Sie nicht alle elemente direkt abfragen. Beispielsweise können Sie Abfragen durchführen und Vorgänge an Attributen (Tabellenspalten) nur im Kontext der Entität ausführen, die EntityMetadata diese enthält.

Diese Definitionsentitäten unterscheiden sich erheblich von den Tabellen, in denen Geschäfts- und Anwendungsdaten gespeichert werden, 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, die von crmbaseentity EntityType erben.

• Definitionseinheiten folgen einer anderen Benennungskonvention und behalten den Pascal Case-Benennungsstil, der in den Assemblies des SDK für .NET verwendet wird.

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

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

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

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

Erstellen und Aktualisieren von Tabellenbeziehungen mithilfe der Web-API
Sie können überprüfen, ob Tabellen berechtigt sind, an einer Beziehung mit anderen Tabellen teilzunehmen und diese Beziehungen dann mithilfe der Web-API zu erstellen oder zu aktualisieren.

Nachschlagevorgänge 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 an die Mehrtabellentypspalte übermittelter Nachschlagewert 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 Auswahlmöglichkeiten (Optionssätze) mithilfe der Web-API
Erläutert, wie Sie mit globalen und lokalen Auswahlspalten arbeiten. Abrufen von Optionswerten, Hinzufügen, Aktualisieren, Löschen und Umsortieren von Optionen.

Siehe auch

Durchsuchen der Tabellendefinitionen für Ihre Umgebung
Verwenden der Microsoft Dataverse-Web-APIWeb-API-Tabellenschema-Vorgänge Beispiel
Beispiel für Web-API-Tabellen-Schemaoperationen (C#)