Verwenden des OData-Endpunkts mit Webressourcen
Veröffentlicht: November 2016
Gilt für: Dynamics CRM 2015
Der OData-Endpunkt mit Webressourcen bietet eine alternative Schnittstelle zum Arbeiten mit Microsoft Dynamics CRM 2015 und Microsoft Dynamics CRM Online 2015-Update- Daten. Sie können den OData-Endpunkt verwenden, um HTTP-Anforderungen auszuführen, indem Sie einen Service verwenden, der auf einer URI (Uniform Resource Identifier) basiert.
In diesem Thema
Was ist OData?
Microsoft Dynamics CRM Implementierung von OData
Drittanbietertools zum Generieren von Code
Was ist OData?
Der OData-Endpunkt verwendet das Open-Data-Protokoll. Dieses Protokoll implementiert ein “RESTful”-Entwurfsmuster. REST repräsentiert Representational State Transfer.REST ist ein Architekturstil, in dem jede Ressource über eine eindeutige URI adressiert wird. In Microsoft Dynamics 365 kann es sich bei einer Ressource um eine Entitätssammlung oder um einen Datensatz handeln.
REST funktioniert gleich wie das Internet. Sie interagieren mit Ressourcen, indem Sie HTTP-Verben wie GET, POST, MERGE und DELETE verwenden. Verschiedene Bibliotheken können verwendet werden, um HTTP Anforderungen und Antworten zu verarbeiten.REST stellt eine Standardschnittstelle auf, die Sie mit jeder Programmiersprache verwenden können.REST können entweder synchrone oder asynchrone Verarbeitung oder Vorgänge sein. Die Möglichkeit zum Ausführen von asynchronen Vorgängen macht REST gut geeignet für Webressourcen und Skripts, die in Microsoft Dynamics CRM 2015 und Microsoft Dynamics CRM Online 2015-Update verwendet werden.
Microsoft Dynamics CRM Implementierung von OData
Microsoft Dynamics CRM 2015 und Microsoft Dynamics CRM Online 2015-Update verwendet das Windows Communication Foundation (WCF)-Datendienst-Framework, um einen OData (Open Data Protocol)-Endpunkt bereitzustellen, der ein REST-basierter Datendienst ist. Dieser wird Endpunkt wird als Organization Data Service bezeichnet. In Microsoft Dynamics 365 ist die Dienststamm-URI:
[Your Organization Root URL]/xrmservices/2011/organizationdata.svc
OData sendet oder empfängt Daten mit der Verwendung von ATOM oder JavaScript-Objekt-Notation (JSON).ATOM ist ein XML-basiertes Format, das in der Regel für RSS-Feeds verwendet wird.JSON ist ein Textformat, das die Serialisierung von JavaScript -Objekten zulässt.
Um einen konsistenten Satz von URIs bereitzustellen, der den in Microsoft Dynamics 365 verwendeten Entitäten entspricht, strukturiert ein Entity Data Model (EDM) die Daten in Form von Datensätzen von Entitätstypen und die Zuordnungen zwischen ihnen.
Entity Data Model mit OData
Das Microsoft Dynamics 365-EDM wird in einem OData-Dienst-Metadatendokument beschrieben, das in folgendem Pfad verfügbar ist:
[Your Organization Root URL]/xrmservices/2011/organizationdata.svc/$metadata
Dieses XML-Dokument verwendet die Sprache CSDL (Conceptual Schema Definition Language), um die Daten zu beschreiben. Laden Sie dieses Dokument herunter, um es zum Generieren von typisierten Klassen zu verwenden, wenn Sie verwalteten Code verwenden, oder als Verweis für verfügbare Objekte, wenn Sie JavaScript verwenden.
Einschränkungen
Der OData-Endpunkt bietet eine Alternative zum SOAP-Endpunkt, aber es gibt derzeit bestimmte Einschränkungen.
Es können nur Aktionen zum Erstellen, Abrufen, Aktualisieren und Löschen für Entitätsdatensätze ausgeführt werden.
Meldungen, die die Execute-Methode benötigen, können nicht ausgeführt werden.
Aktionen zum Zuordnen und Aufheben der Zuordnung können ausgeführt werden, indem Sie Navigationseigenschaften verwenden.
Das OData-Protokoll ist nicht vollständig implementiert. Einige Systemabfrageoptionen sind nicht verfügbar.
Weitere Informationen finden Sie unter OData-Systemabfrageoptionen mithilfe des OData-Endpunkts.Sie können späte Bindung mit verwaltetem Code für benutzerdefinierte Entitäten, Attribute und Beziehungen verwenden, die nicht existierten, als der Code geschrieben wurde.
Sie verwenden in der Regel WCF-Datendienste-Clientdatendienstklassen bei der Programmierung mit verwaltetem Code. Diese Klassen erlauben frühe Bindung, sodass Sie stark typisierte Klassen zur Entwurfszeit erhalten. Die einzelnen Entitäten, die für Sie verfügbar sind, sind im System definierten Entitäten, als die Klassen generiert wurden. Dies bedeutet, dass Sie späte Bindung nicht verwenden können, um benutzerdefinierte Entitäten, Attribute oder Beziehungen zu verwenden, die nicht in den WCF-Datendienste-Clientdatendienstklassen enthalten waren, als sie generiert wurden.
Drittanbietertools zum Generieren von Code
Die Community der Entwickler, die mit Microsoft Dynamics 365 arbeiten, hat verschiedene Tools erstellt, die veranschaulichung, wie der OData-Endpunkt funktioniert und Codse generieren kann, den Sie verwenden können. Die folgenden Tools bieten Funktionen, um Code zu generieren, um mit Dynamics 365-Daten mithilfe des OData-Endpunkts zu arbeiten.
CRM-REST Generator
Verwenden Sie dieses Tool, um Anforderungen zu erstellen, um Daten zu erhalten und eine Vielzahl von JavaScript-Bibliotheken zu verwenden.Dank an Microsoft Dynamics 365 MVP Jason Lattimer für das Erstellen dieses Tools.
OData-Abfragedesigner
Enthlaten im Dynamics XRM-Toolsprojekt, erlaubt Ihnen der OData-Abfragedesigner, Abfragen zu erstellen, um Daten mithilfe des OData-Endpunkts abzurufen.Dank an Microsoft Dynamics 365 MVP Rhett Clinton für das Erstellen dieses und anderer Tools.
Siehe auch
Verwenden von Webservicedaten in Webressourcen (OData- und Modern-App-SOAP Endpunkt)
Verwenden Sie den SOAP-Endpunkt der Modern App für moderne Anwendungen mit Webressourcen
Webressourcen für Microsoft Dynamics CRM 2015
Endpunkte mithilfe der Microsoft Dynamics CRM 2015-Entwicklerressourcenseite herunterladen
Abfrage von Microsoft Dynamics CRM 2015-Daten mit dem OData-Endpunkt
Ausführen grundlegender Datenvorgänge mithilfe des OData-Endpunkts
Verwenden des OData-Endpunkts mit Ajax- und JScript-Webressourcen
Ausführen zusätzlicher Datenvorgänge mithilfe des OData-Endpunkts
Beispiel: Erstellen, Abrufen, Aktualisieren und Löschen mithilfe des OData-Endpunkts mit jQuery
Beispiel: Erstellen, abrufen, aktualisieren und löschen mithilfe des OData-Endpunkts mit JavaScript
Beispiel: OData-Endpunkt jQuery-Kontakteditor
Open Data Protocol Übersicht
OData SDK
Technischer Artikel: Verwenden von Optionssatz-Optionen mit dem REST-Endpunkt - Jscript
© 2017 Microsoft. Alle Rechte vorbehalten. Copyright