Freigeben über


Einführung in den Bereitstellungs-Webdienst

 

Veröffentlicht: Januar 2017

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

Der Bereitstellungsservice ermöglicht der Erstellen von Lösungen, um die Unterstützung für mehrere Organisationen nutzen zu können (Multi-Tenant-Support).Microsoft Dynamics 365 ermöglicht Ihnen das Hosten mehrerer Kundenorganisationen in einer einzigen Bereitstellung. Diese Feature bringt gehosteten Lösungen oder Unternehmen Vorteile, die eine Trennung der Daten innerhalb der Organisation erfordern Da die Verwendung des Bereitstellungsservice Zugang auf den Dynamics 365-Server erfordert, kann dieser nur für Microsoft Dynamics 365 lokale Bereitstellungen verwendet werden.

Mit mehrfachen Organisationssupport unterstützen die Microsoft Dynamics 365 Webanwendungen und die Webdienste das Speichern und Abrufen von Daten von verschiedenen Organisationen, während die Sicherheit und die Privatsphäre jeder einzelnen Organisation gewahrt bleibt.. Eine einzelne Microsoft Dynamics 365 Datenbankkonfiguration speichert die Metadaten und Standortinformationen für alle Kundenorganisationen. Aber jede Kundenorganisation hat eine eigene Datenbank, die auf einem Server läuft Microsoft SQL Server. Weitere Informationen zu den Entitäten und Konfigurationseinstellungen, die vom Bereitstellungsservice gesteuert werden, finden Sie unter Bereitstellungs-Entitäten und Bereitstellungs-Konfigurationseinstellungen.

Microsoft Dynamics 365 unterstützt keinen abwärtskompatiblen Endpunkt für den Bereitstellungsservice. Daher muss jeder Code, der für den Bereitstellungsservice Microsoft Dynamics CRM 4.0 erstellt wird, aktualisiert und mit der neuen Assembly neu kompiliert werden.

Fügen Sie den Bereitstellungsservice Ihrem Projekt hinzu

Sie können den Bereitstellungsservice verwenden, indem Sie der Assembly Microsoft.Xrm.Sdk.Deployment.dll einen Verweis hinzugefügt, den Sie im SDK\bin Ordner finden. Alternativ können Sie die folgenden Servicereferenz für die Lösung hinzufügen.

    http://myservername/xrmdeployment/2011/deployment.svc
    svcutil.exe http:// myservername/XRMDeployment/2011/Deployment.svc?wsdl

Die erstellt eine Konfigurationsdatei und eine Codedatei, die die Clientklasse enthält. Fügen Sie Ihrer Client-Anwendung diesen beiden Dateien hinzu und verwenden Sie die Clientklasse, um den Dienst anzurufen.

Bereitstellungsinstallation:

Wenn Sie Aufrufe gegen die Microsoft Dynamics 365 Bereitstellungsentitäten ausführen, muss die Bereitstellungsservice-Serverrolle korrekt auf einem Microsoft Dynamics 365 Server installiert werden. Stellen Sie sicher, dass die folgenden Kriterien von der Bereitstellungs-Serviceinstallation erfüllt werden:

  • Um Organisationsvorgänge wie erstellen oder aktualisieren zu verwenden, müssen Sie die Bereitstellungsservice-Serverrolle mithilfe eines Domänenbenutzers installieren. Das Domänenbenutzerkonto muss lokale und Systemadministratorrechte im SQL Server haben, auf denen Organisationsdatenbanken gehostet werden.

  • Der Bereitstellungsdienst sollte mit einer anderen Dienstidentität als der andere Microsoft Dynamics 365 Service und der Anwendungsserver erfolgen. Wenn Sie Netzwerkdienst verwenden, sollte die Serverrolle auf einem separaten Server alleine ohne andere Microsoft Dynamics 365 Serverrollen installiert werden. Die Installation der Bereitstellungsservicerolle neben anderen Serverrollen kann Sicherheitsrisiken verursachen, weil beide Server unter dem Netzwerkdienstkonto ausgeführt werden. Wenn Sie das Netzwerkdienstkonto verwenden, ist es nicht möglich, Organisationsvorgänge, mithilfe von Windows PowerShell oder des Bereitstellungswebdiensts auszuführen.

Weitere Informationen zur Installation des Bereitstellungsdiensts finden Sie unter den Microsoft Dynamics CRM-Serverrollen.

Microsoft Dynamics 365 umfasst zwei Serverkomponenten: den Microsoft Dynamics 365 Anwendungsserver und den Microsoft Dynamics 365 Server. Jedes schließt eine gesonderte Gruppe von Serverrollen ein, die installiert werden, wenn der Setup ausgeführt wird. Die Bereitstellungs-Servicerolle wird automatisch installiert, wenn der Setup-Assistenten die Microsoft Dynamics 365 Plattform installiert.

Bereitstellungsserviceauthentifizierung und -Identitätswechsel

Bereitstellungs-Serviceauthentifizierung wird von Active Directory behandelt, die als integrierte Windows-Authentifizierung bekannt ist. Sie können auch mithilfe des Identitätswechsel, mit dem Sie die Webdienstmethoden im Auftrag eines anderen Benutzers aufzurufen können, die gewünschte Funktion oder den Service zur Verfügung stellen. Um den Bereitstellungswebdienst auszuführen, müssen Sie Microsoft Dynamics 365 Bereitstellungsadministrator sein Weitere Informationen finden Sie unter Einen Bereitstellungsadministrator hinzufügen.

Das folgende Beispiel zeigt, wie die ProxyClientHelper Klasse verwendet wird, um den Bereitstellungsservice mithilfe der Anmeldeinformationen zu authentifizieren.

DeploymentServiceClient service = Microsoft.Xrm.Sdk.Deployment.Proxy.ProxyClientHelper.CreateClient(new Uri("http://MyServerName/XRMDeployment/2011/Deployment.svc"));
RetrieveAllRequest request = new RetrieveAllRequest()
{   
   EntityType = DeploymentEntityType.DefaultOrganization};   
   RetrieveAllResponse response = (RetrieveAllResponse) service.Execute(request);
}

Microsoft Dynamics 365 - Webdienste können von verschiedenen von Clients und Dienstleistungen im Namen eines Microsoft Dynamics 365 Benutzers angefordert werden. Jeder Aufruf muss ein authentifizierter Aufruf sein. Identitätswechsel wird verwendet, um einen Aufruf im Auftrag eines authentifizierten Microsoft Dynamics 365 Benutzers auszuführen. Bei der Verwendung von Identitätswechsel vermeiden Sie Authentifizierung- und Autorisierungsprobleme im Webdiensts (ASP.NET) Code. Stattdessen müssen Sie sich auf Internetinformationsdienste (IIS) verlassen, um den Benutzer zu authentifizieren und dem Webdienst einen Authentifizierung-Token zu übermitteln. Wenn der Benutzer nicht authentifiziert werden kann, gibt IIS einen nicht authentifiziertes Token.

Das folgende Beispiel zeigt, wie der Identitätswechsel mit dem Bereitstellungsdienst verwendet wird.

DeploymentServiceClient service = Microsoft.Xrm.Sdk.Deployment.Proxy.ProxyClientHelper.CreateClient(new Uri("http://myservername/XRMDeployment/2011/Deployment.svc"));
service.ClientCredentials.Windows.ClientCredential = new NetworkCredential("administrator", "myp@ssword!", "myservernamedom");
RetrieveAllRequest request = new RetrieveAllRequest() 
{   
   EntityType = DeploymentEntityType.DefaultOrganization};   
   RetrieveAllResponse response = (RetrieveAllResponse) service.Execute(request);
}

Bereitstellungsdienst-Funktionen

Der Bereitstellungsdienst folgt einem Entwicklungsmodell, ähnlich dem Microsoft Dynamics 365 Hauptwebdienst. Es gibt Entitäten, Nachrichten und Methoden, die Sie verwenden, um mit dem Bereitstellungsservice interagieren zu können. Weitere Informationen zum Microsoft Dynamics 365 Hauptwebdienst finden Sie unter Verwenden Sie Microsoft Dynamics 365-Dienste im Code.

Es gibt zwei Typen für Entitäten den Bereitstellungsservice: Bereitstellungsentitäten und Bereitstellungskonfigurationseinstellungen. Auf beide wird mit der gleichen Methode zugegriffen. Weitere Informationen zu diesen Entitäten finden Sie unter Bereitstellungs-Entitäten und Bereitstellungs-Konfigurationseinstellungen.

Zusätzlich zu den Kernbereitstellungsentitäten hat der Bereitstellungsservice die Möglichkeit, erweiterten Einstellungen zu lesen und zu bearbeiten, die durch Metadaten gesteuert werden. Diese erweiterten Funktionen geben Zugang zu den in der Konfigurationsdatenbank gespeicherten Informationen.

Der Bereitstellungsdienst unterstützt sowohl synchrone wie auch asynchrone Meldungen für die Execute Methode. Weitere Informationen finden Sie unter Bereitstellungswebdienstmeldungen.

In der folgenden Tabelle werden die Methoden aufgeführt, die im Bereitstellungsservice verfügbar sind.

Methodenname

Beschreibung

IDeploymentService.Delete

Löscht einen Datensatz aus einer Bereitstellungsentität.

IDeploymentService.Execute

Führt eine Anforderung für den Bereitstellungsservice aus. Weitere Informationen finden Sie unter Bereitstellungswebdienstmeldungen.

IDeploymentService.Retrieve

Ruft einen Datensatz aus einer Bereitstellungsentität oder eine Konfigurationseinstellungen ab.

IDeploymentService.RetrieveAll

Ruft alle Datensätze für eine Bereitstellungsentität oder eine Konfigurationseinstellungen ab.

IDeploymentService.Update

Aktualisiert einen Datensatz aus einer Bereitstellungsentität oder eine Konfigurationseinstellungen ab.

Siehe auch

IDeploymentService
Microsoft.Xrm.Sdk.Deployment.Proxy
ProxyClientHelper
Verwaltung der Bereitstellung mithilfe des Bereitstellungswebdiensts
Bereitstellungs-Entitäten und Bereitstellungs-Konfigurationseinstellungen
Bereitstellungswebdienstmeldungen

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright