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. Par défaut, tous les composants d’une solution personnalisés sont personnalisables. 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.
Les propriétés gérées garantissent que seule une solution du même éditeur pourra modifier le composant. Les propriétés gérées n’affecteront que les composants gérés et ne le forceront pas dans les environnements de développement où le composant n’est toujours pas géré. L’utilisation de la propriété gérée IsCustomized est destinée à garantir qu’aucune autre couche de solution d’un autre éditeur et qu’aucune personnalisation active ne peut être effectuée sur le composant une fois qu’il est installé en tant que solution gérée.
Le tableau suivant répertorie quelques propriétés gérées pour un sous-ensemble de composants de solution disponibles.
| Composant | Nom d’affichage | 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 |
| Entité | Création possible d’attributs | CanCreateAttributes.Value |
| Champ (Attribut) | Personnalisable | IsCustomizable.Value |
| Champ (Attribut) | Nom d’affichage modifiable | IsRenameable.Value |
| Champ (Attribut) | Niveau requis modifiable | RequiredLevel.CanBeChangedRemarque : 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 |
| Workflow | Étape de traitement personnalisée autorisée pour d’autres éditeurs | Workflow.IsCustomProcessingStepAllowedForOtherPublishers.Value |
| Assemblage | 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 |
| Formulaire système | Peut être supprimé | CanBeDeleted.Value |
| Requête système | Peut être supprimé | CanBeDeleted.Value |
Workflow Étape de traitement personnalisée autorisée pour d’autres éditeurs
Cette propriété gérée contrôle si les étapes du plug-in enregistrées par des tiers pour les messages créés par des actions de processus personnalisées seront exécutées. La valeur par défaut est false, ce qui signifie que les étapes du plug-in enregistrées qui n’utilisent pas le même éditeur de solutions ne seront pas exécutées. Lorsque la valeur est true, l’éditeur de l’action de processus personnalisée permet l’exécution des étapes d’enregistrement du plug-in enregistrées.
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.