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