Utilisation de solutions pour vos personnalisations

Date de publication : février 2017

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

Toutes les personnalisations effectuées dans Microsoft Dynamics 365 sont apportées dans le contexte d'une solution. Si vous n'êtes pas certain de quelle solution il s'agit, consultez la rubrique Ce que vous devez savoir sur les solutions.

Contenu de la rubrique

La solution par défaut

Accès à une solution spécifique

Utilisation de l'explorateur de solutions

Créer sa propre solution

Importation, mise à jour et exportation de solutions

Options de paramètres à l'exportation de solutions

Notifications de confidentialité

La solution par défaut

Lorsque vous personnalisez Microsoft Dynamics 365, vous travaillerez généralement avec la solution par défaut. Pour ouvrir la solution par défaut, accédez à Paramètres > Personnalisations et sélectionnez Personnaliser le système.

Chaque organisation possède une solution par défaut et contient des propriétés uniques. La solution par défaut contient tous les composants de solution disponibles dans votre organisation. D'autres solutions peuvent inclure un sous-ensemble des composants de solution visibles dans la solution par défaut, mais la solution par défaut les contient tous.

Accès à une solution spécifique

Si votre organisation utilise déjà une solution spécifique que vous devez utilisez, voici comment vous pouvez la rechercher. Pour créer une solution, voir Créer sa propre solution.

Ouvrir une solution non gérée

1. Accédez à Paramètres > Personnalisations.

2. Choisissez Solutions.

3. Double-cliquez sur la solution non gérée dans laquelle vous souhaitez travailler pour l'ouvrir.

Lorsque vous êtes dans la solution, vous verrez les composants de solution.Pour plus d'informations :Ajout de composants de solution

Utilisation de l'explorateur de solutions

Dans l'explorateur de solutions, vous pouvez naviguer dans une hiérarchie des nœuds à l'aide du volet de navigation sur le côté gauche, comme illustré dans la capture d'écran suivant :

Lorsque vous sélectionnez chaque nœud, la liste des composants de solution s'affiche. Les actions disponibles dans la barre de commandes changent selon le contexte du nœud sélectionné et si la solution est la solution par défaut ou une solution gérée. Pour les solutions non gérées qui ne sont pas la solution par défaut, vous pouvez utiliser la commande Ajouter pour importer les composants de solution qui ne sont pas encore dans la solution.

Avec les solutions gérées, il n'existe aucune commande disponible et vous verrez le message suivant :

Vous ne pouvez pas modifier directement les composants dans une solution gérée. Si les propriétés gérées pour les composants de solution sont définies pour autoriser la personnalisation, vous pouvez les modifier dans la zone Personnalisation ou à partir d’une autre solution non gérée.

Vous devez localiser le composant de solution dans la solution par défaut et réessayer de le modifier à cet endroit, ou de l'ajouter à une autre solution non gérée que vous avez créée. Le composant de solution ne peut pas être personnalisable.Pour plus d'informations :Propriétés gérées

Plusieurs des personnalisations que vous voulez réaliser impliqueront des entités. Vous pouvez développer le nœud Entités pour afficher la liste de toutes les entités du système qui peuvent être personnalisées d'une certaine manière. Vous pouvez développer davantage chaque entité pour afficher les composants de solutions faisant partie de l'entité, comme indiqué avec l'entité Compte dans la capture d'écran suivante :

Pour plus d'informations sur la personnalisation des composants de solution trouvés dans l'explorateur de solutions, consultez les rubriques suivantes :

• Pour les personnalisations d'entité, d'entités-relations, de champ et de message, voir Créer et modifier des métadonnées.

• Pour les formulaires d'entité, voir Créer et concevoir des formulaires.

• Pour les processus, voir Création et modification de processus.

• Pour les règles d'entreprise, voir Création et modification des règles métier.

Créer sa propre solution

Comme la solution par défaut contient tous les composants de solutions, il peut s'avérer plus simple pour vous de localiser uniquement les composants de solution que vous avez personnalisés si vous créez une solution distincte et y faites tout votre personnalisation. Cela facilite également l'exportation d'une sauvegarde de votre solution comme plus petit fichier. Si vous choisissez de faire cela, vous ne devez jamais oublier d'ajouter les composants de solution que vous modifiez à cette solution. Lorsque vous créez des composants de solution, vous devez toujours les créer dans le contexte de cette solution. De cette façon, le préfixe de personnalisation de l'éditeur de solutions sera appliqué de façon cohérente. Après avoir créé des composants de solution dans votre solution, ou avoir ajouté des composants de solution existants à cette solution, vous pouvez aussi les modifier dans la solution par défaut si vous le souhaitez.

1. Accédez à Paramètres > Solutions.

2. Choisissez Nouveau et renseignez les champs obligatoires pour la solution.

   Champ	Description
   Nom complet	Le nom indiqué dans la liste des solutions. Vous pouvez le modifier ultérieurement.
   Nom	Le nom unique de la solution. Il est généré à l'aide de la valeur entrée dans le champ Nom complet. Vous pouvez le modifier avant d'enregistrer la solution, mais une fois la solution sauvegardée, vous ne pourrez plus le modifier.
   Éditeur	Vous pouvez sélectionner l'éditeur par défaut, ou créer un nouvel éditeur. Vous devez uniquement utiliser l'éditeur par défaut de votre organisation, sauf si vous prévoyez de distribuer votre solution.
   Version	Entrez un numéro pour la version de la solution. Ceci est important uniquement si vous exportez votre solution. Le numéro de version est inclus dans le nom de fichier quand vous exportez la solution.

3. Choisissez Enregistrer.

Une fois la solution enregistrée, vous pouvez aussi vouloir ajouter des informations dans les champs qui ne sont pas obligatoires. Ces étapes sont facultatives. Utilisez le champ Description pour décrire la solution et choisir une ressource Web HTML comme Page de configuration pour la solution. La page de configuration est généralement utilisée par les éditeurs de logiciels indépendants qui distribuent des solutions. Lorsque cela est défini, un nouveau nœud Configuration s'affiche sous le nœud Informations et affiche cette ressource Web. Les développeurs utilisent cette page pour inclure des instructions ou des contrôles pour vous permettre de définir les données de configuration ou d'exécuter leur solution.

Ajout de composants de solution

Une fois votre solution créée, elle ne contient aucun composant de solution. Vous pouvez créer de nouveaux composants de solution ou utiliser le bouton Ajouter dans le menu de liste pour ajouter des composants depuis la solution par défaut.

Lors de cette action, il est possible que la boîte de dialogue Composants nécessaires manquants s'affiche.

Cette boîte de dialogue vous prévient que vous le composant de solution comporte des dépendances sur d'autres composants de solution. Si vous sélectionnez Non, ne pas inclure les composants nécessaires, la solution peut échouer si vous l'importez dans une autre organisation dans laquelle tous ces composants nécessaires n'existent pas. Si l'importation de la solution réussit, le comportement dans l'autre solution peut ne pas être identique, car l'organisation d'origine car les composants sont configurés différemment de ceux de la solution source.

Généralement, il est plus sûr d'inclure les composants nécessaires si vous envisagez d'exporter la solution dans une autre organisation. Si vous n'ajoutez pas ces composants lorsque vous ajoutez un composant de solution individuel, vous pouvez revenir plus tard, sélectionner le composant de solution que vous avez ajouté, puis choisir Ajouter les composants nécessaires dans le menu.

Si vous n'avez pas l'intention d'exporter la solution, ou si vous prévoyez uniquement de l'exporter en tant que solution non gérée et la réimporter dans la même organisation, il est inutile d'inclure des composants requis. Si vous exportez la solution, vous verrez un autre avertissement indiquant que certains composants nécessaires sont manquants. Si vous souhaitez uniquement réimporter cette solution dans la même organisation, vous pouvez ignorer cet avertissement. Les étapes pour modifier la navigation d'application ou le ruban sans utiliser d'outil d'édition tiers font supposer que vous réimporterez la solution dans la même organisation.

Importation, mise à jour et exportation de solutions

La fréquence à laquelle vous importez, mettez à jour, ou exportez des solutions peut dépendre de la taille de votre organisation, vos pratiques internes de développement, et si vous développez une solution qui doit être distribuée en tant que solution gérée.

• Si votre organisation est petite avec peu de personnalisations, et que vous êtes le seul personnalisateur, il est possible que vous n'exportiez ou n'importiez jamais de solutions, sauf peut-être que vous exportiez la solution par défaut pour créer une sauvegarde ou si vous décidez d'utiliser ou d'acheter une solution gérée fournie par une autre personne.

• Certaines organisations ont recours à une société externe qui crée les personnalisations pour elles. Dans ce cas, elles exporteront toutes les personnalisations qu'elles ont à ce moment et les enverront à la société externe. Cette société développera et testera les personnalisations et les renverra à l'organisation pour qu'elle les importe.

• Les organisations importantes peuvent avoir plusieurs équipes chargées de personnaliser le système. Elles peuvent comporter une organisation distincte spécialement dédiée au développement et aux personnalisations. Ces organisations ont souvent également des organisations de test et des organisations d'UAT (Test d’acceptation utilisateur) distinctes, ainsi qu'une organisation de production que tous les membres de l'organisation utilisent. Les organisations dépendent de l'exportation et de l'importation des personnalisations d'une organisation vers la suivante dans les procédures de création, test et vérification des solutions.

La stratégie que vous choisissez doit dépendre de vos besoins. Choses importantes à se rappeler :

• Vous ne pouvez pas exporter votre solution par défaut comme solution gérée.

• Nous ne prenons pas en charge l'importation d'une solution par défaut provenant d'un déploiement sur site dans une organisation Dynamics 365 (en ligne) ou d'une solution par défaut provenant d'une organisation Dynamics 365 (en ligne) dans un déploiement local. Nous prenons en charge l'importation de solutions personnalisées entre ces types de déploiements, mais pas de solutions par défaut.

• Lorsque vous exportez une solution gérée, vous ne pouvez pas la réimporter dans l'organisation depuis laquelle elle a été importée.

• Exportez une solution comme solution gérée uniquement lorsque vous prévoyez de la distribuer.

• N'importez jamais une solution non gérée à moins que vous soyez sûr que vous voulez accepter toutes les personnalisations qu'elle contient et permettre à ces personnalisations de remplacer les personnalisations que vous avez déjà créées.

• Les solutions ne peuvent rien supprimer. L'importation d'une solution non gérée peut remplacer les personnalisations existantes, elle ne peut pas les supprimer intégralement. Par exemple, si vous créez un champ personnalisé pour une entité, puis importez une solution contenant la définition de cette entité qui ne contient pas le champ personnalisé, le champ personnalisé créé sera toujours présent. Les modifications définies dans la solution que vous avez importée y seront également.

• Vous ne pouvez pas importer d’entité personnalisée dont le nom est identique à celui d’une entité existante.Microsoft Dynamics 365 autorise cependant les noms complets en double.

• Vous pouvez uniquement importer des éléments pour lesquels vous disposez de droits de création, lecture et mise à jour de niveau organisation.

• Vous devez disposer du rôle de sécurité Administrateur système pour importer des rôles de sécurité, des paramètres d’organisation, des étapes de traitement du message SDK et des assemblys du plug-in.

• Si vous importez des personnalisations incluant une langue non installée sur votre système, toutes les étiquettes définies dans les personnalisations sont converties dans la langue de base du système Microsoft Dynamics 365 à partir duquel les personnalisations ont été importées.

• Tous les rôles de sécurité importés sont rattachés à la division racine.

• Si un rôle de sécurité importé provient du même système Dynamics 365, toute modification apportée au rôle de sécurité est fusionnée. Tous les privilèges définis sur les entités système du rôle de sécurité sont remplacés par les privilèges définis pour le rôle de sécurité importé.

Importer des solutions

Vous pouvez importer des solutions manuellement en suivant les étapes ci-dessous. Importez uniquement des solutions obtenues auprès d’une source fiable. Les personnalisations peuvent inclure du code susceptible d’envoyer des données à des sources externes.

1. Accédez à Paramètres > Solutions.

2. Dans le menu de liste de solutions, sélectionnez Importer.

3. Dans la boîte de dialogue Importer la solution, l'étape Sélectionner le package de solution permet de localiser le fichier compressé (.zip ou .cab) contenant la solution à importer.

4. Sélectionnez Suivant

5. Vous pouvez afficher des informations sur la solution avant de choisir Importer.

6. Vous devrez peut-être attendre un peu, le temps que la solution soit importée. Si elle réussit, vous pouvez afficher les résultats puis choisir Fermer.

Si vous avez importé des modifications nécessitant une publication, vous devez publier les personnalisations pour qu'elles soient disponibles. Pour plus d'informations, voir Publication des personnalisations.

Si l'importation échoue, un rapport affichant les erreurs et avertissements capturés s'affiche. Vous pouvez choisir Fichier journal de téléchargement pour entrer des informations sur la cause de l'échec de l'importation. La plupart du temps, l'échec de l'importation d'une solution est dû au fait que la solution ne contenait pas certains composants de solution requis.

Si vous téléchargez le fichier journal, vous recevrez un fichier XML que vous pouvez ouvrir à l'aide de Microsoft Office Excel pour en afficher le contenu.

Mettre à jour des solutions

Vous pourrez parfois souhaiter installer une mise à jour vers une solution gérée existante. Le processus est similaire à l'installation d'une nouvelle solution gérée, mais des options différentes vous seront proposées. Si vous mettez à jour une solution que vous avez obtenue d'une autre personne, vous devez obtenir l'aide de l'éditeur de solutions sur les options à choisir.

1. Accédez à Paramètres > Solutions.

2. Dans le menu de liste de solutions, sélectionnez Importer.

3. Dans la boîte de dialogue Importer la solution, l'étape Sélectionner le package de solution permet de localiser le fichier compressé (.zip ou .cab) contenant la solution à mettre à jour.

4. Sélectionnez Suivant

5. Vous pouvez afficher des informations sur la solution avant de choisir Suivant. Cette page affichera une barre jaune indiquant Ce package de solution contient une mise à jour pour une solution déjà installée.

6. Les options suivantes sont à votre disposition :

   • Conserver les personnalisations (recommandé)

     Sélectionner cette option permet de conserver les personnalisations de composant non gérées, mais implique également que certaines des mises à jour incluses dans cette solution ne seront pas appliquées.

   • Remplacer les personnalisations

     Cette option remplace les personnalisations non gérées effectuées précédemment sur les composants inclus dans cette solution. Toutes les mises à jour incluses dans la solution prendront effet.

   Choisissez l'option adéquate, puis sélectionnez Suivant.

7. Vous devrez peut-être attendre un peu, le temps que la solution soit importée. Si elle réussit, vous pouvez afficher les résultats puis choisir Fermer.

Si vous avez importé des modifications nécessitant une publication, vous devez publier les personnalisations pour qu'elles soient disponibles. Pour plus d'informations, voir Publication des personnalisations.

Les éditeurs de solutions peuvent vous demander d'exporter vos personnalisations non gérées existantes, de mettre à jour leur solution gérée à l'aide de l'option de remplacement des personnalisations, puis de réimporter vos personnalisations non gérées. Cela permet de garantir que les modifications qu'ils attendent sont appliquées tout en protégeant vos personnalisations.

Exporter des solutions

Il est recommandé d'exporter vos personnalisations non gérées régulièrement pour avoir une sauvegarde au cas où un problème se produirait. Vous ne pouvez pas exporter les solutions gérées.

1. Accédez à Paramètres > Solutions.

2. Dans la liste, sélectionnez la solution à exporter, puis choisissez Exporter.

3. Dans l'étape Publier les personnalisations, il vous sera rappelé que seules les personnalisations publiées sont exportées et vous avez la possibilité de Publier toutes les personnalisations avant de choisir Suivant.

4. Si votre solution contient des composants nécessaires manquants, vous verrez l'étape Composants nécessaires manquants. Vous pouvez ignorer cet avertissement uniquement si vous envisagez de la réimporter comme solution non gérée dans l'organisation d'origine. Sinon, suivez les instructions dans la boîte de dialogue pour annuler l'exportation et ajouter les composants nécessaires.

5. Dans l'étape Paramètres système d’exportation (avancés), vous pouvez choisir certains paramètres système à ajouter à votre solution. Si votre solution dépend de groupes de paramètres système, sélectionnez-les, puis choisissez Suivant.

   Voir Options de paramètres à l'exportation de solutions pour plus d'informations sur les paramètres inclus avec chaque option.

6. Dans l'étape Type de package, vous devez choisir d'exporter la solution comme solution Non géré ou Géré.

7. L'étape suivante vous permet de choisir une solution cible pour une version spécifique de Dynamics 365. Cette option est généralement utilisée par les éditeurs de logiciels indépendants qui peuvent vouloir exporter une solution qui est conforme à une version précédente. Sauf si vous avez l'intention d'importer cette solution dans une organisation qui n'est pas mise à niveau vers la même version que la version de l'organisation utilisée, acceptez ceci par défaut.

   Pour plus d'informations voir la rubrique du SDK MSDN : Exporter une solution pour une version spécifique de Dynamics 365.

8. Choisissez Exporter pour télécharger le fichier de solution.

Le comportement exact de téléchargement des fichiers varie selon les navigateurs.

Options de paramètres à l'exportation de solutions

Le tableau suivant illustre les options disponibles lorsque vous exportez une solution :

Notifications de confidentialité

En activant une solution, vous marquez votre accord pour partager vos données avec un système externe. Les données importées depuis des systèmes externes dans Microsoft Dynamics 365 (Online) sont soumises à notre déclaration de confidentialité, accessible ici.

Vous pouvez importer et exporter des solutions vers et à partir de Microsoft Dynamics 365 (Online). Lorsque vous procédez ainsi, les solutions, qui peuvent contenir des informations personnelles, sont transférées via une connexion sécurisée entre votre ordinateur et les serveurs Microsoft. En retour, le code tiers importé dans Dynamics 365 (Online) peut par la suite transmettre des données client à un système externe (par exemple, InsideView) ou configurer/étendre les entités synchronisées (c'est-à-dire exportées) vers d'autres systèmes externes régis par une autre partie que Microsoft.
Si une solution à importer est censée transmettre des données client en dehors de la frontière de sécurité de Dynamics 365 (Online), les administrateurs sont invités à vérifier les types de données client qui seront appelés par le service/le logiciel/l'application avant de télécharger du code tiers vers leur instance de Dynamics 365 (Online).
L'extraction de données client par des services/logiciels/applications ou solutions tiers est contrôlée par le client, pas par Microsoft. La destination finale et les stratégies de confidentialité applicables aux points de données extraits par ces solutions externes sont régis par l'administrateur. Il est recommandé d'effectuer un examen approprié des stratégies applicables par les tiers qui exploitent ces services/logiciels/applications.

Voir aussi

Mise en route de la personnalisation
Utiliser des solutions segmentées et des correctifs pour simplifier les mises à jour de solution
Privilèges requis pour la personnalisation
Concepts de personnalisation
Vue d’ensemble de la personnalisation
Livre blanc : Modèles et principes des rédacteurs de solutions

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