Modèles de programmation pour Dynamics 365 Customer Engagement (on-premises)

Microsoft Dynamics 365 Customer Engagement (on-premises) offre plusieurs modèles de programmation conçus pour vous offrir la flexibilité nécessaire pour choisir la solution la mieux adaptée à vos besoins.

Le diagramme suivant illustre les principaux scénarios de programmabilité pour Dynamics 365 Customer Engagement (on-premises). Utilisez les modèles de programmation appropriés Dynamics 365 Customer Engagement (on-premises) pour les types de solutions que vous créez.

Connexion à Dynamics 365 Customer Engagement (on-premises)

Lorsque vous entrez des clients pour accéder aux données dans Dynamics 365 Customer Engagement (on-premises) deux options s’offrent à vous : vous pouvez utiliser l’API web ou le service d’organisation.

API Web

L’API web a été introduite dans la mise à jour de décembre 2016 pour Dynamics 365 (en ligne et local) et fournit une expérience de développement pouvant être utilisé avec une grande variété de langues, de plateformes et d’appareils de programmation. 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.

Lorsque vous utilisez l’API web, vous pouvez sélectionner une liste des bibliothèques communautaires qui prennent en charge la norme OData v4. Vous avez également la possibilité d’écrire du code en utilisant directement HTTP. Pour plus d’informations : Utilisez l’API Dynamics 365 Customer Engagement avec l’API Web

Lorsque vous vous connectez à des environnements locaux Dynamics 365 for Customer Engagement (on-premises) avec déploiement avec accès via Internet (IFD), utilisez une Bibliothèque d’authentification Azure AD (ADAL) pour activer l’authentification à partir d’une grande variété de langues et de plateformes de programmation. Pour plus d’informations : Authentification Dynamics 365 Customer Engagement (on-premises) avec l’API web

Note

La bibliothèque Azure ADAL est obsolète. Utilisez la Bibliothèque d’authentification Microsoft (MSAL) à la place.

Le service de données d’organisation (ou le point de terminaison REST ou OData) est un service OData v2 qui est déconseillé dans la mise à jour de décembre 2016 pour Dynamics 365 (en ligne et local) au profit de l’API Web. Le service de données d’organisation n’est pas inclus dans le schéma précédent. Le service d’organisation est toujours disponible pour prendre en charge du code qui l’utilisait. Toutefois, pour tout nouveau développement pour Dynamics 365 Customer Engagement (on-premises), nous recommandons d’utiliser l’API web. En savoir plus : Utiliser le point de terminaison OData avec les ressources web

Service d’organisation

Si vous êtes un développeur .NET, utilisez l’API web ou le service d’organisation. Avec le service d’organisation vous pouvez utiliser un ensemble d’assemblys et d’outils pour générer des classes fortement typées et des attributs ayant été ajoutés à une instance de Dynamics 365 Customer Engagement (on-premises).

Avec les assemblys et les outils SDK pour la génération de code, vous pouvez également inclure OrganizationServiceContext, qui est basé sur le même concept que DataServiceContext dans les services de données Windows Communication Foundation (WCF). Cette classe vous permet d’effectuer le suivi des modifications, de gérer des identités et des relations, et vous donne accès au fournisseur LINQ de Dynamics 365 Customer Engagement (on-premises) de manière à générer des requêtes à l’aide de LINQ. Lorsque vous utilisez des outils pour la génération de code, vous obtenez des classes fortement typées pour des entités et des attributs qui sont définis lorsque l’outil de génération de code est exécuté. Il s’agit de classes à liaison anticipée. Plus d’informations : Utiliser les classes d’entité à liaison anticipée dans le code

Lorsque votre code doit fonctionner avec des entités et des attributs qui n’étaient pas connus lorsque que les outils de génération de code ont été exécutés, utilisez une classe Entity qui permet de spécifier les entités et les attributs d’entité dans votre code. Ce style à liaison tardive d’écriture de code fournit une plus grande souplesse mais ne permet pas de contrôle de la compilation de tous les types afin qu’aucun casts implicites ne survienne. La liaison tardive ne contrôle les types que lorsque l’objet est créé ou qu’une action est exécutée sur le type. La classe Entité nécessite que les types soient explicitement spécifiés pour empêcher les casts implicites. Plus d’informations : Utiliser la classe d’entité à liaison tardive dans le code

Si vous créez un client Windows ou utilisez Windows PowerShell, Xrm.Tooling fournit un ensemble d’API qui utilisent les assemblys du Kit SDK pour fournir des fonctionnalités supplémentaires et des ressources spécifiques au développement client Windows. Plus d’informations : Créer des applications clientes Windows à l’aide des outils XRM

Extension au serveur

Vous pouvez écrire du code qui écoute les évènements et applique une logique métier personnalisée pour modifier ou améliorer le comportement standard de la plateforme. Ce code est uniquement disponible pour être écrit en utilisant le code géré par .NET et l’expérience développeur repose sur les mêmes objets définis dans les assemblys du Kit SDK. Vous pouvez utiliser le service de l’organisation pour exécuter des opérations avec les données Dynamics 365 Customer Engagement (on-premises). Pour plus d’informations : Écrire des plug-ins pour développer les processus d’entreprise.

Vous pouvez également créer des processus personnalisés selon le modèle de programmation Windows Workflow Foundation. Vous pouvez créer différents types de processus. Le plus souvent, vous utiliserez le concepteur de workflow. Mais lorsqu’il existe certaines fonctionnalité que vous ne pouvez pas réaliser dans le concepteur, vous pouvez définir des processus à l’aide du code. Pour plus d’informations : Écrire des workflows pour automatiser les processus d’entreprise

Extension dans l’application

Chacune des applications clientes fournies par Dynamics 365 Customer Engagement (on-premises) inclut la possibilité de définir des personnalisations et de les déployer sur plusieurs types de clients. L’application web, Dynamics 365 for Outlook, Dynamics 365 pour tablettes et Dynamics 365 pour téléphones fournissent chacune des fonctionnalités pour inclure des options de navigation et de commande personnalisées ainsi que le modèle d’objet Xrm et les fonctions Xrm.Utility que vous pouvez utiliser avec JavaScript pour apporter des expériences sensibles au client. Les bibliothèques JavaScript, les pages HTML, les images et les autres types de fichiers qui peuvent être utilisés ou affichés dans le client sont disponibles comme des ressources web accessibles URL. En savoir plus : Utiliser JavaScript avec les applications Customer Engagement et Ressources web pour Dynamics 365 Customer Engagement (on-premises).

Lorsque vous devez accéder à des données de Dynamics 365 Customer Engagement (on-premises) qui ne sont pas disponibles dans le contexte où votre code JavaScript est exécuté, vous pouvez effectuer des appels au serveur pour obtenir les données dont vous avez besoin. Le service de l’organisation peut être utilisé, mais il est plus facile d’utiliser l’API web avec JSON plutôt que XML requis par le service de l’organisation. Comme votre script s’exécute dans le contexte de l’application, vous êtes automatiquement authentifié. En savoir plus : Mise en route de l’API Web Dynamics 365 Customer Engagement (Javascript côté client)

Voir aussi

Guide du développeur pour Dynamics 365 Customer Engagement (on-premises)
Pour commencer
Didacticiels et ressources
Conseils
Outils de développement