Comprendre la fusion des solutions gérées

Cette rubrique s’applique à Dynamics 365 Customer Engagement (on-premises). Pour la version Power Apps de cette rubrique, consultez : Comprendre la fusion des solutions gérées.

Lorsque vous préparez l’installation de votre solution gérée, n’oubliez pas qu’une organisation peut avoir plusieurs solutions installées ou que d’autres solutions pourront être installées à l’avenir. Construisez une solution qui respecte les meilleures pratiques afin que votre solution n’interfère pas d’autres solutions.

Les processus utilisés par Dynamics 365 Customer Engagement (on-premises) pour fusionner les personnalisations mettent en valeur la préservation des fonctionnalités de la solution. Même si tous les efforts sont déployés pour conserver la présentation, certaines incompatibilités entre les personnalisations peuvent nécessiter que la résolution calculée modifie certains détails de présentation au profit du maintien des fonctionnalités de personnalisation.

Fusionner les personnalisation de formulaire

Les seules personnalisations de formulaire qui doivent être fusionnées sont celles exécutées sur les formulaires d’entités qui existent déjà dans l’organisation. En général, cela signifie que les personnalisations de formulaire ne doivent être fusionnées que lorsque votre solution personnalise les formulaires qui étaient inclus pour les entités créées lors de l’installation de Dynamics 365 Customer Engagement (on-premises). Un moyen d’éviter la fusion de formulaires consiste à fournir de nouveaux formulaires pour les entités Dynamics 365 Customer Engagement (on-premises). Les formulaires des entités personnalisées ne requièrent pas la fusion, à moins que vous ne créiez une solution qui met à jour ou modifie une solution gérée existante ayant créé les entités personnalisées et leurs formulaires.

Quand une solution est packagée en tant que solution gérée, les définitions de formulaire stockées dans FormXML sont comparées au FormXML d’origine et seules les différences sont incluses dans la solution gérée. Lorsque la solution gérée est installée dans une nouvelle organisation, les différences entre personnalisations de formulaire sont alors fusionnées avec le FormXML du formulaire existant pour créer une nouvelle définition de formulaire. Cette nouvelle définition de formulaire est ce que l’utilisateur voit et qu’un personnalisateur de système peut modifier. Lorsque la solution gérée est désinstallée, seuls les éléments de formulaire présents dans la solution gérée sont supprimés.

Lorsque vous ajoutez de nouveaux éléments à un formulaire qui doit être fusionné, il est recommandé que vous incluiez les nouveaux éléments au sein de nouveaux éléments de conteneur (onglets ou sections.) Les ajouts à un conteneur sont effectués en fin du conteneur. Par exemple, les champs ajoutés à une section sont placés à la fin de la section. Un personnalisateur installant une solution est censé modifier le formulaire pour réorganiser les éléments à l’issue de l’installation.

Les solutions gérées contenant des formulaires qui utilisent de nouveaux rôles de sécurité dépendent de ces rôles. Vous devez inclure ces rôles de sécurité dans votre solution gérée. S’il existe des rôles de sécurité associés à un formulaire qui ne figurent pas dans l’organisation où la solution gérée procède à l’installation, cette dernière n’échouera pas, mais les formulaires risquent de ne pas être associés aux rôles de sécurité. Lorsque la solution gérée est désinstallée, les rôles de sécurité fournis avec elle sont supprimés. Les formulaires en dehors de la solution gérée ne peuvent plus être associés à ces rôles de sécurité.

Note

Lorsqu’une entité de solution gérée contient plusieurs formulaires et que le formulaire d’entité de l’organisation contient également plusieurs formulaires, les nouveaux formulaires ne sont pas ajoutés au bas de la liste des formulaires disponibles, mais insérés dans les formulaires d’entité originaux.

Fusionner les personnalisations de navigation (Plan de site)

Lorsque la solution est packagée comme solution gérée, le Plan de site XML est comparée au Plan de site XML et aux autres personnalisations apportées au Plan de site. Seules les différences sont incluses dans la solution gérée. Ces différences incluent les éléments qui sont modifiés, déplacés, ajoutés ou supprimés. Lorsque la solution gérée est installée dans une nouvelle organisation, les modifications de Plan de site sont fusionnées avec le Plan de site XML de l’organisation où la solution gérée est installée. Une nouvelle définition de Plan de site apparaît.

À ce stade, un personnalisateur peut exporter le Plan de site vers une solution non gérée et cette définition de Plan de site contient tous les éléments du Plan de site actif. Un personnalisateur peut ensuite modifier le Plan de site et le réimporter comme personnalisation non gérée. Ultérieurement, si la solution gérée est désinstallée, le Plan de site XML qui a été importé avec la solution gérée est référencé pour supprimer les modifications introduites avec cette solution gérée. Un nouveau Plan de site actif est alors calculé.

Chaque fois qu’un nouvel élément visible est ajouté au Plan de site, celui-ci apparaît en bas du conteneur, quel qu’il soit, auquel il appartient. Par exemple, une nouvelle zone apparaît en bas de la zone de navigation. Pour positionner les éléments ajoutés, vous devez exporter le Plan de site, le modifier pour définir la position exacte, puis le réimporter en tant que solution non gérée.

Note

Une seule personnalisation de Plan de site peut être appliquée entre deux publications. Toutes les personnalisations du Plan de site non publiées seront perdues lorsqu’une nouvelle définition du Plan de site sera importée.

Fusionner les options d’un groupe d’options

Chaque nouvelle option d’un groupe d’options est initialisée avec une valeur entière incluant un préfixe de valeur d’option. Le préfixe de valeur d’option est un ensemble de cinq chiffres ajouté devant la valeur d’option. Un préfixe de valeur d’option est généré à partir du préfixe de personnalisation de l’éditeur de solutions, mais peut être défini avec n’importe quelle valeur. Le préfixe de valeur d’option permet de différencier les nouvelles options de groupe d’options créées dans le contexte d’un éditeur de solutions spécifique et réduit le risque de conflit entre valeurs d’option. L’utilisation du préfixe de valeur d’option est recommandée, mais pas requise.

Généralement, une solution gérée met à jour ou ajoute les options de groupes d’options qui sont déjà dans l’organisation : par exemple les groupes d’options Catégorie ou Secteur d’activité. Lorsqu’une solution gérée modifie les options disponibles dans un groupe d’options, toutes les options définies dans la solution gérée sont disponibles dans l’organisation. Lorsque la solution gérée est désinstallée, les options de groupes d’options retournent à leur état d’origine.

Voir aussi

Plan de développement de solutions
Utiliser les propriétés gérées
Packager et distribuer les extensions avec les solutions Dynamics 365 Customer Engagement
Personnaliser les formulaires d’entités dans Dynamics 365 Customer Engagement (on-premises)
Modifier la navigation dans l’application à l’aide du plan de site