Utiliser des propriétés managées

Cette rubrique s’applique à Dynamics 365 Customer Engagement (on-premises). Pour la version Power Apps de cette rubrique, consultez : Utiliser des propriétés managées.

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 leur 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	IsCustomizable. Value
Entité	Nom d’affichage modifiable	IsRenameable. Value
Entité	Peut être une entité associée dans une relation	CanBeRelatedEntityInRelationship. Value(Lecture seule)
Entité	Peut être une entité principale dans une relation	CanBePrimaryEntityInRelationship. Value(Lecture seule)
Entité	Peut figurer dans une relation plusieurs à plusieurs	CanBeInManyToMany. Value(Lecture seule)
Entité	Création possible de nouveaux formulaires	CanCreateForms. Value
Entité	Création possible de nouveaux graphiques	CanCreateCharts. Value
Entité	Création possible de nouvelles vues	CanCreateViews. Value
Entité	Peut modifier les autres propriétés de l’entité non représentées par une propriété gérée	CanModifyAdditionalSettings. Value
Champ (Attribut)	Personnalisable	IsCustomizable. Value
Champ (Attribut)	Nom d’affichage modifiable	IsRenameable. Value
Champ (Attribut)	Niveau requis modifiable	RequiredLevel. CanBeChanged Remarque : RequiredLevel est la seule propriété gérée à utiliser la propriété CanBeChanged.
Champ (Attribut)	Peut modifier les autres propriétés de l’attribut non représentées par une propriété gérée	CanModifyAdditionalSettings. Value
Relation d’entité	Personnalisable	IsCustomizable. Value
Formulaire	Personnalisable	SystemForm.IsCustomizable.Value
Graphique	Personnalisable	SavedQueryVisualization.IsCustomizable.Value
Afficher	Personnalisable	SavedQuery.IsCustomizable.Value
Groupe d’options	Personnalisable	IsCustomizable. 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.

Note

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 la solution dans lequel IsCustomizable a la valeur false et IsManaged a 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

Propriétés gérées
Plan de développement de solutions
Maintenir les solutions gérées
Packager et distribuer les extensions avec les solutions Dynamics 365 Customer Engagement
IsComponentCustomizableRequest