Exportar uma solução para uma versão específica do Dynamics 365

Publicado: janeiro de 2017

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

Cada nova versão do Microsoft Dynamics 365 conterá os recursos não encontrados em versões anteriores. As soluções que usam novos recursos não podem ser importadas em uma organização da versão anterior. As soluções exportadas de organizações de versões anteriores podem ser importadas para organizações de novas versões.

Depois de atualizar a organização que você usa para definir sua solução, você ainda pode exportar uma solução que tenha como destino uma versão anterior. Quando você seleciona uma versão mais baixa de destino, quaisquer componentes de solução que dependam de recursos introduzidos desde a versão não serão incluídos na solução que você exportar.

Neste tópico

Use uma versão específica como destino ao exportar uma solução

Quais alterações são aplicadas em uma solução exportada para uma versão antiga?

Selecione uma versão de destino programaticamente

Use uma versão específica como destino ao exportar uma solução

Quando você exportar uma solução do Atualização 1 do Microsoft Dynamics CRM Online 2015 ou, opcionalmente, usar como destino a solução para uma versão específica do Dynamics 365. Para o Atualização 1 do Microsoft Dynamics CRM Online 2015, as opções são 7.1 (padrão) e 7.0. Quando você escolher 7.0, quaisquer novos recursos apresentados no Atualização 1 do Microsoft Dynamics CRM Online 2015 não serão incluídos na solução exportada, e quaisquer organizações que ainda estejam usando versões anteriores do CRM 2015 poderão instalar a solução.

Ao exportar sua solução para direcionar uma versão anterior, a exportação do diálogo pode exibir duas possíveis mensagens:

• Esta solução suporta a versão Dynamics 365 de destino.
  Isso significa que os componentes da solução em sua solução não dependem dos recursos ou dos componentes de solução introduzidos desde essa versão.

• Os seguintes componentes são removidos ou modificados como parte da exportação
  Abaixo dessa mensagem, uma tabela lista os itens do componente da solução que foram modificadas ou não foram incluídos na solução exportada.

As informações visíveis no diálogo também podem ser encontradas no arquivo de solução exportado. Quando você exportar uma solução para direcionar uma versão específica, o nome do arquivo especificará a solução de destino usando a convenção de nomenclatura a seguir:Nome da Solução_Número da Versão de Solução_target_CRM_Número da Versão Dynamics 365 de Destino.zip. Por exemplo, uma solução não gerenciada com o nome Solução de Exemplo com a solução versão 2.0 que é exportada para a versão 7.0 de destino terá o nome SampleSolution_2_0_target_CRM_7.0.zip. Quando você extrair os conteúdos deste arquivo compactado, você encontrará um arquivo filteredcomponents.xml contendo o detalhamento dos dados no qual ações são realizadas. Você pode abrir esse arquivo usando o Excel para exibir um relatório de quais componentes de solução foram removidos ou editados.

Quais alterações são aplicadas em uma solução exportada para uma versão antiga?

Iniciando com versões CRM 2013 e Microsoft Dynamics CRM Online do segundo semestre de 2013, cada tipo de componente da solução tem uma propriedade de IntroducedVersion. Esse valor captura o número da versão atual da solução a que o componente da solução estava associado quando foi criado. Todos os componentes da solução apresentados pela Microsoft fazem parte de uma solução de sistema oculta em que o número da versão corresponde à versão do Microsoft Dynamics 365.

Os dados de IntroducedVersion são usados para exportar a solução para corresponder à versão de destino. Isso pode resultar em três ações possíveis:

• Remover
  Os componentes de solução que não existirem na versão de destino ou não contenham dependências em componentes que não possam funcionar com a versão de destino, não serão adicionados à solução.

• Modificar
  Quando um componente de solução tem uma dependência em um componente da solução que é removido, quando possível, o componente da solução será alterado para remover a dependência. Por exemplo, se a definição do formulário fizer referência a um atributo que não exista naquela versão; o formulário será modificado para remover aquela referência. Se o componente da solução não puder ser alterado para remover a dependência, o componente da solução será removido.

• Substituir
  Quando um componente de solução existia na versão de destino mas foi alterado para ter uma dependência em um componente da solução que será removido, aquele componente da solução pode ser substituído pela definição do componente de solução que foi definido para a versão de destino.

Selecione uma versão de destino programaticamente

Para exportar uma solução de forma programática, use o ExportSolutionRequest. Após CRM 2013 e Microsoft Dynamics CRM Online do segundo semestre de 2013, esta mensagem tem uma nova propriedade opcional TargetVersionString que você poderá usar para definir como"7.0.0.0” se desejar exportar para a versão anterior.

Confira Também

Embalar e distribuir extensões usando soluções
Criar, exportar ou importar uma solução não gerenciada
Criar, instalar e atualizar uma solução gerenciada
Manter soluções gerenciadas
Guia de Personalização: Use soluções para suas personalizações

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais