Utiliser les propriétés gérées

Date de publication : janvier 2017

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

Vous pouvez contrôler les composants de votre solution gérée qui sont personnalisables en utilisant les propriétés gérées. Vous devez autoriser autant de personnalisation que possible pour ces composants de solution qui représentent des entités commerciales. Cela permet aux organisations de personnaliser votre solution en fonction de leurs besoins. Limitez ou supprimez la personnalisation des composants de solution critiques qui fournissent les fonctionnalités principales de votre solution afin que vous puissiez la prendre en charge et la gérer de façon prévisible.

Les propriétés gérées sont destinées à protéger votre solution des modifications susceptibles de provoquer son arrêt. Les propriétés gérées ne fournissent pas la gestion des droits numériques (DRM) ou les fonctionnalités pour établir une licence pour votre solution ou contrôler les personnes habilitées à l’installer.

Appliquer les propriétés gérées

Vous appliquez les propriétés gérées lorsque la solution n’est pas gérée. Les propriétés gérées ne prennent effet qu’une fois que la solution gérée est packagée et installée dans une autre organisation. Une fois la solution gérée installée, les propriétés gérées ne peuvent pas être mises à jour, sauf par une mise à jour de la solution par l’éditeur d’origine.

La plupart des composants de solution contiennent un bouton Propriétés gérées quand vous affichez la liste des composants de solution. Vous pouvez afficher ou mettre à jour les propriétés gérées pour un composant de solution lorsque vous cliquez sur ce bouton. Pour accéder aux propriétés gérées pour les solutions qui n’affichent pas ce bouton, sélectionnez Propriétés gérées dans la liste déroulante Autres actions.

Par défaut, tous les composants d’une solution personnalisés sont personnalisables. Pour modifier les propriétés gérées d’un composant de solution, cliquez sur le bouton Propriétés gérées de la barre d’outils du composant de solution. Chaque composant de solution a une propriété Personnalisable (IsCustomizable). Aussi longtemps que cette propriété a la valeur true, il est possible de spécifier plus de propriétés propres au type de composant de solution. Si vous définissez la propriété IsCustomizable.Value avec la valeur false, lorsque la solution a été installée comme solution gérée, le composant de solution n’est pas personnalisable. Le tableau suivant répertorie les propriétés gérées de chaque composant de solution.

Mettre à jour les propriétés gérées

Après avoir publié votre solution gérée, vous pouvez décider de modifier les propriétés gérées. Vous ne pouvez modifier les propriétés gérées que pour les rendre moins restrictives. Par exemple, après votre publication initiale, vous pouvez décider de permettre la personnalisation d’une entité.

Vous mettez à jour les propriétés gérées de votre solution en publiant une mise à jour de votre solution avec les propriétés gérées modifiées. Votre solution gérée ne peut être mise à jour que par une autre solution gérée associée au même enregistrement d’éditeur que la solution gérée d’origine. Si votre mise à jour contient un changement des propriétés gérées pour les rendre plus restrictives, ces modifications des propriétés gérées seront ignorées, mais les autres modifications de la mise à jour seront appliquées.

Comme l’éditeur d’origine est une condition requise pour mettre à jour les propriétés gérées d’une solution gérée, aucune solution non gérée ne peut être associée à un éditeur utilisé pour installer une solution gérée.

Vérifier les propriétés gérées

Utilisez IsComponentCustomizableRequest pour savoir si un composant de solution est personnalisable. Par ailleurs, vous pouvez contrôler les propriétés du composant de solution, mais vous devez considérer le fait que la détermination finale de la signification dépend des valeurs de plusieurs propriétés. Chaque composant de solution a une propriété IsCustomizable. Lorsqu’un composant de solution est installé dans le cadre d’une solution gérée, la propriété IsManaged a la valeur true. Les propriétés gérées ne sont appliquées que pour les solutions gérées. Lors de la vérification des propriétés gérées pour déterminer si un composant de solution spécifique est personnalisable, vous devez contrôler à la fois la propriété IsCustomizable et la propriété IsManaged. Un composant de solution où IsCustomizable a la valeur false et où IsManaged a également la valeur false est personnalisable.

L’entité et l’attribut ont d’autres propriétés gérées en plus de IsCustomizable. Ces propriétés gérées ne sont pas mises à jour si IsCustomizable a la valeur false. Cela signifie qu’en plus du contrôle de la propriété gérée, vous devez aussi vérifier la propriété IsCustomizable pour voir si la propriété gérée est appliquée.

Voir aussi

IsComponentCustomizableRequest
Propriétés gérées
Plan de développement de solutions
Maintenir les solutions gérées
Empaqueter et distribuer les extensions à l’aide des solutions

Microsoft Dynamics 365

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