Utiliser les services Web Microsoft Dynamics 365

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Les services Web fournissent des API que vous utilisez lorsque vous écrivez des programmes pour Microsoft Dynamics 365 (Online et local). Cette rubrique présente les services Web disponibles et fournit des informations de base pour les comprendre et les comparer.

Contenu de la rubrique

API Web

Service d’organisation

Service Organization Data

Services Web de découverte

Service Web de déploiement

API Web

L'API Web est une nouveauté de Microsoft Dynamics 365 (Online et local) qui assure la parité avec le service Organization.

Comparé au service Organization le service Web API offre une meilleure compatibilité dans un large éventail de langages de programmation, de plateformes et d'appareils. Le service Web API implémente la version 4 d'OData (Open Data Protocol).OData est une norme OASIS pour générer et utiliser les API RESTful sur des sources de données multiples. Pour en savoir plus, consultez les sites Web du Protocole OData et de la Norme OASIS.

Comme le service Web API repose sur des normes ouvertes, il n'est pas nécessaire d'utiliser des bibliothèques clientes spécifiques à Microsoft Dynamics 365. Vous pouvez choisir de composer des requêtes HTTP pour des opérations spécifiques ou d'utiliser des bibliothèques tierces pour générer des classes pour le langage ou la plateforme de votre choix. Affichez la liste des bibliothèques disponibles.

Par la suite, le service Web API remplacera le service Organization et le service Organization Data, mais ces deux services Web existants seront disponibles pour assurer une transition progressive vers un service Web API unique. Le service Web API doit être votre premier choix de nouveau développement qui prend en charge Microsoft Dynamics 365 et les versions futures de Microsoft Dynamics 365 (Online). Utilisez le service Web API pour les projets qui accèdent aux données Microsoft Dynamics 365 avec du code qui ne s'exécute pas sur le serveur, notamment les XmlHttpRequests des ressources Web et des scripts de formulaire qui s'exécutent dans les clients d'application Microsoft Dynamics 365. Pour le moment, vous ne pouvez pas utiliser facilement le service Web API avec du code qui s'exécute sur le serveur, comme dans les plug-ins ou les assemblys de workflow.

Pour plus d'informations :Utilisez l'API Web Microsoft Dynamics 365.

Service d’organisation

Le service Organization, parfois appelé « point de terminaison SOAP » est disponible depuis Microsoft Dynamics CRM 2011. Il s'agit d'un service Web connu de la plupart des développeurs qui utilisent Microsoft Dynamics 365. Le service Organization est optimisé pour une utilisation avec .NET. Le SDK de Microsoft Dynamics 365 propose un ensemble d'assemblys et d'outils pour vous permettre de générer des classes fortement typées et des proxys qui simplifient le processus de développement et offrent une meilleure expérience de développement avec Microsoft Visual Studio. Si vous êtes un développeur .NET qui n'est pas tenu de prendre en charge d'autres plateformes, il n'est pas nécessaire de passer à l'API Web immédiatement. Vous devez utiliser le service Organization pour prendre en charge les fonctionnalités que vous souhaitez déployer sur les organisations qui utilisent des versions de Microsoft Dynamics 365 antérieures à Microsoft Dynamics 365.

La logique métier qui s'exécute dans les plug-ins ou les assemblys de workflow du serveur doit utiliser le service Organization. Les paramètres d'entrée et de sortie utilisent des classes spécifiques définies avec les assemblys qui prennent en charge le service Organization.

Pour plus d'informations :Utiliser le service d’organisation Microsoft Dynamics 365

Service Organization Data

Le service Organization Data, parfois appelé « point de terminaison OData » ou « REST » est également disponible depuis Microsoft Dynamics CRM 2011. Ce service a implémenté la version 2 de la norme OData. Même si ce service restera disponible tel quel dans les années à venir, nous vous déconseillons de l'utiliser avec Microsoft Dynamics 365. Le service Organization Data a toujours été limité à l'exécution d'opérations de création, de lecture, de mise à jour et de suppression et n'a jamais pris en charge la possibilité d'appeler des messages spécialisés utilisés dans le service Organization. Il ne pourra donc jamais atteindre la parité avec la fonctionnalité du service Organization. Les modifications implémentées dans les normes OData entre les versions 2 et 4 ne permettent pas de mettre à niveau le service pour répondre aux besoins d'un service en parité avec le service Organization. Nous avons pu appliquer la plupart des commentaires que nous avons reçus sur le service Organization Data afin d'améliorer l'API Web.

Cette version du SDK de Microsoft Dynamics 365 ne contient pas d'informations sur le service Organization Data. Vous trouverez des informations sur le service Organization Data dans la documentation de la version Microsoft Dynamics CRM 2015, à la rubrique Utiliser le point de terminaison OData avec des ressources Web.

Services Web de découverte

Microsoft Dynamics 365 est une application à plusieurs utilisateurs. Cela signifie qu'un seul déploiement peut héberger plusieurs instances de Dynamics 365, chacune avec ses propres données et chacune disponible via une URL différente. En outre, en particulier lorsque les serveurs Microsoft Dynamics 365 sont hébergés dans un centre de données, le serveur spécifique peut être modifié lorsque les ressources sont déplacées ou équilibrées en charge. Les services Web de découverte permettent à un client de détecter les serveurs et les organisations auxquels un utilisateur peut se connecter selon son compte d'utilisateur. Vous pouvez choisir d'utiliser le service Web API Discovery ou le service Web IDiscoveryService. Le service Web API Discovery offre les mêmes avantages que le service Web API. Il est plus facile à utiliser pour un large éventail de langages de programmation, de plateformes et d'appareils.

Pour plus d'informations :Découvrir l'URL de votre organisation à l'aide de l'API Web ou Découvrir l'URL de votre organisation à l'aide du service d'organisation

Service Web de déploiement

Pour Dynamics 365 (local), vous pouvez effectuer des actions pour gérer votre déploiement par programme à l'aide du service Web de déploiement. Ce sont essentiellement les mêmes opérations que celles que vous pouvez effectuer sur le serveur à l'aide de l'outil Gestionnaire de déploiement installé sur le serveur. Vous pouvez créer, importer ou supprimer des organisations, et aussi appliquer certains paramètres dans le code. Cela peut être utile lorsque vous voulez automatiser certains processus si vous fournissez un service d'hébergement ou si vous voulez automatiser la création d'environnements de test.

Pour plus d'informations :Introduction au service Web de déploiement.

Voir aussi

Connexion à Microsoft Dynamics 365
Authentifier les utilisateurs dans Microsoft Dynamics 365
Use Microsoft Dynamics 365 web services
Créer des applications clientes Windows à l’aide des outils XRM
Écrire des applications mobiles et modernes

Microsoft Dynamics 365

© 2017 Microsoft. Tous droits réservés. Copyright