Freigeben über

Die Web-API mit Tabellendefinitionen verwenden

Sie können alle Tabellen- und Spaltendefinitionsvorgänge (Metadaten) mithilfe 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.

Die Web-API macht vier Entitätssatzpfade verfügbar, um Vorgänge mit Definitionsentitäten auszuführen, wie in der folgenden Tabelle beschrieben.

Entitätensatz-Pfad Description
[Organisations-URI]/api/data/v9.2/EntityDefinitions 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.
[Organisation-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üssten Sie möglicherweise Casts durchführen, um die gewünschten Daten abzurufen.

In diesem Abschnitt

Abfragen von Tabellendefinitionen mithilfe der Web-API
Verwenden Sie die Web-API, um Tabellen- oder Spaltendefinitionen mithilfe eines RESTful-Abfrageformats 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
Verwenden Sie die Web-API zum Erstellen und Aktualisieren von Tabellen, um dieselben Ergebnisse wie das SDK für .NET CreateEntityRequest und UpdateEntityRequest zu erzielen.

Erstellen und Aktualisieren von Spaltendefinitionen mithilfe der Web-API
Verwenden Sie die Web-API, um Spalten zu erstellen und zu aktualisieren, damit Sie dieselben Ergebnisse wie beim SDK für .NET CreateAttributeRequest und UpdateAttributeRequest erzielen.

Erstellen und Aktualisieren von Tabellenbeziehungen mithilfe der Web-API
Verwenden Sie die Web-API, um zu überprüfen, ob Tabellen an einer Beziehung mit anderen Tabellen teilnehmen können, und dann diese Beziehungen erstellen oder 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 entspricht einem Datensatz in einer der verknüpften Tabellen. Sie können mehrtabellige Nachschlageoperationen erstellen, indem Sie sowohl lokale Tabellen als auch virtuelle Tabellen als referenzierte Tabellen verwenden.

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 Neuanordnen von Optionen

Siehe auch

Durchsuchen der Tabellendefinitionen für Ihre Umgebung
Verwenden der Microsoft Dataverse-Web-API
Beispiel für HTTP-Tabellenschemavorgänge der Web-API
Beispiel für Web-API-C#-Tabellenschemavorgänge
Beispiel für Web-API-PowerShell-Tabellenschemavorgänge

  • Last updated on