Partager via


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