Common Data Service-Web-API verwenden

Die Web-API ist eine der beiden Webdienste, die Sie verwenden können, um mit Daten und Metadaten in Common Data Service arbeiten zu können. Der andere ist der Organisationsservice.

Die Common Data Service-Web-API bietet eine Entwicklungserfahrung, die für eine Vielzahl von Programmiersprachen, Plattformen und Geräten verwendet werden kann. Die Web-API implementiert OData (Open Data Protocol), Version 4.0, ein OASIS-Standard zum Erstellen und Nutzen von RESTful APIs über umfassende Datenquellen. Weitere Informationen zu diesem Protokoll finden Sie unter http://www.odata.org/. Details zu diesem Standard finden Sie unter https://www.oasis-open.org/standards#odatav4.0.

Da die Web-API auf offenen Standards basiert, stellen wir keine Assemblys für eine bestimmte Entwicklererfahrung bereit. Sie können HTTP-Anforderungen für bestimmte Vorgänge erstellen oder Bibliotheken von Drittanbietern verwenden, um Klassen für beliebige Sprachen oder Plattformen zu erstellen. Eine Liste der Bibliotheken, die OData-Version 4.0 unterstützen, finden Sie unter http://www.odata.org/libraries/.

Web-API und Organisationsservice

Es ist wichtig zu wissen, dass der Organisationsservice die Plattform definiert. Die Web-API stellt eine RESTful-Programmierungserfahrung bereit. Letztendlich durchlaufen aber alle Datenoperationen den zugrunde liegenden Organisationsservice. Der Organisationsservice definiert die unterstützten Vorgänge als Nachrichten. Jede Nachricht hat einen Namen. Die Namen sind an die Ereignisse gebunden, die im Ereignisframework verwendet werden, um zu bestimmen, welche registrierten Erweiterungen initiiert werden sollten. Weitere Informationen: Ereignisframework

Mit der Web API können Sie die gleichen Operationen wie mit dem Organisationsservice auszuführen, haben aber eine Umgebung im RESTful-Stil. OData v4 stellt benannte Operationen über Funktionen oder Aktionen bereit. Die meisten im Organisationsservice verfügbaren Nachrichten werden als entsprechende benannte Funktion oder Aktion verfügbar gemacht. Diese Nachrichten, die CRUD-Vorgängen entsprechen, sind nicht in der Web-API verfügbar, da sie als RESTful-Service Implementierungen mit GET, POST, PATCH und DELETE HTTP-Methoden haben. Innerhalb der Plattform werden die Nachrichten Abrufen, Erstellen, Aktualisieren und Löschen aber so wie sie sind aufgerufen, wenn die entsprechenden Vorgänge mit den .NET Framework-Assemblys ausgeführt werden.

Verwenden von Daten mit Code
OData - the best way to REST
OData Version 4.0 Part 1: Protocol Plus Errata 02
OData Version 4.0 Part 2: URL Conventions Plus Errata 02
OData Version 4.0 Part 3: Common Schema Definition Language (CSDL) Plus Errata 02