Utiliser les services web Dynamics 365 Customer Engagement (on-premises)

Les services web fournissent des API que vous utilisez lorsque vous écrivez des programmes pour Dynamics 365 Customer Engagement (on-premises). Cette rubrique présente les services web disponibles et fournit des informations de base pour les comprendre et les comparer.

API web

L’API web est une nouveauté de la version 8.0 et a été mise à jour régulièrement pour assurer la parité avec le service d’organisation. Avec cette version, la parité est atteinte.

Comparé au service d’organisation, l’API web offre une meilleure compatibilité avec un large éventail de langages de programmation, de plateformes et d’appareils. L’API web implémente OData (protocole ouvert de données) v4. OData est une norme OASIS pour générer et consommer des 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 l’API web repose sur des normes ouvertes, il n’est pas nécessaire d’utiliser des bibliothèques clientes spécifiques à Dynamics 365 Customer Engagement (on-premises). 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, l’API WEB remplacera le service d’organisation et le service d’organisation des données, mais ces deux services web existants seront disponibles pour assurer une transition progressive vers un API web unique. L’API web doit être votre premier choix de nouveau développement qui prend en charge Dynamics 365 Customer Engagement (on-premises) et les versions futures de Dynamics 365 Customer Engagement (on-premises). Utilisez l’API web pour les projets qui accèdent aux données Dynamics 365 Customer Engagement (on-premises) avec du code qui ne s’exécute pas sur le serveur, notamment les demandes des ressources web et des scripts de formulaire qui s’exécutent dans les clients d’application Dynamics 365 Customer Engagement (on-premises). Pour le moment, vous ne pouvez pas utiliser facilement l’API web avec du code qui s’exécute sur le serveur, comme dans les plug-ins ou les assemblys de workflow. Vous devriez continuer d’utiliser le service d’organisation à ces fins.

Pour plus d’informations : Utilisez l’API Dynamics 365 Customer Engagement avec l’API Web.

Service d’organisation

Le service d’organisation est disponible depuis Dynamics CRM 2011. Il s’agit d’un service web connu de la plupart des développeurs qui utilisent Dynamics 365 Customer Engagement (on-premises). Le service d’organisation est optimisé pour une utilisation avec .NET. Il existe un ensemble d’assemblys .NET 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 Visual Studio.

Les assemblies du kit SDK pour .NET qui permettent d’accéder au service Organisation utilisent actuellement le point de terminaison SOAP 2011 qui a été rendu obsolète. Les assemblys du SDK seront par la suite migrés pour utiliser en interne l’API web à la place du point de terminaison SOAP 2011. Dans ce cas, les codes écrits à l’aide des assemblies du SDK continueront à être pris en charge, car ils utiliseront automatiquement les appels API Web à la place du point de terminaison SOAP 2011. Cette mise à jour sera principalement transparente pour vous, ne nécessitant seulement de votre part que vous remplaciez les assemblys du SDK du dossier d’exécution de votre application par les assemblys révisés. Pour plus de détails et de nouvelles informations sur le développement .NET Core, consultez Transition des applications vers Dataverse ServiceClient.

Voir Choisir votre style de développement pour obtenir des conseils sur l’utilisation du service d’organisation ou de l’API web.

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 pouvez toujours utiliser le service d’organisation pour prendre en charge les fonctionnalités que vous souhaitez déployer sur les organisations qui utilisent des versions de Dynamics 365 Customer Engagement (on-premises) antérieures à la mise à disposition de l’API web.

La logique métier qui s’exécute dans les plug-ins ou les assemblys de workflow du serveur doit utiliser le service d’organisation. 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 d’organisation.

Pour plus d’informations : Utiliser le service d’organisation Dynamics 365 Customer Engagement (on-premises)

Service Organization Data

Le service d’organisation des données, parfois appelé « point de terminaison OData ou REST » est également disponible depuis 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 dans Dynamics 365 Customer Engagement (on-premises). Le service d’organisation des données 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 d’organisation. Il ne pourra donc jamais atteindre la parité avec la fonctionnalité du service d’organisation. 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 des services web Dynamics 365 Customer Engagement ne contient pas d’informations sur le service Organization Data. Vous trouverez des informations sur le service d’organisation des données dans la documentation de la version Dynamics CRM 2015 à la rubrique Utiliser le point de terminaison OData avec des ressources web.

Services web de découverte

Dynamics 365 Customer Engagement (on-premises) est une application à plusieurs utilisateurs. Cela signifie qu’un seul déploiement peut héberger plusieurs instances de Customer Engagement (on-premises), chacune avec ses propres données et chacune disponible via une URL différente. En outre, en particulier lorsque les serveurs Dynamics 365 Server 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 l’API Web basée sur OData V4 ou l’API d’assemblage du kit SDK pour accéder au service Web de découverte. Bien que les deux API offrent des fonctionnalités similaires, l’API Web est plus facile à utiliser pour un plus grand nombre de langages de programmation, de plateformes et de d’appareils.

En savoir plus : Découvrir l’URL de votre organisation à l’aide de l’API web ou Découvrir l’URL de votre organisation avec le service web IDiscoveryService

Service web de déploiement

Pour Dynamics 365 Customer Engagement (on-premises), 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.

Voir aussi

Authentifier les utilisateurs dans Dynamics 365 Customer Engagement
Authentifier les utilisateurs sur Dynamics 365 Customer Engagement (on-premises)
Utiliser les services web Dynamics 365 Customer Engagement
Créer des applications clientes Windows à l’aide des outils XRM
Guide du développeur des applications basées sur un modèle