Entender como as soluções gerenciadas são mescladas

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Ao preparar a solução gerenciada para a instalação, lembre-se de que uma organização pode ter várias soluções instaladas ou que outras soluções podem ser instaladas no futuro. Crie uma solução que siga as práticas recomendadas, para que a solução não interfira com outras soluções.

Os processos que o Microsoft Dynamics 365 usa para mesclar as personalizações enfatizam a manutenção da funcionalidade da solução. Embora todos os esforços sejam feitos para preservar a apresentação, algumas incompatibilidades entre as personalizações podem exigir que a resolução computada altere alguns detalhes da apresentação para manter a funcionalidade de personalização.

Neste tópico

Mesclar personalizações de formulário

Mesclar personalizações de navegação (SiteMap)

Mesclar as opções do conjunto de opções

Mesclar personalizações de formulário

As únicas personalizações de formulário que precisam ser mescladas são aquelas que são executadas nos formulários de entidades que já estejam na organização. Geralmente, isso significa que as personalizações de formulário somente precisam ser mescladas quando a solução personalizar os formulários incluídos para as entidades criadas durante a instalação do Microsoft Dynamics 365. Uma maneira de evitar a necessidade de mesclar formulários é oferecer novos formulários para todas as entidades do Microsoft Dynamics 365. Não haverá a necessidade de mesclar os formulários das entidades personalizadas, a menos que você esteja criando uma solução que atualize ou modifique uma solução gerenciada existente que criou as entidades personalizadas e seus formulários.

Quando uma solução é empacotada como uma solução gerenciada, as definições de formulário armazenadas em FormXML são comparadas com o FormXML original e somente as diferenças são incluídas na solução gerenciada. Quando a solução gerenciada é instalada em uma nova organização, as diferenças de personalização de formulários são mescladas com o FormXML do formulário existente para criar uma nova definição de formulário. Esta nova definição de formulário é o que o usuário visualiza e o que o personalizador de sistema pode alterar. Quando a solução gerenciada é desinstalada, somente os elementos de formulário encontrados na solução gerenciada são removidos.

Ao adicionar novos elementos a um formulário que deve ser mesclado, é recomendável incluir os novos elementos nos novos elementos do contêiner (guias ou seções). Todas as adições ao contêiner serão acrescentadas ao final do contêiner. Por exemplo, os campos adicionados a uma seção serão posicionados ao final da seção. Espera-se que um personalizador que esteja instalando uma solução modifique o formulário para reorganizar os elementos após a sua instalação.

As soluções gerenciadas que contêm formulários que usam novos direitos de acesso dependem desses direitos. É necessário incluir esses direitos de acesso com a solução gerenciada. Se houver direitos de acesso associados a um formulário que não estejam na organização na qual a solução gerenciada está sendo instalada, não ocorrerá uma falha na instalação, mas os formulários poderão não ser associados aos direitos de acesso. Quando a solução gerenciada é desinstalada, todos os direitos de acesso incluídas com ela serão removidos. Todos os formulários fora da solução gerenciada não poderão ser mais associados aos direitos de acesso.

Mesclar personalizações de navegação (SiteMap)

Quando uma solução é empacotada como gerenciada, o XML do SiteMap é comparado com o XML do SiteMap original XML e com todas as outras personalizações feitas ao SiteMap. Somente as diferenças são incluídas na solução gerenciada. Estas diferenças incluem itens que são modificados, movidos, adicionados ou removidos. Quando a solução gerenciada é instalada em uma nova organização, as alterações ao SiteMap são mescladas com o XML do SiteMap encontrado para a organização no local onde a solução gerenciada estiver sendo instalada. Uma nova definição de SiteMap é o que os usuários visualizarão.

Neste momento, um personalizador pode exportar o SiteMap para uma solução não gerenciada e essa definição do SiteMap incluirá todos os elementos do SiteMap ativo. Um personalizador pode então modificar o SiteMap e importá-lo novamente como uma personalização não gerenciada. Posteriormente, se a solução gerenciada for desinstalada, o XML do SiteMap que foi importado com a solução gerenciada será referenciado para remover as alterações introduzidas com essa solução gerenciada. Um novo SiteMap ativo é então calculado.

Sempre que um novo elemento visível é adicionado ao SiteMap, ele será exibido na parte inferior do contêiner a que pertence. Por exemplo, uma nova área aparece na parte inferior da área de navegação. Para posicionar os elementos adicionados, será necessário exportar o SiteMap, editá-lo para definir a posição exata e importá-lo novamente como uma solução não gerenciada.

Mesclar as opções do conjunto de opções

Cada nova opção do conjunto de opções é inicializada com um valor inteiro atribuído, que inclui um prefixo do valor da opção. O prefixo do valor da opção é um conjunto de cinco dígitos, acrescentado ao valor da opção. Um prefixo do valor de opção é gerado com base no prefixo de personalização dos fornecedores de soluções, mas pode ser definido para qualquer valor. O prefixo do valor da opção ajuda a diferenciar as novas opções do conjunto de opções criadas no contexto de um fornecedor de soluções específico e reduz a oportunidade de colisões dos valores da opção. Usar o prefixo do valor da opção é recomendável, mas não é necessário.

Uma solução gerenciada geralmente atualiza ou adiciona opções dos conjuntos de opções que já estão na organização, por exemplo, os conjuntos de opções da conta, Categoria ou Setor. Quando uma solução gerenciada altera as opções disponíveis em um conjunto de opções, todas as opções definidas na solução gerenciada estarão disponíveis na organização. Quando a solução gerenciada é desinstalada, as opções do conjunto de opções serão retornadas para o seu estado original.

Confira Também

Plano para desenvolvimento de solução
Usar propriedades gerenciadas
Embalar e distribuir extensões usando soluções
Personalizar formulários de entidade
Alterar navegação do aplicativo usando o SiteMap

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais