Använda hanterade egenskaper
Du kan styra vilka komponenter i en hanterad lösning som är anpassningsbara med hjälp av hanterade egenskaper. Som standard kan alla egna komponenter anpassas. Varje komponent har en Kan anpassasegenskap (IsCustomizable). Så länge detta egenskapsvärde är "sant" (true) kan fler egenskaper som är specifika för komponenttypen anges. Om du anger egenskapen IsCustomizable.Value som "falskt" (false) kommer komponenten inte att kunna anpassas efter det att lösningen har installerats som en hanterad lösning.
Hanterade egenskaper säkerställer att endast en lösning från samma utgivare kan ändra komponenten. Hanterade egenskaper påverkar endast hanterade komponenter och framtr det inte i utvecklingsmiljöer där komponenten fortfarande är ohanterad. Användning av IsCustomized hanterade egenskapen är avsedd att säkerställa att inget annat lösningslager från någon annan utgivare och inga aktiva anpassningar kan göras på komponenten när den har installerats som en hanterad lösning.
Följande tabell listar några hanterade egenskaper för en undergrupp av tillgängliga lösningskomponenter.
| Komponent | Visningsnamn | Property |
|---|---|---|
| Enhet | Kan anpassas | IsCustomizable.Value |
| Entity | Visningsnamn kan ändras | IsRenameable.Value |
| Entity | Kan vara relaterad entitet i relation | CanBeRelatedEntityInRelationship. – Herr talman,Value(Endast läsning) |
| Entity | Kan vara primär entitet i relation | CanBePrimaryEntityInRelationship. – Herr talman,Value(Endast läsning) |
| Entity | Kan ingå i flera-till-flera-relation | CanBeInManyToMany. – Herr talman,Value(Endast läsning) |
| Entity | Nya formulär kan skapas | CanCreateForms.Value |
| Entity | Nya diagram kan skapas | CanCreateCharts.Value |
| Entity | Nya vyer kan skapas | CanCreateViews.Value |
| Entity | Det går att ändra andra entitetsegenskaper som inte representeras av en hanterad egenskap | CanModifyAdditionalSettings.Value |
| Enhet | Kan skapa attribut | CanCreateAttributes.Value |
| Fält (attribut) | Kan anpassas | IsCustomizable.Value |
| Fält (attribut) | Visningsnamn kan ändras | IsRenameable.Value |
| Fält (attribut) | Kan ändra obligatorisk nivå | RequiredLevel.CanBeChangedKommentar: RequiredLevelär den enda hanterade egenskapen som använder egenskapen CanBeChanged. |
| Fält (attribut) | Det går att ändra andra attributegenskaper som inte representeras av en hanterad egenskap | CanModifyAdditionalSettings.Value |
| Enhetsrelation | Kan anpassas | IsCustomizable.Value |
| Formulär | Kan anpassas | SystemForm.IsCustomizable.Value |
| Diagram | Kan anpassas | SavedQueryVisualization.IsCustomizable.Value |
| Visning | Kan anpassas | SavedQuery.IsCustomizable.Value |
| Alternativuppsättning | Kan anpassas | IsCustomizable.Value |
| Webbresurs | Kan anpassas | WebResource.IsCustomizable.Value |
| Workflow | Kan anpassas | Workflow.IsCustomizable.Value |
| Workflow | Är anpassat bearbetningssteg tillåtet för andra utgivare | Workflow.IsCustomProcessingStepAllowedForOtherPublishers.Value |
| Paket | Kan anpassas | SdkMessageProcessingStep.IsCustomizable.Value |
| Monteringsregistrering | Kan anpassas | ServiceEndpoint.IsCustomizable.Value |
| E-postmall | Kan anpassas | Template.IsCustomizable.Value |
| KB-artikelmall | Kan anpassas | KbArticleTemplate.IsCustomizable.Value |
| Kontraktmall | Kan anpassas | ContractTemplate.IsCustomizable.Value |
| Dokumentkopplingsmall | Kan anpassas | MailMergeTemplate.IsCustomizable.Value |
| Instrumentpanel | Kan anpassas | SystemForm.IsCustomizable.Value |
| Säkerhetsroller | Kan anpassas | Role.IsCustomizable.Value |
| Systemformulär | Kan tas bort | CanBeDeleted.Value |
| Systemfråga | Kan tas bort | CanBeDeleted.Value |
Arbetsflöde Är anpassat bearbetningssteg tillåtet för andra utgivare
Den här hanterade egenskapen styr om plugin-steg som registrerats av tredje part för meddelanden som skapats av anpassade processåtgärder ska köras. Standardvärdet är false, vilket innebär att plugin-steg som registrerats och som inte använder samma utgivare inte körs. Om det är true tillåter utgivaren av den anpassad processsåtgärden att steg för registrering av registrerade plugin-program körs.
Uppdatera hanterade egenskaper
När du har släppt din hanterade lösning kanske du vill ändra de hanterade egenskaperna. Du kan endast ändra hanterade egenskaper för att göra dem mindre restriktiva. Efter ditt första släpp kan du till exempel välja att tillåta anpassning av en entitet.
Du uppdaterar hanterade egenskaper för lösningen genom att släppa en uppdatering av lösningen med de ändrade hanterade egenskaperna. Dina hanterade lösning kan bara uppdateras av en annan hanterad lösning som associeras med samma utgivarpost som den ursprungliga hanterade lösningen. Om uppdateringen innehåller en ändring av hanterade egenskaper i syfte att göra dem mer restriktiva ignoreras dessa hanterade egenskapsändringar, men andra ändringar i uppdateringen tillämpas.
Eftersom den ursprungliga utgivaren är ett krav för att uppdatera hanterade egenskaper för en hanterad lösning kan en icke-hanterad lösning inte associeras med en utgivare som har använts för att installera en hanterad lösning.
Kommentar
Detta innebär att du inte kommer att kunna utveckla en uppdatering för din lösning med hjälp av en organisation där din hanterade lösning har installerats.
Kontrollera hanterade egenskaper
Använd IsComponentCustomizableRequest för att kontrollera om en komponent är anpassningsbar. Du kan också kontrollera egenskaperna för komponenten, men du måste tänka på att den slutliga bestämningen av innebörden beror på värdena hos flera egenskaper. Respektive komponent har en IsCustomizable-egenskap. När en komponent installeras som en del av en hanterad lösning blir IsManaged-egenskapen "sann" (true). Hanterade egenskaper framtvingas endast för hanterade lösningar. När du kontrollerar hanterade egenskaper för att avgöra om en enskild komponent är anpassningsbar, måste du kontrollera både egenskapen IsCustomizableoch egenskapen IsManaged. En komponent där IsCustomizable är falskt (false) och IsManaged är falskt (false) är anpassningsbar.
Entiteten och attributet har fler hanterade egenskaper utöver IsCustomizable. Dessa hanterade egenskaper uppdateras inte om IsCustomizable har värdet "falskt" (false). Detta betyder att du, förutom att kontrollera den enskilda hanterade egenskapen, även måste kontrollera egenskapen IsCustomizable för att se om den hanterade egenskapen framtvingas.