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.

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.

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