Programmiermodelle für Dynamics 365 Customer Engagement (on-premises)

Microsoft Dynamics 365 Customer Engagement (on-premises) verfügt über mehrere Programmiermodelle, die angewendet werden, um Ihnen die Flexibilität zu gewähren, sich zu entscheiden, was am besten für Ihre Anforderungen ist.

Das folgende Diagramm zeigt die wichtigsten Programmierbarkeitsszenarien für Dynamics 365 Customer Engagement (on-premises). Verwenden Sie die entsprechenden Dynamics 365 Customer Engagement (on-premises)-Programmiermodelle für den Typ von Lösungen, die Sie erstellen.

Herstellen einer Verbindung mit Dynamics 365 Customer Engagement (on-premises)

Wenn Sie Clients zum Zugriff auf Daten in Dynamics 365 Customer Engagement (on-premises) schreiben, haben Sie zwei Möglichkeiten: Sie können die Web-API oder den Organisationsservice verwenden.

Internet-API

Die Web-API wurde mit dem Update vom Dezember 2016 für Dynamics 365 (online und lokal) eingeführt und bietet eine Entwicklungserfahrung, die für eine Vielzahl von Programmiersprachen, Plattformen und Geräten genutzt werden kann. 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.

Wenn Sie die Web-API verwenden, können Sie aus e.iner Liste mit den Community-unterstützten Bibliotheken, die den OData v4-Standard unterstützen, auswählen. Sie können außerdem direkt Code mit HTTP schreiben. Weitere Informationen: Das Dynamics 365 Customer Engagement Web-API verwenden

Wenn Sie sich mit Dynamics 365 for Customer Engagement (on-premises) Umgebungen mit Internet-facing deployment (IFD) verbinden, können Sie Azure AD Authentifizierungsbibliotheken (ADAL) verwenden, um die Authentifizierung von einer Vielzahl von Programmiersprachen und Plattformen zu ermöglichen. Weitere Informationen: Authentifizieren bei Dynamics 365 Customer Engagement (on-premises) mit der Web-API

Notiz

Die Azure ADAL-Bibliothek ist veraltet. Stattdessen Microsoft-Authentifizierungsbibliothek (MSAL) verwenden.

Der Organization Data Service („REST-Endpunkt“ oder „OData-Endpunkt“) ist ein OData v2-Dienst, der mit dem Update vom Dezember 2016 für Dynamics 365 (online und lokal) zugunsten der Web-API veraltet wurde. Der Organisationsdatendienst ist im vorangehenden Diagramm nicht enthalten. Der Organisationsservice ist weiterhin verfügbar, um Code zu unterstützen, der diesen verwendet hat. Für eine Neuentwicklung für Dynamics 365 Customer Engagement (on-premises) wird jedoch die Web-API empfohlen. Weitere Informationen: Den OData-Endpunkt mit Web-Ressourcen verwenden

Organisationsservice

Als .NET-Entwickler können Sie entweder die Web-API oder den Organisationsservice verwenden. Mit dem Organisationsservice können Sie einen Satz Assemblys und Tools verwenden, um stark typisierte Klassen zu generieren, die benutzerdefinierte Entitäten und Attribute umfassen, die zu einer Dynamics 365 Customer Engagement (on-premises)-Instanz hinzugefügt wurden.

Mit SDK Montagen und Tools für die Codegenerierung können Sie auch eine OrganizationServiceContext einfügen, die auf dem gleichen Konzept wie der DataServiceContext in Windows Communication Foundation (WCF) Data Services basiert. Mit dieser Klasse können Sie Änderungen nachverfolgen, Identitäten und Beziehungen verwalten und erhalten Zugriff auf den Dynamics 365 Customer Engagement (on-premises) .NET Language-Integrated Query (LINQ) Provider, damit Sie Abfragen mit LINQ erstellen können. Wenn Sie die Tools für Codegenerierung verwenden, rufen Sie stark typisierte Klassen für Entitäten und Attribute ab, die definiert werden, wenn das Codegenerierungstool ausgeführt wird. Diese heißen früh gebundene-Klassen. Weitere Informationen: Verwenden Sie die Early Bound Entity Classes im Code

Wenn Ihr Code mit Entitäten und Attributen verwendet werden muss, die zum Zeitpunkt der Ausführung der Codegenerierungstools nicht bekannt waren, können Sie eine Entity-Klasse verwenden, die das Angeben von Entitäten und Entitätsattributen in Ihrem Code erlaubt. Dieser spät gebundene Stil des Schreibens von Code bietet mehr Flexibilität, erlaubt jedoch keine Kompilierzeitüberprüfung aller Typen, sodass keine impliziten Umwandlungen auftreten. Späte Bindung überprüft nur Typen, wenn das Objekt erstellt oder eine Aktion für den Typ ausgeführt wurde. Die Entitä-Klasse erfordert, dass Typen explizit angegeben werden, um implizite Umwandlungen zu vermeiden. Weitere Informationen: Verwenden Sie die Late Bound Entity Klasse in Code

Wenn Sie einen Windows Client erstellen oder Windows PowerShell verwenden, stellt Xrm.Tooling eine Reihe von APIs zur Verfügung, die die SDK-Assemblies nutzen, um zusätzliche Funktionalitäten und Ressourcen speziell für die Entwicklung von Windows Clients bereitzustellen. Weitere Informationen: Erstellen von Windows-Client-Anwendungen mithilfe der XRM-Tools

Erweiterungen auf dem Server

Sie können Code schreiben, der auf Ereignisse wartet und benutzerdefinierte Geschäftslogik anwendet, um das Standardverhalten der Plattform zu ändern oder zu erweitern. Dieser Code ist nur verfügbar zum Schreiben mit verwaltetem .NET-Code, und die Entwicklererfahrung basiert auf den gleichen Objekten, die in den SDK-Assemblys definiert werden. Sie können mit dem Organisationsservice arbeiten, um Vorgänge mit Dynamics 365 Customer Engagement (on-premises)-Daten auszuführen. Weitere Informationen: Schreiben Sie Plug-Ins, um Geschäftsprozesse zu erweitern.

Sie können auch benutzerdefinierte Prozesse auf Grundlage des Windows Workflow Foundation-Programmiermodells erstellen. Sie können mehrere unterschiedliche Arten Prozesse erstellen. Meist verwenden Sie den Workflowdesigner. Aber wenn es Funktionen gibt, die nicht mit dem Designer möglich sind, können Sie Prozesse mithilfe des Codes definieren. Weitere Informationen: Werden Sie Workflows schreiben, um Geschäftsprozesse zu automatisieren

Erweiterung in der Anwendung

Jede der Client-Anwendungen, die von Dynamics 365 Customer Engagement (on-premises) bereitgestellt werden, ermöglicht das Definieren von Anpassungen und Bereitstellen mehrerer Typen von Clients. Die Webanwendung, Dynamics 365 for Outlook, Dynamics 365 für Tablets und Dynamics 365 für Telefone bieten jeweils Funktionalitäten, um angepasste Navigations- und Befehlsoptionen sowie das Xrm-Objektmodell und Xrm.Utility-Funktionen einzubinden, die Sie mit JavaScript verwenden können, um reaktionsfähige Erfahrungen im Client bereitzustellen. JavaScript-Bibliotheken, HTML-Seiten, Bilder und andere Dateitypen, die im Client verwendet oder angezeigt werden können, sind als URL-adressierbare Webressourcen verfügbar. Weitere Informationen: Verwenden Sie JavaScript mit Customer Enagement Apps und Web Ressourcen für Dynamics 365 Customer Engagement (on-premises).

Wenn Sie auf Dynamics 365 Customer Engagement (on-premises)-Daten zugreifen müssen, die in dem Kontext, in dem Ihr JavaScript-Code ausgeführt wird, nicht verfügbar sind, können Sie den Server aufrufen, um die benötigten Daten zu erhalten. Der Organisationsservice kann verwendet werden, es ist jedoch viel einfacher, die Web-API mit JSON zu verwenden, statt das vom Organisationsservice geforderte XML. Da das Skript im Kontext der Anwendung ausgeführt wird, werden Sie automatisch authentifiziert. Weitere Informationen: Einstieg in die Dynamics 365 Customer Engagement Web-API (clientseitiges JavaScript)

Siehe auch

Entwicklerhandbuch für Dynamics 365 Customer Engagement (on-premises)
Erste Schritte
Lernprogramme und Ressourcen
Bewährte Methoden
Entwicklertools