Microsoft Dynamics 365-webservices gebruiken
Gepubliceerd: januari 2017
Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Webservices bieden API's waarvan u gebruik kunt maken wanneer u software voor Microsoft Dynamics 365 (online en on-premises) schrijft. Dit onderwerp beschrijft beschikbare webservices en biedt basisinformatie om deze te kunnen begrijpen en te vergelijken.
In dit onderwerp
Web-API
Organisatieservice
Organisatiegegevensservice
Discovery-webservices
Implementatiewebservice
Web-API
De web-API is nieuw voor Microsoft Dynamics 365 (online en on-premises) en is gelijkwaardig aan de bestaande Organization-service.
Notitie
Voor deze eerste versie moeten enkele kwesties worden opgelost om deze gelijkwaardigheid te bereiken. Raadpleeg Beperkingen van Web-API van Microsoft Dynamics 365 voor meer informatie over openstaande problemen.
In vergelijking met de Organization-service biedt Web API betere compatibiliteit voor een groot aantal programmeertalen, platforms en apparaten. De Web API implementeert de OData (Open Data Protocol) v4.OData is een OASIS-standaard voor het samenstellen en gebruiken van RESTful-API's via uitgebreide gegevensbronnen. Meer informatie over dit onderwerp vindt u op de websites OData protocol en OASIS standard.
Omdat Web API is gebaseerd op open standaarden, hoeft u geen clientbibliotheken te gebruiken die specifiek zijn voor Microsoft Dynamics 365. U kunt ervoor kiezen om HTTP-aanvragen voor specifieke bewerkingen samen te stellen, of bibliotheken van derden te gebruiken om klassen te genereren voor alle talen of platforms die u wilt gebruiken. Bekijk een lijst van beschikbare bibliotheken.
Uiteindelijk zal Web API de Organization-service en de Organization Data-service vervangen. Beide bestaande webservices blijven echter beschikbaar om een stapsgewijze overgang naar een enkele Web API mogelijk te maken. De Web API dient uw eerste keuze te zijn voor nieuw ontwikkelwerk dat Microsoft Dynamics 365 en toekomstige versies van Microsoft Dynamics 365 (online) ondersteunt. Gebruik de Web API voor alle projecten die toegang hebben tot Microsoft Dynamics 365-gegevens via code die niet op de server wordt uitgevoerd, inclusief XmlHttpRequests vanuit webresources en formulierscripts die worden uitgevoerd in Microsoft Dynamics 365-toepassingsclients. Op dit moment is het niet eenvoudig om de Web API te gebruiken voor code die op de server wordt uitgevoerd, zoals invoegtoepassingen of workflow-assembly's.
Meer informatie:De web-API van Microsoft Dynamics 365 gebruiken.
Organisatieservice
De Organization-service, die ook wel het "SOAP-eindpunt" wordt genoemd, is beschikbaar sinds Microsoft Dynamics CRM 2011. Dit is een bekende webservice voor de meeste ontwikkelaars die werken met Microsoft Dynamics 365. De Organization-service is geoptimaliseerd voor gebruik met .NET. De Microsoft Dynamics 365 SDK bevat een reeks assembly's en hulpmiddelen, waarmee u sterk getypte klassen en proxyservers kunt maken die het ontwikkelingsproces stroomlijnen en waarmee u kunt profiteren van een betere ontwikkelervaring met Microsoft Visual Studio. Als u een .NET-ontwikkelaar bent die geen andere platforms moet ondersteunen, hoeft u niet meteen op de web-API over te stappen. U moet de Organization-service gebruiken om alle functionaliteit te ondersteunen die u wilt implementeren voor organisaties die werken met versies van Microsoft Dynamics 365 die zijn uitgebracht vóór Microsoft Dynamics 365.
Bedrijfslogica die wordt uitgevoerd in invoegtoepassingen of workflow-assembly's op de server, gaan er vanuit dat de Organization-service beschikbaar is voor gebruik. De invoer- en uitvoerparameters gebruiken specifieke klassen die zijn gedefinieerd met de assembly's die de Organization-service ondersteunen.
Meer informatie:De Microsoft Dynamics 365 Organisatieservice gebruiken
Organisatiegegevensservice
De Organization Data-service, die ook wel wordt aangeduid als het "OData"- of "REST"-eindpunt, is ook al beschikbaar sinds Microsoft Dynamics CRM 2011. Deze service implementeerde de standaard van OData v2. Hoewel deze service 'as-is' beschikbaar blijft gedurende de komende jaren, schaffen we hem toch af met Microsoft Dynamics 365. De Organization Data-service was altijd beperkt tot het uitvoeren bewerkingen voor maken, lezen, bijwerken en verwijderen en bood geen ondersteuning voor het aanroepen van gespecialiseerde berichten die in de Organization-service worden gebruikt. Dit betekende dat hij nooit gelijkwaardig kon zijn met de functionaliteit van de Organisatieservice. Wijzigingen die in de OData-standaarden werden ingevoerd tussen de versies v2 en v4, maken het onmogelijk om de service te upgraden zodat hij voldoet aan de vereisten voor een service die gelijkwaardig is aan de Organisatieservices. We hebben veel feedback op de Organisatiegegevensservice ontvangen en konden veel daarvan op toepassen om de web-API beter te maken.
Deze versie van de Microsoft Dynamics 365 SDK bevat geen informatie over de Organisatiegegevensservice. Informatie over de Organisatiegegevensservice vindt u in de documentatie voor de Microsoft Dynamics CRM 2015-release op Het OData-eindpunt gebruiken met webresources.
Discovery-webservices
Microsoft Dynamics 365 is een multitenant-toepassing. Dit betekent dat een enkele implementatie meerdere exemplaren van Dynamics 365 kan hosten, elk met eigen gegevens en beschikbaar via een andere URL. Ook kan de betreffende server, met name als Microsoft Dynamics 365-servers worden gehost in een datacenter, worden aangepast door het verplaatsen van resources of load-balancing. Discovery-webservices bieden een manier waarmee een client kan detecteren welke servers en organisaties beschikbaar zijn voor gebruiker om verbinding mee te maken, op basis van hun gebruikersaccount. U kunt ervoor kiezen om de Web API Discovery-webservice of de IDiscoveryService-webservice te gebruiken. De Web API Discovery-service biedt dezelfde voordelen als de Web API en is gemakkelijker inzetbaar voor een groter assortiment programmeertalen platforms en apparaten.
Meer informatie:Bepaal de URL voor uw organisatie met de Web-API of Bepaal de URL voor uw organisatie met de organisatieservice
Implementatiewebservice
Voor Dynamics 365 (on-premises) kunt u acties verrichten om uw implementatie programmatisch te beheren door middel van de Implementatiewebservice. Dit zijn feitelijk dezelfde bewerkingen die u kunt uitvoeren op de server met de client voor de tool Configuratiebeheer, die is geïnstalleerd op de server. Kunt u organisaties maken, importeren of verwijderen en bepaalde instellingen in code toepassen. Dit kan handig zijn als u bepaalde processen wilt automatiseren, wanneer u een hostingservice levert of als u het aanmaken van omgevingen voor testen wilt automatiseren.
Meer informatie:Inleiding tot de installatiewebservice.
Zie ook
Verbinding maken met Microsoft Dynamics 365
Gebruikers authenticeren in Microsoft Dynamics 365
Use Microsoft Dynamics 365 web services
Windows clienttoepassingen maken met de XRM-hulpprogramma's
Mobiele en moderne apps schrijven
Microsoft Dynamics 365
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht