Choisir votre style de développement pour Dynamics 365 Customer Engagement (on-premises)

  • Article

Le SDK propose diverses méthodes et technologies à utiliser lorsque vous écrivez du code pour accéder aux services web Dynamics 365 for Customer Engagement ou étendre l’application. Cette rubrique fournit des instructions sur le style de développement à choisir selon votre domaine technologique.

Développement .NET et non-.NET

Lorsque vous écrivez du code pour étendre Dynamics 365 Customer Engagement (on-premises), vous devez d’abord vérifier si votre code est écrit à l’aide de .NET Framework.

Développement .NET : utiliser les assemblys SDK

Les assemblys du SDK fournissent des classes que vous pouvez utiliser pour vous connecter aux services web Dynamics 365 Customer Engagement (on-premises) pour identifier votre organisation et exécuter des opérations courantes comme la création, la récupération, la mise à jour et la suppression de données dans Dynamics 365 Customer Engagement (on-premises). Les assemblys du SDK sont disponibles en tant que packages NuGet. Plus d’informations : S’abonner aux mises à jour des assemblys SDK avec NuGet.

Important

Vous devez utiliser la dernière version des assemblys du SDK pour créer vos plug-ins, activités de workflow personnalisées ou de workflows XAML. Si vous démarrez par la version 9.x, utilisez la version 4.6.2 de .NET Framework.

Toutefois, si vous utilisez le .NET Framework 4 et la classe CrmConnection des extensions du SDK (déconseillées) pour vous connecter à Dynamics CRM 2016 Service Pack 1 Local (local) et CRM Online 2016 Update 1 (version 8.1.0) ou ultérieure, vous devez utiliser la version 6.1.2 des assemblys. Sinon, vous ne pourrez pas vous connecter. Pour plus d’informations sur la compatibilité ascendante, voir Blog : Compatibilité ascendante du Kit de développement logiciel (SDK) de Dynamics 365 Customer Engagement (on-premises)

Lorsque vous utilisez les assemblys du SDK pour écrire du code, vous utilisez le service Web d'organisation pour vous connecter à une instance de Dynamics 365 Customer Engagement (on-premises) et exécuter les opérations de service web prises en charge. Pour plus d’informations : Utilisez le service d’organisation Dynamics 365 Customer Engagement

Note

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 obsolète. Dans ce cas, les codes écrits à l’aide des assemblys du SDK continueront à être pris en charge, car ils utiliseront automatiquement l’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.

  • Créer et déployer des plug-ins ou des activités de workflow personnalisées : les classes de plug-ins et d’activités de workflow personnalisées vous permettent de créer des gestionnaires d’événements pour exécuter une logique métier personnalisée que vous pouvez intégrer à Dynamics 365 Customer Engagement (on-premises) pour modifier ou améliorer le comportement standard de la plateforme.

    Si vous écrivez entièrement des plug-ins et des activités de workflow personnalisées, vous devez utiliser l’outil Plug-in Registration (Inscription de plug-in) pour les inscrire. Cet outil fournit une interface graphique et prend en charge l’inscription des plug-ins et des activités de workflow personnalisées avec Dynamics 365 Customer Engagement (on-premises). Autres informations : Développement de plug-in et Activités de workflow personnalisées (assemblys de workflow)

  • Créer et déployer des workflows XAML personnalisés : Dynamics 365 Customer Engagement (on-premises) et IFD prend en charge la création de workflows XAML personnalisés. Le concepteur de workflow Microsoft Visual Studio vous permet de créer des workflows XAML personnalisés, également appelés workflows déclaratifs, en faisant glisser les activités de workflow de la boîte à outils vers la surface de conception, en créant des variables et en définissant les propriétés de ces activités pour implémenter la fonctionnalité du workflow. Vous pouvez utiliser les activités Windows Workflow Foundation intégrées ou les activités de processus spécifiques à Dynamics 365 Customer Engagement (on-premises). Plus d’informations : Workflows XAML

 

  • Modèles de programmation à liaison anticipée et tardive pour les entités Dynamics 365 Customer Engagement (on-premises) : lorsque vous utilisez les assemblys du SDK, vous pouvez choisir entre deux modèles de programmation :

    Liaison anticipée Liaison tardive
    Utilisez l’outil de génération de code (CrmSvcUtil) pour créer des classes d’entité à liaison anticipée, dérivées de la classe Entity, qui vous permet d’accéder aux données commerciales dans Dynamics 365 Customer Engagement. Ces classes incluent une classe pour chaque entité dans votre installation, y compris les entités personnalisées. Plus d’informations : Utiliser les classes d’entité à liaison anticipée dans le code La classe Entity contient le nom logique d’une entité et un tableau conteneur des propriétés des attributs de l’entité. Cela vous permet d’utiliser la liaison tardive pour utiliser des types tels que les entités et attributs personnalisés qui n’étaient pas présents lors de la compilation de votre application. Plus d’informations : Utiliser les classes d’entité à liaison tardive dans le code

  • Interroger les données dans Dynamics 365 Customer Engagement (on-premises) : Il existe trois façons de récupérer ou d’interroger les données dans Dynamics 365 Customer Engagement (on-premises) à l’aide des assemblys SDK : FetchXML, QueryExpression et .NET LINQ. Plus d’informations : Extraire les données avec des requêtes à l’aide des assemblys du SDK

Développement .NET : utiliser les assemblys des outils XRM

Les assemblys des outils XRM utilisent les API d’assembly du Kit de développement logiciel (SDK) de (service d’organisation et service IDiscoveryService) pour fournir la prise en charge facile de l’authentification avec moins de lignes de code et via les applets de commande Windows PowerShell. Tous les appels de fonction dans ces classes assurent la cohérence de thread pour les actions exécutées dans les applications Customer Engagement dans un environnement multithread. Les outils XRM fournissent un contrôle de connexion commun avec une logique d’authentification intégrée et la possibilité de stocker et de réutiliser les informations d’authentification pour fournir une expérience de connexion cohérente et transparente aux applications Customer Engagement à partir de vos applications clientes Windows. Plus d’informations : Créer des applications clientes Windows à l’aide des outils XRM

Les assemblys des outils XRM sont disponibles en tant que packages NuGet ; les packages sont accessibles sous le profil crmsdk. Sélectionnez dans la liste un package portant le nom « Outils Xrm » pour accéder à la page des détails du package.

Avec la prise en charge de la chaîne de connexion disponible dans les outils XRM et l’obsolescence des extensions Kit de développement logiciel (SDK) pour Customer Engagement, vous devez utiliser les assemblys des outils XRM à la place de la classe CrmConnection pour vous connecter à Dynamics 365 Customer Engagement (on-premises). En savoir plus : Utiliser les chaînes de connexion des outils XRM pour vous connecter à Dynamics 365 Customer Engagement (on-premises) et Exemple : démarrage rapide de la connexion simplifiée dans Dynamics 365 Customer Engagement (on-premises)

Choisir le mode de connexion à Dynamics 365 Customer Engagement (on-premises)

Selon votre style de développement (non-.NET et .NET), vous choisissez comment votre code authentifie les utilisateurs dans Dynamics 365 Customer Engagement (on-premises). Le tableau suivant fournit de brèves informations sur le modèle d’authentification à utiliser en fonction de votre style de développement :

Style de développement Description
.NET : assemblys du SDK Les assemblys du SDK utilisent la technologie Windows Communication Foundation (WCF) pour établir un canal de communication avec les services Web Dynamics 365 Customer Engagement (on-premises). Le SDK simplifie l’utilisation de la technologie WCF en fournissant des classes proxy d’assistance qui facilitent l’écriture des applications qui se connectent et s’authentifient avec les services web Dynamics 365 Customer Engagement (on-premises).

Pour plus d’informations : Exemple : Authentifier les utilisateurs avec les services web Dynamics 365
.NET : assemblys des outils XRM Utilisez la chaîne de connexion, la classe CrmServiceClient ou les applets de commande PowerShell des outils XRM pour vous connecter à Dynamics 365 Customer Engagement (on-premises).

En savoir plus : Utiliser les chaînes de connexion des outils XRM pour se connecter à Dynamics 365 Customer Engagement (on-premises), Utiliser les constructeurs CrmServiceClient pour se connecter aux applications Dynamics 365 for Customer Engagement, Utiliser les applets de commande PowerShell pour que les outils XRM se connectent à Dynamics 365 Customer Engagement (on-premises)
API web Dynamics 365 Customer Engagement (on-premises) Pour plus d’informations : Authentification Dynamics 365 Customer Engagement avec l’API Web

Pour obtenir des informations détaillées sur l’authentification des utilisateurs pour se connecter à Dynamics 365 Customer Engagement (on-premises), voir Authentifier les utilisateurs dans Dynamics 365 Customer Engagement (on-premises)

Voir aussi

Authentifier les utilisateurs dans Dynamics 365 Customer Engagement (on-premises)
Didacticiels pour se familiariser avec le développement pour Dynamics 365 Customer Engagement (on-premises)
Rédiger du code pour Dynamics 365 Customer Engagement 2011 et Dynamics 365 Customer Engagement (services Web, JavaScript)
Présentation des modèles de programmation pour Dynamics 365 Customer Engagement (on-premises)