Beheerde eigenschappen gebruiken
U kunt bepalen welke onderdelen van uw beheerde oplossing aanpasbaar zijn met behulp van beheerde eigenschappen. Standaard zijn alle aangepaste oplossinsonderdelen aanpasbaar. Alle oplossingsonderdelen hebben een eigenschap Kan worden aangepast (IsCustomizable). Zolang de waarde van deze eigenschap is ingesteld op true, kunnen meer eigenschappen die specifiek zijn voor het type oplossingsonderdeel worden opgegeven. Als u de eigenschap IsCustomizable.Value instelt op false, is de oplossingsonderdeel niet langer aanpasbaar nadat de oplossing als beheerde oplossing is geïnstalleerd.
Beheerde eigenschappen zorgen ervoor dat alleen een oplossing van dezelfde uitgever het onderdeel kan wijzigen. Beheerde eigenschappen hebben alleen invloed op beheerde onderdelen en forceren dit niet in de ontwikkelomgevingen waarin het onderdeel nog niet wordt beheerd. Het gebruik van de beheerde eigenschap IsCustomized is bedoeld om ervoor te zorgen dat geen andere oplossingslaag van een andere uitgever bestaat en geen actieve aanpassingen kunnen worden gedaan aan het onderdeel, zodra dit is geïnstalleerd als een beheerde oplossing.
De volgende tabel vermeldt enkele beheerde eigenschappen voor een subset van beschikbare oplossingsonderdelen.
| Onderdeel | Weergavenaam | Eigenschap |
|---|---|---|
| Entiteit | Kan worden aangepast | IsCustomizable.Value |
| Entiteit | Weergavenaam kan worden gewijzigd | IsRenameable.Value |
| Entiteit | Kan gerelateerde entiteit zijn in relatie | CanBeRelatedEntityInRelationship.Value(Alleen-lezen) |
| Entiteit | Kan primaire entiteit zijn in relatie | CanBePrimaryEntityInRelationship.Value(Alleen-lezen) |
| Entiteit | Kan deel uitmaken van een veel-op-veelrelatie | CanBeInManyToMany.Value(Alleen-lezen) |
| Entiteit | Er kunnen nieuwe formulieren worden gemaakt | CanCreateForms.Value |
| Entiteit | Nieuwe grafieken kunnen worden gemaakt | CanCreateCharts.Value |
| Entiteit | Er kunnen nieuwe weergaven worden gemaakt | CanCreateViews.Value |
| Entiteit | Kan alle andere entiteitseigenschappen wijzigen die niet door een beheerde eigenschap worden vertegenwoordigd | CanModifyAdditionalSettings.Value |
| Entiteit | Kan kenmerken maken | CanCreateAttributes.Value |
| Veld (kenmerk) | Kan worden aangepast | IsCustomizable.Value |
| Veld (kenmerk) | Weergavenaam kan worden gewijzigd | IsRenameable.Value |
| Veld (kenmerk) | Het vereistenniveau kan worden gewijzigd | RequiredLevel.CanBeChangedOpmerking: RequiredLevel is de enige beheerde eigenschap om de eigenschap CanBeChanged te gebruiken. |
| Veld (kenmerk) | Kan alle andere kenmerkeigenschappen wijzigen die niet door een beheerde eigenschap worden vertegenwoordigd | CanModifyAdditionalSettings.Value |
| Entiteitsrelatie | Kan worden aangepast | IsCustomizable.Value |
| Formulier | Kan worden aangepast | SystemForm.IsCustomizable.Value |
| Grafiek | Kan worden aangepast | SavedQueryVisualization.IsCustomizable.Value |
| Weergave | Kan worden aangepast | SavedQuery.IsCustomizable.Value |
| Optieset | Kan worden aangepast | IsCustomizable.Value |
| Webresource | Kan worden aangepast | WebResource.IsCustomizable.Value |
| Workflow | Kan worden aangepast | Workflow.IsCustomizable.Value |
| Workflow | Is een aangepaste verwerkingsstap toegestaan voor andere uitgevers | Workflow.IsCustomProcessingStepAllowedForOtherPublishers.Value |
| Assembly | Kan worden aangepast | SdkMessageProcessingStep.IsCustomizable.Value |
| Assemblyregistratie | Kan worden aangepast | ServiceEndpoint.IsCustomizable.Value |
| e-mailsjabloon | Kan worden aangepast | Template.IsCustomizable.Value |
| KB-artikelsjabloon | Kan worden aangepast | KbArticleTemplate.IsCustomizable.Value |
| Contractsjabloon | Kan worden aangepast | ContractTemplate.IsCustomizable.Value |
| Sjabloon Afdruk samenv. | Kan worden aangepast | MailMergeTemplate.IsCustomizable.Value |
| Dashboard | Kan worden aangepast | SystemForm.IsCustomizable.Value |
| Beveiligingsrollen | Kan worden aangepast | Role.IsCustomizable.Value |
| Systeemformulier | Kan worden verwijderd | CanBeDeleted.Value |
| Systeemquery | Kan worden verwijderd | CanBeDeleted.Value |
Werkstroom Is een aangepaste verwerkingsstap toegestaan voor andere uitgevers
Deze beheerde eigenschap bepaalt of plug-in-stappen die zijn geregistreerd door derden voor berichten die zijn gemaakt door aangepaste procesacties, worden uitgevoerd. De standaardwaarde is false, wat betekent dat geregistreerde plug-in-stappen die niet dezelfde oplossingsuitgever gebruiken, niet worden uitgevoerd. Wanneer dit true is, staat de uitgever van de aangepaste procesactie toe dat geregistreerde stappen voor het registreren van plug-ins worden uitgevoerd.
Beheerde eigenschappen bijwerken
Nadat u uw beheerde oplossing hebt vrijgegeven, kunt u beslissing dat u de beheerde eigenschappen wilt wijzigen. U kunt alleen beheerde eigenschappen wijzigen om deze minder beperkend te maken. Zo kunt u bijvoorbeeld na de aanvankelijke publicatie bepalen dat aanpassing een entiteit is toegestaan.
U werkt beheerde eigenschappen voor uw oplossing bij door een update van uw oplossing met de gewijzigde beheerde eigenschappen vrij te geven. Uw beheerde oplossing kan alleen door een andere beheerde oplossing worden bijgewerkt die aan dezelfde uitgeversrecord is gekoppeld als de oorspronkelijke beheerde oplossing. Als uw update een wijziging in beheerde eigenschappen omvat om deze beperkter te maken, worden deze wijzigingen van beheerde eigenschappen genegeerd maar worden andere wijzigingen in de update wel toegepast.
Omdat de oorspronkelijke uitgever een vereiste is om beheerde eigenschappen bij te werken voor een beheerde oplossing, kan niet elke onbeheerde oplossing aan een uitgever worden gekoppeld die is gebruikt om een beheerde oplossing te installeren.
Notitie
Dit betekent dat u geen update voor uw oplossing kunt ontwikkelen door een organisatie te gebruiken waarin uw beheerde oplossing is geïnstalleerd.
Beheerde eigenschappen controleren
Gebruik IsComponentCustomizableRequest om te controleren of een oplossingsonderdeel kan worden aangepast. U kunt ook de eigenschappen van de oplossingsonderdelen controleren maar u moet er rekening mee houden dat de uiteindelijke bepaling van de betekenis afhankelijk is van de waarden van verschillende eigenschappen. Alle oplossingsonderdelen hebben een eigenschap IsCustomizable. Wanneer een oplossingsonderdeel als onderdeel van een beheerde oplossing is geïnstalleerd, verandert de eigenschap IsManaged in true. Beheerde eigenschappen worden alleen afgedwongen voor beheerde oplossingen. Bij het controleren van beheerde eigenschappen om te bepalen of een individueel oplossingsonderdeel kan worden aangepast, moet u zowel de eigenschap IsCustomizable als de eigenschap IsManaged controleren. Een oplossingsonderdeel waarbij IsCustomizable en IsManaged false zijn, is aanpasbaar.
De entiteit en het kenmerk hebben meer beheerde eigenschappen naast IsCustomizable Deze beheerde eigenschappen worden niet bijgewerkt als IsCustomizable is ingesteld op false. Dit betekent dat naast het controleren van de afzonderlijke beheerde eigenschap, u ook de eigenschap IsCustomizable moet controleren om te zien of de beheerde eigenschap wordt afgedwongen.