Inleiding tot de installatiewebservice
Gepubliceerd: januari 2017
Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Met de implementatieservice kunt u oplossingen maken om te profiteren van de ondersteuning voor meerdere organisaties. Dit wordt ook wel multitenant-ondersteuning genoemd. Met Microsoft Dynamics 365 kunt u meerdere klantorganisaties binnen één implementatie hosten. Deze mogelijkheid is ideaal voor gehoste oplossingen of bedrijven die een scheiding van gegevens in de organisatie vereisen. Aangezien het gebruik van de configuratieservice toegang tot de Dynamics 365-server vereist, kan deze alleen voor on-premises implementaties van Microsoft Dynamics 365 worden gebruikt.
Met ondersteuning voor meerdere organisaties ondersteunen de webtoepassing en webservices van Microsoft Dynamics 365 het opslaan en ophalen van gegevens van meerdere bedrijfsorganisaties terwijl de beveiliging en privacy van elke afzonderlijke organisatie behouden blijft. De metagegevens en locatie-informatie voor alle klantorganisaties worden in een enkele Microsoft Dynamics 365-configuratiedatabase opgeslagen. Elke klantorganisatie heeft echter zijn eigen database op een server met Microsoft SQL Server. Voor meer informatie over de entiteiten en de configuratie-instellingen die worden gecontroleerd door de configuratieservice, raadpleegt u Installatie-entiteiten en installatieconfiguratie-instellingen.
Microsoft Dynamics 365 biedt geen ondersteuning voor een achterwaarts compatibel eindpunt voor de configuratieservice, dus moet alle code die is geschreven voor de Microsoft Dynamics CRM 4.0-configuratieservice worden bijgewerkt en opnieuw gecompileerd met de nieuwe assembly.
De configuratieservice toevoegen aan uw project
U kunt de configuratieservice gebruiken door een verwijzing naar de assembly Microsoft.Xrm.Sdk.Deployment.dll toe te voegen, die u in de map SDK\bin kunt vinden. U kunt ook de volgende servicereferentie aan uw oplossing toevoegen.
http://myservername/xrmdeployment/2011/deployment.svc
svcutil.exe http:// myservername/XRMDeployment/2011/Deployment.svc?wsdl
Hiermee worden een configuratiebestand en een codebestand gegenereerd die de clientklasse bevatten. Voeg deze twee bestanden toe aan uw clienttoepassing en gebruik de gegenereerde clientklasse om de service aan te roepen.
Installatie van configuratieservice
Om aanroepen van Microsoft Dynamics 365-implementatie-entiteiten uit te voeren, moet de serverfunctie voor de configuratieservice correct worden geïnstalleerd op een Microsoft Dynamics 365-server. Zorg dat aan de volgende criteria in uw installatie van de configuratieservice wordt voldaan:
Als u organisatiebewerkingen wilt gebruiken, zoals maken of bijwerken, moet u de serverfunctie voor de configuratieservice installeren via een domeingebruiker. De domeingebruikersaccount moet lokale beheer- en systeembeheerrechten hebben op de SQL Server waarop de organisatiedatabases worden gehost.
De configuratieservice moet worden uitgevoerd met een andere service-identiteit dan de andere Microsoft Dynamics 365-services en de toepassingsserver. Als u Netwerkservice gebruikt, moet de serverfunctie op een afzonderlijke server worden geïnstalleerd zonder een andere Microsoft Dynamics 365-serverfunctie. Als de serverfunctie van de configuratieservice naast andere serverfuncties wordt geïnstalleerd, kan dit tot beveiligingsrisico's leiden omdat met beide servers worden uitgevoerd onder het Netwerkserviceaccount. Als u het Netwerkserviceaccount gebruikt, kunt u geen organisatiebewerkingen uitvoeren met Windows PowerShell of de installatiewebservice.
Voor meer informatie over de installatie van de implementatieserver raadpleegt u de Microsoft Dynamics CRM-serverrollen.
Microsoft Dynamics 365 bevat twee primaire servercomponenten: de Microsoft Dynamics 365-toepassingsserver en de Microsoft Dynamics 365-server. Elk bevat een afzonderlijke groep serverfuncties die worden geïnstalleerd bij de uitvoering van Setup. De rol van de configuratieservice wordt automatisch geïnstalleerd als de Wizard Setup wordt gebruikt voor het installeren van de Microsoft Dynamics 365-platformserver.
Verificatie en imitatie van de configuratieservice
Verificatie van de configuratieservice wordt afgehandeld via Active Directory, dat ook wel Geïntegreerde Windows-verificatie wordt genoemd. U kunt tevens gebruikmaken van imitatie, waarmee u webservicemethoden kunt aanroepen namens een andere geverifieerde gebruiker om een gewenste functies of service te leveren. Als u de installatiewebservice wilt aanroepen, moet u een Microsoft Dynamics 365-installatiebeheerder zijn. Voor meer informatie raadpleegt u Een installatiebeheerder toevoegen.
Het volgende voorbeeld laat zien hoe u de klasse ProxyClientHelper kunt gebruiken om de configuratieservice te verifiëren en gebruiken met standaardreferenties.
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-webservices kunnen worden aangeroepen met behulp van clients en services uit naam van een Microsoft Dynamics 365-gebruiker. Elke aanroep moet een geverifieerde aanroep zijn. Imitatie wordt gebruikt om een aanroep uit te voeren namens een geverifieerde Microsoft Dynamics 365-gebruiker. Bij gebruik van imitatie vermijdt u verificatie- en autorisatieproblemen in de webservicecode (ASP.NET). In plaats hiervan vertrouwt u op Internet Information Services (IIS) om de gebruiker te verifiëren en een geverifieerd token door te geven aan de webservice. Als de gebruiker niet kan worden geverifieerd, geeft IIS een niet-geverifieerd token door.
In het volgende voorbeeld wordt weergegeven hoe imitatie kan worden gebruikt met de configuratieservice.
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);
}
Mogelijkheden van configuratieservice
De configuratieservice volgt een ontwikkelingsmodel dat lijkt op de primaire Microsoft Dynamics 365-webservice. Er zijn entiteiten, methoden en berichten die u gebruikt om te communiceren met de configuratieservice. Voor meer informatie over de primaire Microsoft Dynamics 365-webservice raadpleegt u Microsoft Dynamics 365-services gebruiken in code.
Er zijn twee typen entiteiten voor de configuratieservice: installatie-entiteiten en installatieconfiguratie-instellingen. Beide zijn toegankelijk via dezelfde verzameling van methoden. Raadpleeg Installatie-entiteiten en installatieconfiguratie-instellingen voor meer informatie over deze entiteiten.
Naast de standaardinstallatie-entiteiten, biedt de configuratieservice de mogelijkheid om geavanceerde instellingen te lezen en te bewerken via aansturing door metagegevens. Deze geavanceerde instellingen bieden toegang tot informatie die is opgeslagen in de configuratiedatabase.
De configuratieservice ondersteunt zowel synchrone als asynchrone berichten voor de methode Execute. Zie Implementatieberichten van webservice voor meer informatie.
De volgende tabel bevat de methoden die beschikbaar zijn in de configuratieservice.
Methodenaam |
Beschrijving |
---|---|
Verwijdert een record uit een installatie-entiteit. |
|
Voert een aanvraag uit voor de configuratieservice. Zie Implementatieberichten van webservice voor meer informatie. |
|
Haalt een record van een installatie-entiteit of installatieconfiguratie-instellingen op. |
|
Haalt alle records op voor een installatie-entiteit of installatieconfiguratie-instellingen. |
|
Werkt een record van een installatie-entiteit of installatieconfiguratie-instellingen bij. |
Zie ook
IDeploymentService
Microsoft.Xrm.Sdk.Deployment.Proxy
ProxyClientHelper
De installatie beheren met de installatiewebservice
Installatie-entiteiten en installatieconfiguratie-instellingen
Implementatieberichten van webservice
Microsoft Dynamics 365
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht