Partager via

Extensions prises en charge

  • Article

Vous pouvez personnaliser Dynamics 365 Customer Engagement (on-premises) à l’aide d’outils disponibles dans l’application web Dynamics 365 Customer Engagement (on-premises) ou qui sont décrits dans les services web Dynamics 365 Customer Engagement. Ces personnalisations sont prises en charge et peuvent être mises à niveau.

Les personnalisations effectuées à l’aide de méthodes autres que celles décrites ici ne sont pas prises en charge et peuvent entraîner des problèmes pendant les mises à jour et les mises à niveau vers Dynamics 365 Customer Engagement (on-premises). Pour plus d’informations, voir Personnalisations non prises en charge.

Les sujets abordés dans les articles techniques publiés sur les sites Microsoft tels que MSDN ou celui-ci sont pris en charge, mais peuvent ne pas être évolutifs.

Personnalisations à l’aide de l’application web Dynamics 365 Customer Engagement (on-premises)

Vous pouvez utiliser divers outils fournis avec Dynamics 365 Customer Engagement (on-premises) pour la personnaliser. Les personnalisations effectuées via les outils Dynamics 365 Customer Engagement (on-premises) et l’application web sont entièrement prises en charge et peuvent être intégralement mises à jour.

Les méthodes de personnalisation suivantes peuvent être utilisées pour produire des personnalisations entièrement prises en charge :

Note

Totalement pris en charge signifie que le support de développeur peut fournir l’aide pour les personnalisations et que le support d’application peut aider les clients à exécuter ces modifications.

Pour plus d’informations sur l’utilisation des outils de personnalisation de l’application web, voir le Guide de personnalisation (Dynamics 365 Customer Engagement (on-premises)).

Personnalisations à l’aide du kit de développement logiciel (SDK) de Dynamics 365 Customer Engagement (on-premises)

Les services web Dynamics 365 Customer Engagement, la documentation de ce site pour les développeurs, les articles techniques, l’exemple de code publié sur ce site, ainsi que les informations publiées par l’équipe de support des développeurs de Dynamics 365 Customer Engagement (on-premises) pour applications sont inclus dans la zone à l’aide des services Web Dynamics 365 Customer Engagement Web. Les actions et niveaux spécifiques de prise en charge et de mise à niveau sont décrits ultérieurement dans cette rubrique.

Services web Dynamics 365 Customer Engagement (on-premises)

L’utilisation des services web est totalement prise en charge. Ils comprennent : le service de découverte, le service d’organisation, le service de données de l’organisation, l’API web et le service de déploiement. Nous nous efforçons de maintenir l’arrière des API compatible, mais nous nous réservons le droit de modifier les API pour des fonctionnalités supplémentaires. Les attributs d’entité peuvent également changer dans des versions ultérieures. Pour plus d’informations, voir Écrire du code pour Dynamics 365 Customer Engagement (on-premises) (Services web).

JavaScript côté client

Vous pouvez utiliser JavaScript dans Dynamics 365 Customer Engagement (on-premises) dans trois domaines :

  • Gestionnaires d’évènements du script du formulaire : vous pouvez configurer les gestionnaires d’évènements de formulaire pour appeler les fonctions définies dans les ressources Web JavaScript.

  • Commandes de la barre de commandes (ruban) : vous pouvez utiliser les éléments <CustomRule> ou <JavaScriptFunction> pour définir les actions qui appellent les fonctions définies dans les ressources Web JavaScript.

  • Ressources Web et IFRAMEs : vous pouvez utiliser les ressources Web JavaScript dans les ressources Web HTML. Les IFRAMES configurés pour autoriser les scripts inter-sites au sein des ressources Web HTML comprises dans un formulaire peuvent interagir avec les méthodes Xrm.Page ou Xrm.Utility documentées dans le formulaire via la référence parente.

    Toutes les interactions avec les pages d’application Dynamics 365 Customer Engagement (on-premises) doivent être exécutées uniquement via les méthodes avec les espaces de nom documentées dans la Référence de l’API client. L’accès direct du Modèle d’objet de document (DOM) de toute page d’application Dynamics 365 Customer Engagement (on-premises) n’est pas pris en charge. Nous ne vous recommandons pas d’utiliser jQuery dans les scripts de formulaire ni les commandes. Pour plus d’informations, voir : Création de scripts client dans Customer Engagement (on-premises) à l’aide de JavaScript

    Vous pouvez ouvrir des formulaires, des vues, des boîtes de dialogue et des rapports Dynamics 365 Customer Engagement (on-premises) à l’aide des méthodes documentées dans Ouvrir des formulaires, des vues, des dialogues et des rapports avec une URL.

Personnalisation du ruban

L’utilisation de RibbonDiffXml pour ajouter, supprimer ou masquer des éléments du ruban n’est pas prise en charge. Une réutilisation des commandes du ruban définies par Dynamics 365 Customer Engagement (on-premises) est prise en charge ; toutefois, nous nous réservons le droit de modifier ou de désapprouver les commandes disponibles. Une réutilisation des fonctionnalités JavaScript définies dans les commandes du ruban n’est pas prise en charge.

Fichier de solution

La modification d’un fichier de solution non gérée est prise en charge comme décrit dans cette documentation. Certaines tâches de personnalisation sont exécutées à l’aide des étapes suivantes :

  • Exportez un composant de solution comme une solution non gérée.

  • Extrayez le contenu du package de solution.

  • Modifiez le fichier Customizations.xml.

  • Repackagez le fichier de solutions.

  • Importez la solution modifiée.

    Note

    Les modifications apportées au fichier Customizations.xml doivent respecter le schéma CustomizationsSolution.xsd. Pour plus d’informations, voir Schémas utilisés dans Dynamics 365 Customer Engagement (on-premises).

Les tâches suivantes prises en charge nécessitent cette procédure :

  • Personnalisation du ruban.
  • Personnalisation de la navigation de l’application à l’aide du plan de site.
  • Personnalisation des formulaires et du tableau de bord avec FormXml.
  • Personnalisation de requête enregistrée.

Plug-ins

La possibilité de créer une logique métier personnalisée à l’aide du mécanisme de plug-in décrit dans cette documentation est totalement prise en charge et peut être totalement mise à jour. Cette fonctionnalité est disponible pour tous les déploiements Dynamics 365 Customer Engagement (on-premises), notamment locaux, IFD, et en ligne. Toutefois, les plug-ins peuvent être uniquement enregistrés et exécutés dans le bac à sable (mode d’isolation) de Dynamics 365 Customer Engagement (on-premises). Plus d’informations : Plug-ins pour l’extension de Dynamics 365 Customer Engagement (on-premises)

L’ajout de votre plug-in et des assemblies de l’activité de workflow personnalisée au dossier %installdir%\server\bin\ est pris en charge uniquement sur les installations de serveur IFD et local Dynamics 365 Customer Engagement (on-premises).

Workflow

La possibilité de créer des activités de workflow personnalisées (assemblies) à appeler à partir de règles de workflow est totalement prise en charge et peut être mise à niveau. Cette fonctionnalité est disponible pour Dynamics 365 Customer Engagement (on-premises) local, IFD et Online. Toutefois, les activités de workflow personnalisées peuvent être enregistrées et exécutées dans le bac à sable (mode d’isolation) de Dynamics 365 Customer Engagement (on-premises). Pour plus d’informations, voir :Automatiser vos processus d’entreprise dans Customer Engagement

La possibilité de modifier les workflows XAML est totalement prise en charge et peut être mise à niveau. Cependant, cette fonctionnalité est disponible pour Dynamics 365 Customer Engagement (on-premises) local et IFD uniquement. Pour plus d’informations, voir :Automatiser vos processus d’entreprise dans Customer Engagement (on-premises)

Support pour les versions .NET Framework

Ce qui suit décrit les considérations de support pour le code personnalisé écrit avec Microsoft .NET Framework 4.6.2.

  • Tout client de service web créé à l’aide de Microsoft .NET Framework 4.6.2 ou version ultérieure qui appelle les services web Dynamics 365 Customer Engagement (on-premises) est totalement pris en charge dans Dynamics 365 Customer Engagement (on-premises).

    Important

    Vous devez créer toutes vos applications clientes personnalisées à l’aide de Microsoft .NET Framework 4.6.2 ou version ultérieure. À compter de Dynamics 365 Customer Engagement (on-premises) version 9, seules les applications utilisant le protocole TLS (Transport Level Security) 1.2 ou niveau supérieur seront autorisées à se connecter. TLS 1.2 n’est pas le protocole par défaut utilisé par .NET Framework 4.5.2, mais c’est le cas dans la version 4.6.2 de .NET Framework.

    L’application de ce niveau de sécurité supérieur ne concerne à ce stade que Dynamics 365 Customer Engagement (on-premises) version 9. Si vos clients sont conçus pour se connecter à n’importe quelle version ou type de déploiement, vous pouvez vous préparer en recompilant l’application pour qu’elle utilise .NET Framework 4.6.2. Pour plus d’informations : Billet de blog : Mises à jour de la sécurité de connexion de Dynamics 365 Customer Engagement (on-premises)

  • Tout assembly .NET créé avec Microsoft .NET Framework 4.6.2 pour une utilisation dans Dynamics 365 Customer Engagement (on-premises) comme assembly de plug-in Dynamics 365 Customer Engagement (on-premises) ou comme activité de workflow personnalisée Dynamics 365 Customer Engagement (on-premises) est pris en charge.

  • Toute visualisation (graphique) créée avec .NET Framework 4.5.2.

Personnalisations non prises en charge

Les modifications apportées à Dynamics 365 Customer Engagement (on-premises) sans utiliser les méthodes décrites dans cette documentation ou les outils Dynamics 365 Customer Engagement (on-premises) ne sont pas prises en charge et ne sont pas conservées pendant les mises à jour ou les mises à niveau de Dynamics 365 Customer Engagement (on-premises). Tout élément non documenté dans cette documentation et les documents de support n’est pas pris en charge. En outre, les modifications non prises en charge pourraient causer des problèmes lorsque vous mettez à jour via l’ajout de correctifs ou de service packs ou mettez à niveau Dynamics 365 Customer Engagement (on-premises). Pour réduire les problèmes de mise à niveau et de mise à jour, ne modifiez aucun fichier Dynamics 365 Customer Engagement (on-premises) que vous n’avez pas créé vous-même.

La liste qui suit répertorie les types d’action non prise en charge faisant l’objet de questions fréquentes :

  • Les modifications apportées à tout fichier .aspx, .css, .htm, .js, .xml, .jpg, ou .gif ou l’ajout de fichiers dans les répertoires wwwroot de l’application Dynamics 365 Customer Engagement (on-premises), des outils Dynamics 365 Customer Engagement (on-premises) ou des fichiers Dynamics 365 Customer Engagement (on-premises) situés dans Program Files\Dynamics 365 Customer Engagement (on-premises). Toutefois, si vous avez apporté des modifications à ces fichiers, ces derniers sont vérifiés pour modifications et ne seront pas remplacés.

  • Modifications apportées au site web Dynamics 365 Customer Engagement (on-premises) (paramètres de fichier et de site web). Les applications personnalisées doivent être installées dans un site web différent. Cela inclut les modifications apportées aux listes de contrôle d’accès au système de fichiers (ACL) de tous les fichiers figurant sur le serveur Dynamics 365 Server.

  • L’utilisation des certificats clients n’est pas prise en charge. Si vous configurez le site web Dynamics 365 Customer Engagement (on-premises) pour qu’il requiert des certificats clients IIS, vous recevrez des erreurs d’authentification pour toutes les applications qui ont été créées avec le Kit de développement logiciel.

  • Modifications apportées au schéma physique de la base de données, autres que l’ajout ou la mise à jour d’index. Cela inclut toutes les actions exécutées par rapport à la base de données sans utiliser les possibilités de personnalisation du système dans l’application web ou à l’aide des API de métadonnées décrits dans la documentation propre au kit de développement logiciel (SDK). Les modifications apportées aux tableaux, procédures stockées ou aux vues de la base de données ne sont pas prises en charge. L’ajout de tableaux, de procédures stockées ou de vues à la base de données n’est également pas pris en charge en raison de problème d’intégrité référentielle ou de mise à niveau. Pour les déploiements locaux de Dynamics 365 Customer Engagement (on-premises), l’ajout d’index est pris en charge conformément aux directives de la documentation Déploiement et administration de Microsoft Dynamics 365 Customer Engagement (on-premises). Cette action s’applique à toutes les bases de données Dynamics 365 Customer Engagement (on-premises) et à la base de données Dynamics 365 for Outlook locale.

    Important

    Lorsque vous modifiez la base de données sans les méthodes de support pour la personnalisation du système, vous risquez des problèmes lors des mises à jour et des mises à niveau.

  • Les modifications apportées aux données (enregistrements) de la base de données Dynamics 365 Customer Engagement (on-premises) à l’aide de commandes SQL ou toute technologie autre que celles décrites dans cette documentation.

  • Référencement de toute bibliothèque de liens dynamiques (DLL) Dynamics 365 Customer Engagement (on-premises) autre que ce qui suit :

    • Microsoft.Crm.Outlook.Sdk.dll
    • Microsoft.Crm.Sdk.Proxy.dll
    • Microsoft.Xrm.Sdk.dll
    • Microsoft.Xrm.Sdk.Data.dll
    • Microsoft.Xrm.Sdk.Deployment.dll
    • Microsoft.Xrm.Sdk.Workflow.dll
    • Microsoft.Xrm.Tooling.Connector.dll
    • Microsoft.Xrm.Tooling.CrmConnectControl.dll
    • Microsoft.Xrm.Tooling.PackageDeployment.CrmPackageExtentionBase.dll
    • Microsoft.Xrm.Tooling.WebResourceUtility.dll

  • L’utilisation des interfaces de programmation d’application (API) autres que les API documentées dans les services web : API WEb, Service d’organisation, Service de déploiement, Service de découverte, Service de données d’organisation.

  • Pour obtenir l’aspect et le comportement de Dynamics 365 Customer Engagement (on-premises), une réutilisation de tout contrôle d’interface utilisateur Dynamics 365 Customer Engagement (on-premises), notamment les contrôles de grille. Ces contrôles peuvent changer ou être remplacés lors d’une mise à niveau. Nous ne vous recommandons pas d’utiliser ou de modifier le fichier Default.css dans le dossier d’installation racine Dynamics 365 Customer Engagement (on-premises).

  • La réutilisation de tout code JavaScript Dynamics 365 Customer Engagement (on-premises), notamment les commandes du ruban. Ce code peut être modifié ou remplacé lors d’une mise à niveau.

  • Modifications de tout formulaire Dynamics 365 Customer Engagement (on-premises) ou ajout de nouveaux formulaires, tels que les pages .aspx personnalisées, directement dans Office Outlook ou modifications des fichiers .pst. Ces modifications ne seront pas mises à niveau.

  • En effectuant des personnalisations, hormis lorsque vous utilisez les outils pris en charge Dynamics 365 Customer Engagement (on-premises) disponibles hors ligne dans Dynamics 365 for Outlook.

  • L’utilisation de HttpModules personnalisés pour injecter du code HTML/DHTML dans les formulaires Dynamics 365 Customer Engagement (on-premises).

  • La création d’un assembly de plug-in pour un assembly Dynamics 365 Customer Engagement (on-premises) standard (Microsoft.Crm.*.dll) ou l’exécution d’une mise à jour ou la suppression d’une plateforme créée pluginassembly n’est pas prise en charge.

  • La création d’une application IIS dans le site web Dynamics 365 Customer Engagement (on-premises) pour tout VDir et spécifiquement dans le dossier ISV n’est pas prise en charge. Le dossier <crmwebroot>\ISV n’est plus pris en charge.

  • La modification d’un fichier de solutions pour modifier tout composant de solution autre que les rubans, formulaires, plans de site ou demandes sauvegardées n’est pas prise en charge. Pour plus d’informations, voir Prise en charge de la modification du fichier de personnalisation. La définition de nouveaux composants de solution en modifiant le fichier de solutions n’est pas prise en charge. La modification des fichiers de ressources web exportés avec une solution n’est pas prise en charge. À l’exception des étapes documentées dans Maintenir les solutions gérées, la modification du contenu d’une solution gérée n’est pas prise en charge.

  • La Mise en cache de la bibliothèque d’application Silverlight n’est pas prise en charge.

  • L’affichage d’un formulaire d’entité dans un IFrame imbriqué dans un autre formulaire d’entité n’est pas pris en charge.

  • Les assemblys de plug-in et de workflow doivent contenir toute la logique nécessaire dans leur dll respectif. Les plug-in peuvent faire référence à certains assemblys .Net. Toutefois, nous ne prenons pas en charge les dépendances aux assemblys .Net qui interagissent avec des API Windows de bas niveau, telles que l’interface de conception graphique. Précédemment, Dynamics 365 Customer Engagement autorisait les assemblys à faire référence à ces interfaces, mais pour adhérer à nos normes de sécurité, il est nécessaire de changer ce comportement.

Voir aussi

Choisir votre style de développement pour le code géré
Écrire du code pour Dynamics 365 Customer Engagement (on-premises) (services web)
Création de scripts client dans Customer Engagement (on-premises) à l’aide de JavaScript