Dynamics 365 Customer Engagement (on-premises) und -Webdienste verwenden

Webdienste stellen APIs bereit, die Sie verwendet werden, wenn Sie Programme für Dynamics 365 Customer Engagement (on-premises)verfassen. Dieses Thema enthält verfügbaren Webdienst und enthält die grundlegenden Informationen, um sie zu verstehen und zu vergleichen.

Web-API

Die Web-API wurde mit Version 8.0 eingeführt und inkrementell aktualisiert, um eine Parität mit dem Organisationsdienst bereitzustellen. Mit dieser Version wird die Parität erreicht.

Verglichen mit dem Organisationsdienst bietet die Web-API bessere Kompatibilität zu einer Vielzahl von Programmiersprachen, Plattformen und Geräten. Die Web-API implementiert OData(Open Data Protocol) v4. OData ist ein OASIS-Standard zum Erstellen und Nutzen von RESTful-APIs für umfassende Datenquellen. Sie erfahren mehr auf den OData-Protokoll- und den OASIS-Standard-Websites.

Da die Web-API auf offenen Standards erstellt wird, müssen Sie nicht die Client-Bibliotheken verwenden, die für Dynamics 365 Customer Engagement (on-premises) festgelegt werden. Sie können HTTP-Anforderungen für bestimmte Vorgänge auswählen und erstellen oder Bibliotheken von Drittanbietern verwenden, um Klassen für beliebige Sprachen oder Plattformen zu nutzen. Eine Liste von verfügbaren Bibliotheken ansehen.

Schließlich ersetzt die Web-API den Organisationsdienst und den Organisationsdatendienst, aber beide vorhandenen Webdienste stehen zur Verfügung, um allmählich den Übergang zu einer einzelnen Web-API zu aktivieren. Die Web-API sollte Ihre erste Wahl sein für eine neue Bereitstellung, die Dynamics 365 Customer Engagement (on-premises) unterstützt und zukünftige Version von Dynamics 365 Customer Engagement (on-premises) unterstützt. Verwenden Sie die Web-API für Projekte, die auf Dynamics 365 Customer Engagement (on-premises)-Daten mit Code zugreifen, der nicht auf dem Server ausgeführt wird, einschließlich Anforderungen von Webressourcen und Formularskripts, die in Dynamics 365 Customer Engagement (on-premises)-Anwendungs-Clients laufen. Derzeit können Sie die Web-API für Code, der auf dem Server, wie in Plug-Ins oder Workflow-Assemblys, nicht einfach verwenden. Sie sollte für diese Zwecke den Organisationsdienst weiterhin nutzen.

Weitere Informationen: Nutzen Sie die Dynamics 365 Customer Engagement Web-API.

Organisationsservice

Der Organization Service ist seit Dynamics CRM 2011 verfügbar. Es ist der Webdienst, mit dem die meisten Entwickler, die mit Dynamics 365 Customer Engagement (on-premises) arbeiten,bereits vertraut ist. Der Organisationsdienst ist für die Verwendung mit .NET optimiert. Es gibt einen einen Satz .NET-Assemblys und Tools, damit Sie stark typisierte Klassen und Proxys generieren können, die den Entwicklungsprozess optimieren und eine bessere Entwicklungserfahrung mit Visual Studio bringen.

Die SDK für .NET-Assemblys für den Organisationsdienst verwenden derzeit den 2011 SOAP-Endpunkt, der veraltet ist. Die gewünschten SDK-Assemblys werden migriert, um intern die Web-API anstelle des 2011 SOAP-Endpunkts zu verwenden. Wenn dies geschieht, kann jeder Code, der mit der SDK-Assemblys erstellt wird, weiterhin unterstützt werden, denn Anrufe werden automatisch vom 2011 SOAP-Endpunkt an die Web-API weitergeleitet. Dieses Update ist für Sie größtenteils transparent und erfordert lediglich, dass Sie die Laufzeitordner-SDK-Assemblys Ihrer Anwendung durch überarbeitete Assemblys ersetzen. Weitere Details sowie neue Informationen zur .NET Core-Entwicklung finden Sie unter Apps auf Dataverse ServiceClient umstellen.

Vgl. Auswählen des Entwicklungsstils für Informationen zur Nutzung des Organisationsdiensts und der Web-API.

Wenn Sie ein .NET-Entwickler ohne Anforderungen sind, um andere Plattformen zu unterstützen, müssen Sie die Web API nicht sofort wechseln. Sie müssen den Organisationsdienst nutzen, um alle Funktionen zu unterstützen, die Sie auch für Organisationen mit der Version von Dynamics 365 Customer Engagement (on-premises) freigegeben möchten, bevor die Web-API bereitgestellt wurde.

Geschäftslogik, die in Plug-Ins oder Workflow-Assemblys auf dem Server läuft, während Sie den Organisationsdienst nutzen. Ein- und Ausgabeparameter nutzen spezielle Klassen, die mit den entsprechenden Assemblys definiert wurden, die den Orgnisationsdienst unterstützen.

Weitere Informationen: Verwenden des Dynamics 365 Customer Engagement (on-premises)-Organisationsservice

Organisationsdatenservice

Der Organization Data Service, der manchmal auch als „OData“ oder „REST“ Endpunkt bezeichnet wird, ist ebenfalls seit Dynamics CRM 2011 verfügbar. Dieser Dienst implementierte den OData v2-Standard. Während dieser Service weiterhin für die kommenden Jahre verfügbar ist, schreiben wir ihn mit Dynamics 365 Customer Engagement (on-premises) ab. Der Organisationsdatendienst war immer beschränkt auf das Erstellen, Lesen, Aktualisieren und Löschen von Vorgängen und unterstützte nie die Fähigkeit, spezielle Nachrichten zu den verwendeten Verschlüsselungsschlüsseln, die im Organisationsdienst verwendet werden, aufzurufen und konnte deshalb nie die Parität mit der Funktionalität des Organisationsdatendienstes erreichen. Änderungen, die in den OData-Standards zwischen v2 und v4-Clients implementiert werden, können für den Service nicht aktualisiert werden, um die Bestimmungen eines Services zu erfüllen, der Parität mit dem Organisationsservice hat. Wir konnten viel Feedback, den wir zum Organization Data Service erhalten hatten, werwenden, um die Web-API besser zu machen.

Diese Version der Dynamics 365 Customer Engagement Webdienste enthält keine Informationen über den Organization Data Service. Sie finden auch Informationen zum Organisationsdatendienst in der Dokumentation für die Dynamics CRM 2015-Version unter Verwendung des OData-Endpunkts mit Webressourcen.

Discovery Web Services

Dynamics 365 Customer Engagement (on-premises) ist eine Mehr-Mandanten-Anwendung. Das bedeutet, dass eine einzelne Bereitstellung mehrere Instanzen von Customer Engagement (on-premises) hostet, jede mit eigenen Daten, jede verfügbar über eine andere URL. Darüber hinaus kann sich, insbesondere wenn Dynamics 365 Server in einem Rechenzentrum gehostet werden, der spezifische Server ändern, wenn Ressourcen verschoben oder die Last verteilt wird. Discovery Web Services stellen eine Methode zur Verfügung, damit ein Client erkennen kann, welche Server und Organisationen verfügbar sind, damit ein Benutzer sich basierend auf dem Benutzerkonto verbinden kann. Sie können entweder die OData V4 basierte WEB API oder die SDK-basierte SDK-Assembly-API verwenden, um auf den Discovery-Webdienst zuzugreifen. Während beide API ähnliche Funktionalität biten, ist der WEB-API einfacher für eine größere Anzahl von Programmiersprachen, Plattformen und Geräten.

Weitere Informationen: Ermitteln Sie die URL für Ihre Organisation mit der Web-API oder Ermitteln Sie die URL für Ihre Organisation mit dem IDiscoveryService Webdienst

Bereitstellungswebdienst

Für Dynamics 365 Customer Engagement (on-premises) können Sie Aktionen ausführen, um Ihre Bereitstellung mithilfe des Bereitstellungswebdiensts programmgesteuert zu verwalten. Diese sind im Wesentlichen dieselben Vorgänge, die Sie auf dem Server mit dem Bereitstellungsmanager-Toolclienten ausführen können, der auf dem Server installiert wurde. Sie können Organisationen erstellen, importieren oder löschen und bestimmten Einstellungen im Code hinzufügen. Dies kann hilfreich sein, wenn Sie bestimmte Prozesse automatisieren möchten, wenn Sie eine Hostingdienstleistung anbieten oder wenn Sie der Erstellung Umgebungen für das Testen automatisieren möchten.

Siehe auch

Authentifizieren von Benutzern in Dynamics 365 Customer Engagement
Authentifizieren von Benutzern in Dynamics 365 Customer Engagement (on-premises)
Verwenden von Dynamics 365 Customer Engagement-Webdiensten
Erstellen von Windows-Client-Anwendungen mithilfe der XRM-Tools
Entwicklerhandbuch zu modellgestützten Apps