Usar propriedades gerenciadas
Publicado: janeiro de 2017
Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
É possível controlar quais dos componentes da solução gerenciada são personalizáveis, usando as propriedades gerenciadas. Você deve permitir o máximo de personalização possível para esses componentes da solução, que representam entidades de negócios. Isso permite que as organizações personalizem uma solução de acordo com as suas necessidades. Limite ou elimine a personalização de componentes críticos da solução que fornecem a funcionalidade básica da solução, para que ela possa ter suporte e manutenção.
As propriedades gerenciadas destinam-se a proteger a solução contra modificações que podem fazer com que ocorram falhas nela. As propriedades gerenciadas não fornecem o gerenciamento digital de direitos (DRM) ou os recursos de licenciamento da solução ou de controle das pessoas que tem permissão para instalá-la.
Aplicar as propriedades gerenciadas
As propriedades gerenciadas são aplicadas quando a solução não é gerenciada. Essas propriedades gerenciadas terão efeito somente depois que a solução gerenciada for empacotada e instalada em outra organização. Depois que a solução gerenciada tiver sido instalada, não será possível atualizar as propriedades gerenciadas, com exceção de uma atualização da solução pelo fornecedor original.
A maioria dos componentes da solução têm um botão Propriedades gerenciadas ao exibir uma lista dos componentes da solução. É possível exibir ou atualizar as propriedades gerenciadas de um componente da solução ao clicar neste botão. Para acessar as propriedades gerenciadas das soluções que não exibem este botão, selecione Propriedades gerenciadas da lista suspensa Mais ações.
Por padrão, todos os componentes da solução são personalizáveis. Para alterar as propriedades gerenciadas de um componente da solução, clique no botão Propriedades gerenciadas localizado na barra de ferramentas do componente da solução. Todos os componentes da solução têm uma propriedade Pode ser personalizado (IsCustomizable). Contanto que esta propriedade seja verdadeira, um maior número de propriedades específicas para o tipo de componente da solução pode ser especificado. Se você definir a propriedade IsCustomizable.Value para falso, depois que a solução tiver sido instalada como uma solução gerenciada, o componente da solução não será personalizável. A tabela a seguir lista as propriedades gerenciais de cada componente da solução.
|
Componente |
Nome para Exibição |
Propriedade |
|---|---|---|
|
Entidade |
Pode ser personalizado |
|
|
O nome para exibição pode ser modificado |
||
|
Pode ser a entidade relacionada no relacionamento |
||
|
Pode ser a entidade primária no relacionamento |
||
|
Pode estar em um relacionamento muitos para muitos |
||
|
Novos formulários podem ser criados |
||
|
Novos gráficos podem ser criados |
||
|
Novas exibições podem ser criadas |
||
|
Pode modificar quaisquer outras propriedades de uma entidade não representadas por uma propriedade gerenciada |
||
|
Field (Atributo) |
Pode ser personalizado |
|
|
O nome para exibição pode ser modificado |
||
|
Pode alterar o nível de requisito |
Observação RequiredLevel é a única propriedade gerenciada que pode usar a propriedade CanBeChanged. |
|
|
Pode modificar quaisquer outras propriedades de um atributo não representadas por uma propriedade gerenciada |
||
|
Relacionamento de Entidade |
Pode ser personalizado |
|
|
Formulário |
Pode ser personalizado |
SystemForm.IsCustomizable.Value |
|
Gráfico |
Pode ser personalizado |
SavedQueryVisualization.IsCustomizable.Value |
|
Exibir |
Pode ser personalizado |
SavedQuery.IsCustomizable.Value |
|
Conjunto de Opções |
Pode ser personalizado |
|
|
Recurso da Web |
Pode ser personalizado |
WebResource.IsCustomizable.Value |
|
Fluxo de Trabalho |
Pode ser personalizado |
Workflow.IsCustomizable.Value |
|
Assembly |
Pode ser personalizado |
SdkMessageProcessingStep.IsCustomizable.Value |
|
Registro de assembly |
Pode ser personalizado |
ServiceEndpoint.IsCustomizable.Value |
|
Modelo de Email |
Pode ser personalizado |
Template.IsCustomizable.Value |
|
Modelo de Artigo da Base de Dados de Conhecimento |
Pode ser personalizado |
KbArticleTemplate.IsCustomizable.Value |
|
Modelo de Contrato |
Pode ser personalizado |
ContractTemplate.IsCustomizable.Value |
|
Modelo de Mala Direta |
Pode ser personalizado |
MailMergeTemplate.IsCustomizable.Value |
|
Painel |
Pode ser personalizado |
SystemForm.IsCustomizable.Value |
|
Direitos de Acesso |
Pode ser personalizado |
Role.IsCustomizable.Value |
Atualizar propriedades gerenciadas
Depois de lançar a solução gerenciada, é possível decidir se você deseja alterar as propriedades gerenciadas. Você só poderá alterar as propriedades gerenciadas para torná-las menos restritivas. Por exemplo, após o lançamento inicial, você poderá optar por permitir a personalização de uma entidade.
Atualize as propriedades gerenciadas da solução lançando uma atualização para a solução com as propriedades gerenciadas alteradas. A solução gerenciada só pode ser atualizada por outra solução gerenciada associada ao mesmo registro do fornecedor que a solução gerenciada original. Se a atualização incluir uma alteração nas propriedades gerenciadas para torná-las mais restritivas, essas alterações das propriedades gerenciadas serão ignoradas, mas outras modificações na atualização serão aplicadas.
Como o fornecedor original é um requisito para a atualização das propriedades gerenciadas de uma solução gerenciada, todas as soluções não gerenciadas não poderão ser associadas a um fornecedor usado para instalar uma solução gerenciada.
Observação
Isso significa que não será possível desenvolver uma atualização para a solução usando uma organização onde a solução gerenciada está instalada.
Verificar as propriedades gerenciadas
Use a IsComponentCustomizableRequest para verificar se um componente da solução é personalizável. Como alternativa, é possível verificar as propriedades do componente da solução, mas você deve considerar que a determinação final do significado depende dos valores de várias propriedades. Todos os componentes da solução têm uma propriedade IsCustomizable. Quando um componente da solução é instalado como parte de uma solução gerenciada, a propriedade IsManaged será verdadeira. As propriedades gerenciadas são impostas somente para as soluções gerenciadas. Ao verificar as propriedades gerenciadas para determinar se um componente individual da solução é personalizável, verifique as propriedades IsCustomizable e IsManaged. Um componente da solução onde IsCustomizable é falso e IsManaged é falso é personalizável.
A entidade e o atributo têm mais propriedades gerenciadas além de IsCustomizable. Essas propriedades gerenciadas não serão atualizadas se IsCustomizable for definido para falso. Isso significa que além de verificar a propriedade gerenciada individual, você também deve verificar a propriedade IsCustomizable para determinar se a propriedade gerenciada está sendo imposta.
Confira Também
IsComponentCustomizableRequest
Propriedades gerenciadas
Plano para desenvolvimento de solução
Manter soluções gerenciadas
Embalar e distribuir extensões usando soluções
Microsoft Dynamics 365
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais