Extensions prises en charge pour Microsoft Dynamics 365

  • Article

 

Date de publication : janvier 2017

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

Vous pouvez personnaliser Microsoft Dynamics 365 (Online et local) à l’aide d’outils disponibles dans l’application Web Microsoft Dynamics 365 ou qui sont décrits dans le SDK de Microsoft Dynamics 365. 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 Microsoft Dynamics 365. Pour plus d'informations, voir Personnalisations non prises en charge.

Les rubriques couvertes dans les articles techniques publiés sur MSDN dans le Centre des développeurs de CRM sur MSDN sont prises en charge, mais ne peuvent pas être mises à niveau.

Contenu de la rubrique

Personnalisations à l’aide de l’application Web Microsoft Dynamics

Personnalisations à l’aide du kit de développement logiciel (SDK) de Microsoft Dynamics 365

Support pour les versions .NET Framework

Personnalisations non prises en charge

Personnalisations à l’aide de l’application Web Microsoft Dynamics

Vous pouvez utiliser divers outils fournis avec Microsoft Dynamics 365 pour la personnaliser. Les personnalisations effectuées via les outils Microsoft Dynamics 365 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 :

Notes

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 de Microsoft Dynamics CRM 2016 et Microsoft Dynamics CRM Online.

Personnalisations à l’aide du kit de développement logiciel (SDK) de Microsoft Dynamics 365

Le SDK de Microsoft Dynamics 365, les articles techniques et l’exemple de code publié sur le Centre des développeurs de Microsoft Dynamics CRM, ainsi que les informations publiées par l’équipe de support des développeurs de Microsoft Dynamics 365 sont inclus dans la zone des personnalisations à l’aide du SDK de Microsoft Dynamics 365. Les actions et niveaux spécifiques de prise en charge et de mise à niveau sont décrits ultérieurement dans cette rubrique.

SDK Microsoft Dynamics 365

L’utilisation des services Web est totalement prise en charge. Cela inclut : DiscoveryService, OrganizationService, Organization Data Service, le point de terminaison OData, le point de terminaison SOAP d’application moderne DeploymentService. 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, consultez les rubriques Étendre Microsoft Dynamics 365 sur le serveur et Administrer le déploiement à l’aide du service Web de déploiement.

JavaScript côté client

Vous pouvez utiliser JavaScript dans Microsoft Dynamics 365 (Online et local) 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> (RibbonDiffXml) ou <JavaScriptFunction> (RibbonDiffXml) pour définir les actions qui appellent les fonctionnalités 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 Microsoft Dynamics 365 doivent être exécutées uniquement via les méthodes avec les espaces de nom Xrm.Page ou Xrm.Utility documentés dans la Référence par programmation côté client. L’accès direct du Modèle d’objet de document (DOM) de toute page d’application Microsoft Dynamics 365 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 :b7840a25-f25e-409b-8b6a-0ef04c7ed9c4#BKMK_UsingjQuery

Vous pouvez ouvrir des formulaires, des vues, des dialogues et des rapports Microsoft Dynamics 365 à l’aide des méthodes documentées dans Ouvre les formulaires, vues, boîtes de dialogue et 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 Microsoft Dynamics 365 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 SDK de Microsoft Dynamics 365. 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.

Les modifications apportées au fichier Customizations.xml doivent respecter le schéma CustomizationsSolution.xsd. Pour plus d'informations, voir Schemas used in Microsoft Dynamics 365.

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 le SDK de Microsoft Dynamics 365 est totalement prise en charge et peut être totalement mise à jour. Cette fonctionnalité est disponible pour tous les déploiements Microsoft Dynamics 365, notamment locaux, IFD, et Online. Toutefois, les plug-ins peuvent être uniquement enregistrés et exécutés dans le bac à sable (mode d’isolation) de Microsoft Dynamics 365 (Online).Pour plus d'informations :Écrire des plug-ins pour étendre les processus d’entreprise

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 Microsoft Dynamics 365.

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 Microsoft Dynamics 365 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 Microsoft Dynamics 365 (Online).Pour plus d'informations :Automatiser les processus d'entreprise à l'aide du processus Dynamics 365

La possibilité de modifier les workflows XAML est totalement prise en charge et peut être mise à niveau. Cependant, cette fonctionnalité est disponible pour Microsoft Dynamics 365 local et IFD uniquement.Pour plus d'informations :Automatiser les processus d'entreprise à l'aide du processus Dynamics 365

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.5.2.

Tout client de service Web créé à l’aide de Microsoft .NET Framework 4.5.2 qui appelle les services Web Microsoft Dynamics 365 est totalement pris en charge dans Microsoft Dynamics 365.

Tout assembly .NET créé avec Microsoft .NET Framework 4.5.2 pour une utilisation dans Microsoft Dynamics 365 comme assembly de plug-in Microsoft Dynamics 365 ou comme activité de workflow personnalisée Microsoft Dynamics 365 est pris en charge.

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

Personnalisations non prises en charge

Les modifications apportées à Microsoft Dynamics 365 sans utiliser d’outils SDK de Microsoft Dynamics 365 ou Microsoft Dynamics 365 ne sont pas prises en charge et ne sont pas conservées pendant les mises à jour ou les mises à niveau de Microsoft Dynamics 365. Tout élément non documenté dans le SDK de Microsoft Dynamics 365 et les documents de support ne sont 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 Microsoft Dynamics 365. Pour réduire les problèmes de mise à niveau et de mise à jour, ne modifiez aucun fichier Microsoft Dynamics 365 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 Microsoft Dynamics 365, des outils Microsoft Dynamics 365 ou des fichiers Microsoft Dynamics 365 situés dans Program Files\Microsoft Dynamics 365. 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 Microsoft Dynamics 365 (paramètres de fichier et de site Web). Les solutions 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 Microsoft Dynamics 365.

  • L’utilisation des certificats clients n’est pas prise en charge par le SDK de Microsoft Dynamics 365. Si vous configurez le site Web Microsoft Dynamics 365 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 Microsoft Dynamics 365, l’ajout d’index est pris en charge conformément aux directives de la documentation Déploiement et administration de Microsoft Dynamics CRM. Cette action s'applique à toutes les bases de données Microsoft Dynamics 365 et à la base de données Microsoft Dynamics 365 pour Outlook locale.

    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 (enregistrement) de la base de données Microsoft Dynamics 365 à l’aide de commandes SQL ou toute technologie autre que celles décrites dans le SDK de Microsoft Dynamics 365.

  • Référencement de toute bibliothèque de liens dynamiques (DLL) Microsoft Dynamics 365 autre que ce qui suit :

    • Microsoft.Xrm.Sdk.dll

    • Microsoft.Crm.Sdk.Proxy.dll

    • Microsoft.Xrm.Sdk.Workflow.dll

    • Microsoft.Xrm.Sdk.Deployment.dll

    • Microsoft.Crm.Outlook.Sdk.dll

    • Microsoft.Crm.Tools.EmailProviders.dll

  • L’utilisation des interfaces de programmation d’application (API) autres que les API documentés des services Web DeploymentService, DiscoveryService, le service de données d’organisation, le point de terminaison SOAP pour les ressources Web et OrganizationService.

    Pour obtenir l’aspect et le comportement de Microsoft Dynamics 365, une réutilisation de tout contrôle d’interface utilisateur Microsoft Dynamics 365, 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 Microsoft Dynamics 365.

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

  • Modifications à tout formulaire Microsoft Office Outlook ou ajout de nouveaux formulaires, tels que les pages .aspx, directement vers Microsoft Dynamics 365 ou des modifications des fichiers .pst. Ces modifications ne seront pas mises à niveau.

  • En effectuant des personnalisations, hormis lorsque vous utilisez les outils pris en charge Microsoft Dynamics 365 disponibles hors ligne dans Dynamics 365 pour Outlook.

  • L’utilisation de HttpModules personnalisés pour injecter du code HTML/DHTML dans les formulaires Microsoft Dynamics 365.

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

  • Les plug-ins Microsoft Dynamics CRM 4.0 et les activités de workflow personnalisées ne sont pas pris en charge.

  • Le point de terminaison de service Microsoft Dynamics CRM 4.0 (point de terminaison 2007) n’est pas pris en charge.

  • La création d’une application Internet Information Services (IIS) dans le site Web Microsoft Dynamics 365 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 Quand modifier le fichier de personnalisations. 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.

Voir aussi

Choisir votre style de développement pour Dynamics 365
Étendre Microsoft Dynamics 365 sur le serveur
Écrire du code pour les formulaires Microsoft Dynamics 365

Microsoft Dynamics 365

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