Usar soluções segmentadas e patches para exportar ativos da entidade selecionados

Este tópico se aplica ao Dynamics 365 Customer Engagement (on-premises). Para a versão deste tópico para o Power Apps, consulte: Usar soluções segmentadas e patches

Para ganhar um maior controle sobre o que você distribui em soluções e em patches da solução, use a segmentação da solução. A segmentação de solução permite exportar soluções com ativos da entidade selecionados, como campos, formulários e exibições da entidade, e não entidades inteiras com todos os ativos. Para criar soluções segmentadas e patches, você pode usar a interface do usuário das soluções, sem gravar o código.

Além de ter maior controle sobre o que faz parte de uma solução, você poderá controlar o que vai em um patch. Você pode criar um patch para uma solução primária e exportá-lo como uma atualização pequena para a solução de base. Quando você clona uma solução, o sistema acumula todos os patches relacionados à solução base e cria uma nova versão.

Quando você trabalha com patches e soluções clonadas, mantenha as informações a seguir em mente:

  • Um patch representa uma atualização pequena incremental à solução primária. Um patch pode adicionar ou atualizar componentes e ativos na solução primária quando instalado no sistema alvo, mas não pode excluir quaisquer componentes ou ativos de uma solução primária.

  • Um patch pode ter apenas uma solução primária, mas uma solução primária pode ter um ou mais patches.

  • Um patch é criado para uma solução não gerenciada. Você não pode criar um patch para uma solução gerenciada.

  • Quando você exporta um patch para o sistema alvo, você deve exportá-lo como um patch gerenciado. Não utilize patches não gerenciados nos ambientes de produção.

  • A solução primária deve estar presente no sistema alvo para instalar um patch.

  • Você pode excluir patches ou atualizar um patch.

  • Se você excluir uma solução primária, todos os patches secundários também são deletados. O sistema fornece uma mensagem de aviso que não é possível desfazer a operação de exclusão. A exclusão é executada em uma única transação. Se um dos patches ou da solução primária falhar na exclusão, a transação inteira é retornada.

  • Depois de criar o primeiro patch para uma solução primária, a solução fica bloqueada, e você não pode fazer qualquer alteração nesta solução ou exportá-la. Entretanto, se você excluir todos os patches secundários, a solução primária é desbloqueada.

  • Quando você clona uma solução base, todos patches secundários são colocados em uma solução base e ela se torna uma nova versão. Você pode adicionar, editar ou excluir componentes e ativos na solução clonada.

  • Uma solução clonada representa uma substituição da solução base quando está instalada no sistema alvo como uma solução gerenciada. Normalmente, você usa uma solução clonada para enviar uma atualização maior à solução precedente.

Noções básicas sobre números de versão para soluções clonadas e patches

Uma versão de solução tem o seguinte formato: major.minor.build.revision. Um patch deve ter um número superior de desenvolvimento ou de revisão da solução primária. Não pode ter uma versão superior maior ou menor. Por exemplo, para uma versão de solução base 3.1.5.7, um patch pode ser uma versão 3.1.5.8 ou versão 3.1.7.0, mas não versão 3.2.0.0. Uma solução clonada deve ter o número de versão maior que ou igual ao número de versão da solução base. Por exemplo, para uma versão de solução base 3.1.5.7, uma solução clonada pode ser uma versão 3.2.0.0 ou versão 3.1.5.7. Na interface do usuário, só é possível definir os valores de versão maior e menor para uma solução clonada, e os valores de criação ou revisão de um patch.

Criar uma solução segmentada com os ativos de entidade que você deseja

Para criar uma solução segmentada, inicie com a criação de uma solução não gerenciada e adicione os recursos existentes. Você pode adicionar diversos sistemas ou entidades personalizadas, e para cada entidade, escolha os ativos que deseja incluir na solução. As configurações de assistente levam você passo a passo por meio do processo de adição de ativos de entidade.

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

  2. Selecione Novo e crie uma solução. Insira informações nos campos obrigatórios. Selecione Salvar e fechar.

  3. Abra a solução que acabou de criar. Na lista suspensa Adicionar existente, selecione Entidade.

  4. Na caixa de diálogo Selecionar componentes de solução, selecione uma ou mais entidades que você deseja adicionar à solução. Selecione OK.

  5. O assistente é exibido. Siga o assistente para adicionar ativos para cada entidade selecionada à solução.

  6. Selecione Publicar para que as alterações entrem em vigor.

    As seguintes ilustrações fornecem um exemplo da criação de uma solução segmentada escolhendo ativos de entidade das entidades Account, Case e Contact.

    Comece escolhendo o componente da Entidade.

    Adicione recursos existentes.

    Então, selecione os componentes da solução.

    Selecione os componentes da solução.

    Siga o assistente. Na etapa 1, começando em ordem alfabética, selecione os ativos para a primeira entidade, a entidade Account, como exibido aqui.

    Inicie o assistente.

    Abra a guia Campos e selecione o campo Número da conta.

    Selecione os ativos da entidade de Conta.

    Na etapa 2, para a entidade Caso, adicione todos os ativos.

    Selecione os ativos da entidade de Caso.

    Na etapa 3, adicione o campo Aniversário para a entidade Contato.

    Selecione os ativos da entidade de Contato.

    Como resultado, a solução segmentada criada contém três entidades, Account, Case e Contact. Cada entidade contém somente os ativos que foram escolhidos.

    Entidades com solução.

Criar um patch de solução

Um patch contém alterações na solução primária, como adicionar ou editar componentes e ativos. Não é necessário incluir os componentes primários, ao menos que você planeje editá-los.

Crie um patch para uma solução não gerenciada

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

  2. Na grade, selecione uma solução não gerenciada para a qual deseja criar um patch. Selecione Clonar um Patch. A caixa de diálogo que é aberta contém o nome da solução base e o número de versão do patch. Selecione Salvar.

  3. Na grade, encontre e abre o patch recém-criado. Assim como com a solução base, siga o assistente para adicionar os componentes e ativos que deseja.

  4. Selecione Publicar para que as alterações entrem em vigor.

    As seguintes ilustrações fornecem um exemplo de criação de um patch para uma solução existente. Comece selecionando Clonar um Patch (na visualização compactada, o ícone Clonar um Patch é dividido em dois quadrados pequenos, conforme mostrado abaixo).

    Ícone de Clonar um patch.

    Na caixa de diálogo Clonar para patch você vê que o número de versão para o patch é baseado no número de versão da solução primária, mas o número de criação é incrementado por um. Cada patch subsequente tem um número de criação ou revisão maior que o patch precedente.

    Use a caixa de diálogo Clonar para patch.

    A captura de tela a seguir mostra a solução da base SegmentedSolutionExample, versão 1.0.1.0 e o patch SegmentedSolutionExample_Patch, versão 1.0.2.0.

    Uma grade com soluções e patches.

    No patch que adicionamos uma nova entidade chamada Book, e incluímos todos os ativos da entidade Book no patch.

    Adicione a entidade personalizada no patch.

Clonar uma solução

Quando você clona uma solução não gerenciada, todos os patches relacionados a esta solução são encaminhados na versão recentemente criada da solução original.

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

  2. Na lista, selecione uma solução não gerenciada que deseja clonar. Selecione Clonar Solução. A caixa de diálogo que é aberta contém o nome da solução base e o número de versão novo. Selecione Salvar.

  3. Selecione Publicar para que as alterações entrem em vigor.

    Continuando com o exemplo, você vê a caixa de diálogo Clonar para solução que mostra um novo número de versão de solução.

    Use a caixa de diálogo Clonar para solução

    Após clonar, a nova versão da solução contém três entidades originais (Account, Case e Contact), e a entidade personalizada chamada Book que foi adicionada no patch. Cada entidade contém somente os ativos que foram adicionados no exemplo.

    Uma solução clonada com patch acumulado.

Consulte também

Visão geral das soluções Criar patches para simplificar atualizações de solução