Partager via


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

 

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

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.

Composant

Nom complet

Propriété

Entité

Personnalisable

.Value

Nom d’affichage modifiable

.Value

Peut être une entité associée dans une relation

.Value (lecture seule)

Peut être une entité principale dans une relation

.Value (lecture seule)

Peut figurer dans une relation plusieurs à plusieurs

.Value (lecture seule)

Création possible de nouveaux formulaires

.Value

Création possible de nouveaux graphiques

.Value

Création possible de nouvelles vues

.Value

Peut modifier les autres propriétés de l’entité non représentées par une propriété gérée

.Value

Champ (Attribut)

Personnalisable

.Value

Nom d’affichage modifiable

.Value

Niveau requis modifiable

.CanBeChanged

Notes

RequiredLevel est la seule propriété gérée à utiliser la propriété CanBeChanged.

Peut modifier les autres propriétés de l’attribut non représentées par une propriété gérée

.Value

Relation d’entité

Personnalisable

.Value

Formulaire

Personnalisable

SystemForm.IsCustomizable.Value

Graphique

Personnalisable

SavedQueryVisualization.IsCustomizable.Value

Afficher

Personnalisable

SavedQuery.IsCustomizable.Value

Groupe d’options

Personnalisable

.Value

Ressource Web

Personnalisable

WebResource.IsCustomizable.Value

Workflow

Personnalisable

Workflow.IsCustomizable.Value

Assembly

Personnalisable

SdkMessageProcessingStep.IsCustomizable.Value

Inscription d’assembly

Personnalisable

ServiceEndpoint.IsCustomizable.Value

Modèle de courrier électronique

Personnalisable

Template.IsCustomizable.Value

Modèle d’article de la BC

Personnalisable

KbArticleTemplate.IsCustomizable.Value

Modèle de contrat

Personnalisable

ContractTemplate.IsCustomizable.Value

Modèle de publipostage

Personnalisable

MailMergeTemplate.IsCustomizable.Value

Tableau de bord

Personnalisable

SystemForm.IsCustomizable.Value

Rôles de sécurité

Personnalisable

Role.IsCustomizable.Value

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.

Notes

Cela signifie que vous ne pourrez pas développer une mise à jour pour votre solution en utilisant une organisation où votre solution gérée est installé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

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