Criar, exportar ou importar uma solução não gerenciada

 

Publicado: janeiro de 2017

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

Além de ser um pré-requisito para criar uma solução gerenciada, uma solução não gerenciada é útil como uma forma de agrupar um conjunto de personalizações não gerenciadas em um conjunto que pode ser transportado entre organizações.

Para obter mais informações, consulte: TechNet: Usar soluções para suas personalizações.

Neste tópico

Criar uma solução não gerenciada

Exporte a solução não gerenciada.

Importar uma solução gerenciada

Criar uma solução não gerenciada

Cada solução requer um fornecedor. Se você não pretende distribuir sua solução, você pode usar o fornecedor padrão já criado para sua organização. Para obter informações sobre como criar um fornecedor de soluções, consulte Crie um fornecedor de soluções.

A tabela a seguir lista os campos e as descrições que uma solução contém.

Rótulo do Campo	Descrição
Nome de Exibição	O nome da solução.
Nome	O Microsoft Dynamics 365 gera um nome único que é baseado no Nome para Exibição Você pode editar o nome único. O nome único deve conter apenas caracteres alfanuméricos ou o caractere sublinhado.
Publicador	Use a pesquisa do Fornecedor para associar a solução ao fornecedor.
Versão	Especifique uma versão com o seguinte formato: maior.menor.criação.revisão, por exemplo: 1.0.0.0.
Página de configuração	Se você incluir um recurso da Web HTML na sua solução, você pode usar essa consulta para adicioná-la como sua página de configuração atribuída. Para obter mais informações:Use a página de Configuração da Solução
Descrição	Use este campo para incluir todos os detalhes relevantes sobre a sua solução.

Depois de criar uma solução não gerenciada, é possível adicionar componentes de solução criado-os no contexto dessa solução ou adicionando componentes de soluções existentes. Para obter mais informações sobre como criar uma solução programaticamente, consulte Criar uma solução.

Crie um fornecedor de soluções

Se você deseja distribuir soluções gerenciadas, você deve criar umPublisher. A tabela a seguir lista os campos e as descrições que um Publisher contém.

Etiqueta	Descrição
Nome de Exibição	O nome de exibição no campo de pesquisa do Fornecedor na solução.
Nome	O Microsoft Dynamics 365 gera um nome único que é baseado no Nome para Exibição O nome único deve conter apenas caracteres alfanuméricos ou o caractere sublinhado. Observação Use o Unique Name para identificar com exclusividade o Publisher. Soluções gerenciadas que compartilham o mesmo fornecedor podem atualizar umas as outras.
Descrição	Use este campo para incluir todos os detalhes relevantes sobre a sua solução.
Prefixo	O prefixo de personalização ajuda a identificar qual fornecedor adicionou um componente de solução. Por exemplo, o prefixo é acrescentado ao nome lógico de todas as entidades ou atributos criados no contexto de uma solução associada a esse fornecedor. O prefixo deve estar entre dois e oito caracteres longos e deve conter apenas caracteres alfanuméricos. Não pode começar com ‘mscrm’.
Prefixo de Valor de Opção	Esse valor ajudar a separar as opções de separação que você adicione aos conjuntos de opções para oferecer suporte para opções mescladas. Um valor é gerado automaticamente com base no texto do Prefixo para ajudar a torná-lo mais exclusivo. O valor deve ser entre 10,000 e 99,999. Para obter mais informações:Mesclar as opções do conjunto de opções
Detalhes do Contato	Use estes campos para adicionar as informações que irão permitir que as pessoas instalem a solução para contatá-lo.

Para obter informações sobre como criar um fornecedor programaticamente, consulte Criar um fornecedor.

Use a página de Configuração da Solução

A página de configuração da solução fornece uma tela que você pode usar para exibir as informações ou para permitir que os clientes executem ações no contexto de sua solução. Defina a página de configuração usando o campo de consulta da Página de Configuração para selecionar um recurso Web da página da Web (HTML) incluído a solução. Isso fará com que um novo nó de Configuração apareça na janela de Solução abaixo das Informações e acima do nó de Componentes . O nó de Configuração exibirá o recurso da Web que você definir.

Você pode usar a página de configuração da solução para exibir controles que configurem sua solução. Por exemplo, você pode fornecer algumas entidades em sua solução que controlem o comportamento da sua solução. Usando o ponto de extremidade OData para o Microsoft Dynamics 365, você pode fornecer controles personalizados na página de recursos da Web para atualizar os dados dessas entidades.

Exporte a solução não gerenciada.

Convém exportar uma solução não gerenciada nas seguintes situações:

• É preciso editar determinado conteúdo XML no arquivo customizations.xml, por exemplo, talvez você queira editar o Mapa do Site ou criar faixas de opções personalizadas.

• Convém transportar sua solução não gerenciada de uma organização para outra.

• Convém criar um backup do seu conjunto atual de personalizações.

Exportar uma solução não gerenciada criará um arquivo compactado (zipado) que pode ser importado posteriormente em outra organização ou na mesma organização.

Somente as personalizações publicadas são incluídas quando você exporta uma solução, então certifique-se de publicar quaisquer alterações antes de exportar uma solução.

Quando você exportar uma solução usando o aplicativo web, caso a sua solução contenha quaisquer componentes necessários ausentes, será exibida a etapa de Componentes Necessários Ausentes . Você pode ignorar este aviso somente se pretende importar como uma solução não gerenciada de volta para a organização original. Caso contrário, siga as instruções na caixa de diálogo para cancelar a exportação e adicionar os componentes necessários.

Use a mensagem ExportSolutionRequest para exportar programaticamente uma solução.Para obter mais informações:Exportar ou empacotar uma solução

Quando você exporta uma solução usando o aplicativo web, na etapa Exportar Configurações do Sistema (Avançado), você pode selecionar quais configurações do sistema serão incluídas em sua solução. Essas opções estão disponíveis para desenvolvedores usando o ExportSolutionRequest pelos membros disponíveis na solicitação. Consulte os comentários da solicitação para obter detalhes sobre quais as configurações são incluídas.

É possível escolher uma versão de destino ao exportar uma solução. É possível exportar uma solução que seja compatível com versões anteriores.Para obter mais informações:Exportar uma solução para uma versão específica do Dynamics 365.

Importar uma solução gerenciada

Convém exportar uma solução não gerenciada nas seguintes situações:

• Você deseja transportar um conjunto de personalizações de uma organização para outras, e você deseja permitir que os componentes da solução sejam alterados.

• Você deseja restaurar ou reverter um conjunto anterior de definições de componentes de solução

Importar uma solução não gerenciada é um processo aditivo. Importar uma versão anterior de uma solução gerenciada não removerá os componentes da solução incluídos em uma nova versão. Entretanto, a definição das propriedades de componente da solução será substituída com a definição incluída na último solução não gerenciada que você importar.

Importante

As alterações aplicadas pela importação de uma solução não gerenciada não podem ser desinstaladas. Não instale uma solução não gerenciada caso você queira reverter as alterações.

Essa operação é executada programaticamente usando a mensagem de ImportSolutionRequest . É possível escrever código para executar essa mensagem de maneira assíncrona.Para obter mais informações:Executar mensagens em segundo plano (de maneira assíncrona). Você pode acompanhar o progresso da importação ou gerar um relatório de sucesso da importação usando a entidade ImportJob.Para obter mais informações:Instalar ou atualizar uma solução

Importante

A instalação de uma solução ou a publicação de personalizações pode interferir na operação normal do sistema. É recomendável agendar importação da solução quando tiver menos interrupção para os usuários.

Tamanho máximo de solução para importar

Para o Microsoft Dynamics 365 (online), o tamanho máximo de uma solução é de 29.296 MB.

Para organizações no local, o tamanho máximo da solução padrão é de 6 MB, mas isso pode ser aumentado conforme necessário.

Altere o tamanho máximo permitido editando o elemento <httpRuntime> no arquivo web.config do aplicativo. Edite os atributos de executionTimeout e de maxRequestLength para permitir o tamanho necessário. Após concluir a instalação da solução, você pode definir-la para o tamanho desejado.

Confira Também

Plano para desenvolvimento de solução
Embalar e distribuir extensões usando soluções
Customization solutions file schema
Criar, instalar e atualizar uma solução gerenciada
Desinstalar ou excluir uma solução

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais