Verwenden der Web-API mit Dynamics 365-Metadaten

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Sie können die Metadatenvorgänge mit der Web-API ausführen, die Sie mithilfe des Organisationsservice ausführen können. Dieser Abschnitt enthält Anweisungen dazu, wie die Web-API mit Entitätstypen, die in der Web API Metadata EntityType Reference enthalten sind, verwendet werden.

Es gibt vier festgelegte Pfade der Entität, die verfügbar gemacht werden, um Vorgänge mit Metadatenentitäten auszuführen (siehe folgende Tabelle).

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

Jeder Metadatenentitätstyp verwendet MetadataId als eindeutigen Bezeichnereigenschaft, die vom, MetadataBase EntityType erbt. Wenn alle Metadatenentitäten eine MetadataIdbesitzen, können Sie nicht alle direkt abrufen. Beispielsweise können Sie Vorgänge für Attribute nur im Rahmen der EntityMetadata-Entität abfragen und ausführen, die sie enthält.

Für einige Entitäten gelten erhebliche Unterschiede hinsichtlich der Entitäten, die Unternehmens- und Anwendungsdaten speichern, z.B.:

• Die Eigenschaften für Metadatenentitäten verwenden viele der Komplex- und Enumerationstypen, die in Web API ComplexType Reference und Web API EnumType Reference definiert sind, anstelle de der primitiven Datentypen, die für Eigenschaften in Entitäten verwendet werden, die von crmbaseentity EntityType erben.

• Metadatenentitäten folgen einer anderen Namenskonvention und verwenden die Pascal-Schreibung, die in den Assemblys des Organisationsservice verwendet wird.

• Metadatenentitäten nutzen die Vererbung intensiver. Deshalb müssen Sie möglicherweise Umwandlungen ausführen, um die Daten abzurufen, die Sie verwenden möchten.

In diesem Abschnitt

• Metadaten mit Web-API abfragen
  Sie können die Web-API verwenden, um die Metadaten auf eine Art und Weise abzufragen, die der Vorgehensweise mithilfe der RetrieveMetadataChangesRequest und der Objekte im Microsoft.Xrm.Sdk.Metadata.Query-Namespace unter Verwendung des Organisationsservice ähnelt.

• Abrufen von Metadaten über den Namen oder die MetadataId
  Ihre Anwendungen können durch Abrufen von Metadaten an Konfigurationsänderungen anpassen. Wenn Sie eine der Schlüsseleigenschaften eines Metadatenelements kennen, können Sie Metadatendefinitionen mit der Web-API abrufen.

• Erstellen und Aktualisieren von Entitätsdefinitionen mit der Web-API
  Sie können die Entitäten und Attribute mit der Web-API erstellen und aktualisieren, um die gleichen Ergebnisse zu erzielen, die Sie mit dem Organisationsservice CreateEntityRequest, UpdateEntityRequest, CreateAttributeRequest und UpdateAttributeRequest erhalten.

• Erstellen und Aktualisieren von Entitätsbeziehungen mit der Web-API
  Sie können feststellen, ob Entitäten sich für die Teilnahme an einer Beziehung mit anderen Entitäten eignen, und anschließend diese Beziehungen mit der Web-API erstellen oder aktualisieren.

Siehe auch

Die Metadaten und Datenmodelle in Microsoft Dynamics 365
Durchsuchen der Metadaten für die Organisation
Verwenden des Organisationsdienstes mit Dynamics 365-Metadaten
Verwenden der Microsoft Dynamics 365-Web-API

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright