Usar soluções para suas personalizações

Publicado: fevereiro de 2017

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

Todas as personalizações realizadas no Microsoft Dynamics 365 são executadas no contexto de uma solução. Caso não tenha certeza sobre o que é uma solução, consulte O que precisa saber sobre soluções.

Neste tópico

A solução padrão

Navegar para uma solução específica

Usar o gerenciador de soluções

Criar sua própria solução

Importar, atualizar e exportar soluções

Opções de configurações para exportação da solução

Avisos de privacidade

A solução padrão

Ao personalizar o Microsoft Dynamics 365, você normalmente trabalha com a solução padrão. Para abrir a solução padrão, navegue para Configurações > Personalizações e selecione Personalizar o Sistema.

Cada organização tem uma solução padrão e algumas propriedades específicas. A solução padrão contém todos os componentes de solução disponíveis na sua organização. Outras soluções podem incluir um subconjunto de componentes de solução visíveis na solução padrão, mas a solução padrão contém todos eles.

Navegar para uma solução específica

Se sua organização já possui uma solução específica que você precisa trabalhar, isto é como você pode encontrá-la. Para criar uma nova solução, consulte Criar sua própria solução.

Abrir uma solução não gerenciada

1. Vá para Configurações > Personalizações.

2. Escolha Soluções.

3. Clique duas vezes na solução não gerenciada que você deseja trabalhar para abri-la.

Quando você estiver na solução, verá os componentes da solução.Para obter mais informações:Adicionar componentes da solução

Usar o gerenciador de soluções

No gerenciador de soluções, é possível navegar por uma hierarquia de nós usando o painel de navegação no lado esquerdo conforme mostrado na seguinte captura de tela:

Ao selecionar cada nó, você pode ver uma lista dos componentes da solução. As ações disponíveis na barra de comandos irão alterar dependendo do contexto do nó selecionado e se a solução é a solução padrão ou uma solução gerenciada. Com soluções não gerenciadas que não são a solução padrão, você pode usar o comando Adicionar Existente para obter os componentes da solução que não estiverem na solução.

Com soluções gerenciadas, não há comandos disponíveis e você verá a mensagem:

Não é possível editar diretamente os componentes em uma solução gerenciada. Se as propriedades gerenciadas dos componentes da solução estiverem definidas para permitir personalizações, você poderá editá-las na área Personalizações ou em outra solução não gerenciada..

É necessário localizar o componente da solução na solução padrão e tentar editá-la ou adicionar para outra solução não gerenciada que você criou. O componente da solução não pode ser personalizável.Para obter mais informações:Propriedades gerenciadas

Várias personalizações que você desejará fazer envolvem entidades. Você pode expandir o nó Entidades para mostrar uma lista de todas as entidades no sistema que pode ser personalizadas de alguma forma. É possível expandir mais cada entidade para ver os componentes das soluções que fazem parte da entidade como mostrado na entidade da conta na seguinte captura de tela:

Para obter detalhes sobre a personalização dos componentes da solução individuais localizados no gerenciador de soluções, consulte os seguintes tópicos:

• Para a entidade, relacionamentos de entidades, personalizações de campos e mensagem, consulte Criar e editar metadados.

• Para formulários de entidade, consulte Criar e desenvolver formulários.

• Para processos, consulte Criar e editar processos.

• Para regras de negócios, consulte Criar e editar regras de negócios.

Criar sua própria solução

Como a solução padrão contém todos os componentes de soluções, é mais fácil apenas para localizar apenas os componentes de solução que você personalizou ao criar uma solução separada e criar todas as personalizações nesse local. Isso também facilita a exportação de um backup da sua solução como um arquivo menor. Se você optar por isso, deve sempre lembrar de adicionar alguns dos componentes de solução para editar essa solução. Ao criar novos componentes da solução, você deve sempre criá-los no contexto da solução. Dessa forma, o prefixo de personalização do fornecedor da solução será aplicado de maneira uniforme. Depois de criar os componentes da solução na sua solução ou adicionar componentes de solução existentes à solução, você também poderá editar na solução padrão se desejar.

1. Navegue para Configurações > Soluções.

2. Selecione Novo e preencha os campos exigidos da solução

   Campo	Descrição
   Nome para Exibição	O nome exibido na lista de soluções. Você pode modificar isso depois.
   Nome	O nome exclusivo da solução. Isso é gerado usando o valor inserido no campo Nome de Exibição. Você pode editar antes de salvar a solução, mas depois de salvar a solução não será possível alterar.
   Publicador	Você pode selecionar esse fornecedor padrão ou criar um novo fornecedor. A menos que você pretenda distribuir a solução, deve apenas usar o fornecedor padrão para sua organização.
   Versão	Insira um número da versão da solução. Isso só é importante se você exportar uma solução. O número da versão será incluído no nome do arquivo ao exportar a solução.

3. Escolha Salvar.

Depois de salvar a solução, talvez você deseje adicionar informações nos campos que não são necessários. Essas etapas são opcionais. Use o campo Descrição para descrever a solução e escolher um recurso Web HTML como uma Página de Configuração da solução. A página de configuração normalmente é usada pelos ISVs que distribuem soluções. Quando isso é definido, um novo nó Configuração aparece abaixo do nó Informações para exibir esse recurso Web. Os desenvolvedores usarão essa página para incluir instruções ou controles para permitir a definição dos dados de configuração ou iniciar a solução.

Adicionar componentes da solução

Depois de criar sua solução, não irá conter esses componentes da solução. É possível criar novos componentes de solução ou usar o botão Adicionar Existente no menu da lista para adicionar todos os componentes da solução padrão.

Depois que você fizer isso, poderá ver uma caixa de diálogo Componentes Necessários Ausentes.

Essa caixa de diálogo alerta que o componente da solução tem dependências em outros componentes da solução. Se você selecionar Não, não incluir os componentes necessários, a solução pode falhar se importar para outra organização em que todos os componentes necessários não existirem. Se a importação da solução for bem-sucedida, o comportamento em outra solução pode não ser idêntico à organização original porque os componentes são configurados de forma diferente daqueles na solução de origem.

Geralmente, é mais seguro incluir os componentes necessários se você pretende exportar a solução para outra organização. Se você não adicionar esses componentes ao adicionar um componente de solução individual, é possível voltar mais tarde, selecionar o componente da solução adicionada e selecionar Adicionar componentes necessários a partir do menu.

Se não quiser exportar a solução ou se pretende apenas exportar como uma solução não gerenciada e importar de volta para a mesma organização, não é necessário incluir componentes necessários. Se você exportar a solução, não verá outro aviso indicando que alguns componentes necessários estão ausentes. Se você planeja importar somente essa solução de volta para a mesma organização, PODE ignorar este aviso. As etapas para editar a navegação do aplicativo ou a faixa de opções sem usar uma ferramenta de edição de terceiros que você irá exportar a solução de volta para a mesma organização.

Importar, atualizar e exportar soluções

A frequência da importação, atualização ou exportação das soluções podem depender do tamanho da sua organização, suas práticas de desenvolvimento internas e se você está desenvolvendo uma solução que deve ser distribuída como uma solução gerenciada.

• Se você tiver uma pequena empresa com poucas personalizações, e for o único fornecedor, pode nunca exportar ou importar soluções, exceto para exportar periodicamente a solução padrão para criar um backup ou se escolher usar ou comprar uma solução gerenciada fornecida por outra pessoa.

• Algumas organizações solicitarão a criação das personalizações por uma empresa externa. Nesse caso, exportarão todas as personalizações que tiverem e enviarão para a empresa externa. A empresa desenvolverá e testará personalizações e as enviará de volta para a organização para ser importada.

• Grandes organizações podem ter várias equipes de pessoas personalizando o sistema. Elas podem ter uma organização separada apenas para desenvolvimento e personalizações. Essas organizações frequentemente têm organizações de teste separadas e organizações UAT (Teste de Aceitação do Usuário), além de uma organização de produção que todos na organização utilizam. Essas organizações dependem da exportação e importação de personalizações de uma organização para a próxima no processo de criação, teste e verificação das soluções.

A estratégia que você deve escolher depende das suas necessidades. Alguns aspectos importantes para lembrar:

• Você não pode exportar a solução padrão como uma solução gerenciada.

• Não suportamos a importação de uma solução padrão retirada de uma implantação local para uma organização do Dynamics 365 (online) ou uma solução padrão retirada de uma organização do Dynamics 365 (online) para uma implantação local. Suportamos a importação de soluções personalizadas entre esses tipos de implantação, mas não soluções padrão.

• Ao exportar uma solução gerenciada, não é possível importar de volta para a mesma organização que você usou para importar.

• Exporte somente uma solução como uma solução gerenciada quando você pretende distribuir.

• Nunca importe uma solução não gerenciada a menos que você deseja aceitar todas as personalizações nela e permitir que algumas dessas personalizações substituam todas as personalizações que você criou anteriormente.

• As soluções não podem excluir qualquer coisa. Importar uma solução não gerenciada pode substituir personalizações existentes, mas não pode removê-las totalmente. Por exemplo, se você criar um campo personalizado para uma entidade e importar uma solução contendo a definição dessa entidade que não tem o campo personalizado, o campo personalizado criado ainda estará lá. Além disso, qualquer alteração definida na solução importada estará lá.

• Não é possível importar uma entidade personalizada que possua o mesmo nome de uma entidade existente. No entanto, o Microsoft Dynamics 365 permite nomes para exibição duplicados.

• Só é possível importar itens para os quais você tenha acesso para criação, leitura e atualização no nível da organização.

• Você deve ter o direito de acesso Administrador do Sistema para importar direitos de acesso, configurações da organização, etapas de processamento de mensagens de SDK e assemblies de plug-in.

• Se você importar personalizações que incluem um idioma não instalado no sistema, todos os rótulos definidos nas personalizações usarão como padrão o idioma base do sistema Microsoft Dynamics 365 do qual as personalizações foram importadas.

• Todos os direitos de acesso importados serão anexados à divisão raiz.

• Se um direito de acesso importado tiver sido originado no mesmo sistema Dynamics 365, todas as alterações aplicadas a esse direito de acesso serão mescladas. Todos os privilégios de entidades do sistema relacionadas ao direito de acesso serão substituídos por privilégios definidos pelo direito de acesso que está sendo importado.

Importar soluções

Você pode importar soluções manualmente usando as etapas abaixo. Somente importe soluções obtidas de uma fonte confiável. Personalizações podem incluir código que pode enviar dados para fontes externas.

1. Vá para Configurações > Soluções.

2. No menu da lista de soluções, selecione Importar.

3. Na caixa de diálogo Importar Solução, a etapa Selecionar Pacote de Soluções, procure pelo arquivo compactado (.zip ou .cab) que contém a solução que você deseja importar.

4. Selecione Próximo

5. Você pode visualizar informações sobre a solução antes de selecionar Importar.

6. Talvez seja necessário aguardar alguns momentos enquanto a importação da solução é concluída. Se tiver êxito, será possível visualizar os resultados e escolher Fechar.

Se você tiver importado qualquer alteração que exigem publicação, você deve publicar as personalizações antes que possam ser disponibilizadas. Consulte Publicando personalizações para obter mais informações.

Se a importação não for bem-sucedida, você verá um relatório mostrando avisos ou erros que foram capturados. Você pode selecionar Baixar arquivo de log para obter detalhes sobre o motivo da falha na importação. A causa mais comum para uma falha na importação da solução é que a solução não contém alguns dos componentes da solução exigidos.

Ao baixar o arquivo de log, você encontrará um arquivo XML para poder abrir usando o Microsoft Office Excel e exibir o conteúdo.

Atualizar soluções

Existem situações em que você deseja instalar uma atualização para uma solução gerenciada existente. O procedimento é semelhante a instalar uma nova solução gerenciada, a não ser que você obtenha opções diferentes. Se você estiver atualizando uma solução que obteve de outra pessoa, será preciso obter orientação o fornecedor de soluções sobre quais opções você deve escolher.

1. Vá para Configurações > Soluções.

2. No menu da lista de soluções, selecione Importar.

3. Na caixa de diálogo Importar Solução, a etapa Selecionar Pacote de Soluções, procure pelo arquivo compactado (.zip ou .cab) que contém a solução que você deseja atualizar.

4. Selecione Próximo

5. É possível visualizar informações sobre a solução antes de selecionar Próximo. Esta página mostrará uma barra amarela dizendo Este pacote de soluções contém uma atualização para uma solução que já está instalada.

6. Você tem as seguintes opções:

   • Manter personalizações (recomendado)

     A seleção dessa opção preservará todas as personalizações não gerenciadas realizadas em componentes, mas também significará que algumas das atualizações incluídas na solução não terão efeito.

   • Substituir personalizações

     Selecionar esta opção substitui quaisquer personalizações não gerenciadas executadas anteriormente em componentes incluídos nesta solução. Todas as atualizações incluídas nesta solução terão efeito.

   Escolha a opção adequada e selecione Próximo.

7. Talvez seja necessário aguardar alguns momentos enquanto a importação da solução é concluída. Se tiver êxito, será possível visualizar os resultados e escolher Fechar.

Se você tiver importado qualquer alteração que exigem publicação, você deve publicar as personalizações antes que possam ser disponibilizadas. Consulte Publicando personalizações para obter mais informações.

Os fornecedores de soluções podem solicita a exportação de personalizações não gerenciadas existentes, atualização da sua solução gerenciada usando a opção para substituir personalizações e reimportar suas personalizações não gerenciadas. Isso ajudará a garantir que as alterações que estão aguardando sejam aplicadas para preservar suas personalizações.

Exportar soluções

Recomendamos exportar suas personalizações não gerenciadas periodicamente para que você tenha um backup em caso que algo aconteça. Você não poderá exportar soluções gerenciadas.

1. Vá para Configurações > Soluções.

2. Na lista, selecione a solução que deseja exportar e escolha Exportar.

3. Na etapa Publicar personalizações, você será lembrando que somente personalizações publicadas são exportadas, e terá a opção de Publicar todas personalizações antes de selecionar Próximo.

4. Se a solução contém qualquer componentes ausente necessários, você verá a etapa 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.

5. Na etapa Exportar Configurações do Sistema (Avançado), você pode escolher determinadas configurações do sistema para incluir na solução. Se a sua solução depende de qualquer um dos grupos das configurações do sistema, selecione-os e escolha Próximo.

   Consulte Opções de configurações para exportação da solução para obter detalhes sobre as configurações que serão incluídas com cada opção.

6. Na etapa Tipo de Pacote, você precisará escolher se deve exporte a solução como uma solução Não Gerenciada ou Gerenciada.

7. A próxima etapa permite escolher uma solução de destino para uma versão específica do Dynamics 365. Essa opção é geralmente usada pelos ISVs que desejam exportar uma solução compatível com uma versão anterior. A menos que você pretenda importar essa solução para uma organização que não está atualizadas para a mesma versão da organização que você está usando, aceite o padrão.

   Para obter mais informações, consulte o tópico SDK MSDN: Exportar uma solução para uma versão específica do Dynamics 365.

8. Selecione Exportar para baixar o arquivo de soluções.

O comportamento exato para baixar arquivos varia entre navegadores.

Opções de configurações para exportação da solução

A tabela a seguir mostra as opções disponíveis ao exportar uma solução:

Avisos de privacidade

Ao habilitar uma solução, você autoriza o compartilhamento dos seus dados com um sistema externo. Os dados importados de sistemas externos para o Microsoft Dynamics 365 (online) estão sujeitos à nossa política de privacidade, que pode ser acessada aqui.

Você pode importar e exportar as soluções para e do Microsoft Dynamics 365 (online). Ao fazer isso, as soluções, que podem conter informações pessoais, são transferidas por meio de uma conexão segura entre o seu computador e os servidores da Microsoft. Por sua vez, o código de terceiros importado para o Dynamics 365 (online) poderá transmitir dados do cliente para um sistema externo (por exemplo, o InsideView) ou configurar/expandir entidades que são sincronizadas (ou seja, exportadas) para outros sistemas externos controlados por terceiros que não sejam a Microsoft.
Se uma solução a ser importada se propõe a transmitir dados do cliente para fora dos limites de segurança do Dynamics 365 (online), os administradores serão convidados a verificar os tipos de dados do cliente que serão chamados pelo serviço/software/aplicativo antes de carregar o código de terceiros em sua instância do Dynamics 365 (online).
A extração de dados do cliente por serviços/software/aplicativos ou soluções de terceiros é controlada pelo cliente, não pela Microsoft. O destino final e as políticas de privacidade aplicáveis aos pontos de dados extraídos por essas soluções externas são controlados pelo administrador; é recomendável que as políticas aplicáveis sejam revisadas pelos terceiros responsáveis pela operação desses serviços/software/aplicativos.

Confira Também

Introdução à personalização
Use soluções segmentadas e patches para simplificar atualizações de solução
Privilégios necessários para personalização
Conceitos de personalização
Visão geral da personalização
White paper: padrões e princípios de Construtores de soluções

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais