Importar soluções

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Você pode importar soluções manualmente usando as etapas deste artigo. Você deve importar apenas aquelas soluções obtidas de uma fonte confiável.

Observação

• O privilégio de criação é necessário para importar um componente. Entretanto, o direito de acesso Cliente do Sistema tenha privilégio de criação na maioria dos componentes comumente importados, por padrão ele não tem privilégio de criação na tabela Assembly de Plug-In. O direito de acesso de Administrador do Sistema tem esse privilégio.
• Quando você importa uma solução gerenciada, todas as alterações de componentes são trazidas para o ambiente em um estado publicado. No entanto, quando você importa uma solução não gerenciada, as alterações são importadas em um estado de rascunho, portanto, você deve publicá-las para torná-las ativas.
• Para implementar o gerenciamento do ciclo de vida de aplicativos (ALM) em sua organização, considere usar um sistema de controle de origem para armazenar e colaborar em suas soluções e automatizar o processo de importação da solução. Mais Informações: Noções básicas do ALM no guia de ALM da Power Platform.

Quando você importa uma solução não gerenciada:

• Você adiciona todos os componentes dessa solução ao seu ambiente e não pode excluir os componentes excluindo a solução. A exclusão da solução não gerenciada exclui apenas o contêiner da solução.
• Que contém componentes personalizados, as personalizações existentes no componente serão substituídas após a importação da solução não gerenciada. Não é possível desfazer isso.

Para importar uma solução:

1. Entre no Power Apps e selecione Soluções na navegação esquerda.

2. Na barra de comandos, selecione Importar.

   

3. Na página Importar uma solução, selecione Procurar para localizar o arquivo compactado (.zip ou .cab) que contém a solução que você deseja importar.

4. Selecione Avançar.

5. São exibidas informações sobre a solução. Por padrão, na seção Configurações avançadas, se houver mensagens e fluxos SDK na solução, eles serão importados. Desmarque a opção Habilitar mensagens e fluxos SDK incluídos na solução se você deseja que eles sejam importados em um estado inativo.

6. Se sua solução tiver referências de conexão, será solicitado que você selecione as conexões desejadas. Se ainda não existir uma conexão, crie uma nova. Selecione Avançar.

7. Se sua solução tiver variáveis de ambiente, será solicitado que você insira valores. Você não verá essa tela se os valores já existirem na sua solução ou no ambiente de destino.

8. Se dependências ausentes forem detectadas no ambiente de destino, uma lista das dependências será apresentada. Em ambientes onde a versão do pacote necessária está disponível para importação no ambiente de destino, um link para resolver a dependência é apresentado. Selecionar o link leva você ao centro de administração do Power Platform onde você pode instalar a atualização do aplicativo. Depois que a atualização do aplicativo for concluída, você pode iniciar a importação da solução novamente.

9. Selecione Importar.

Sua solução é importada em segundo plano e pode levar alguns minutos.

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

Se a importação não for bem-sucedida, você verá uma notificação na página da solução mostrando avisos ou erros que foram capturados. Selecione Baixar Arquivo de Log para capturar detalhes sobre o que causou a falha na importação. A causa mais comum para uma falha na importação é que a solução não contém alguns dos componentes exigidos.

Ao baixar o arquivo de log, você encontrará um arquivo XML que é possível abrir usando o Office Excel para exibir o conteúdo.

Observação

Você pode exibir os detalhes de todas as operações da solução, incluindo a importação dela, com o recurso histórico da solução. Para exibir essas operações, selecione Ver histórico na página de soluções.

Solução de problemas de importação

Existe uma camada não gerenciada ativa criada após a importação de uma solução gerenciada

Durante a importação da solução, o sistema deve garantir que haja um formulário de fallback para uma tabela. Esse requisito é aplicado quando você cria tabelas ou formulários. Se durante a importação não houver um formulário de fallback especificado para uma tabela, a importação cria uma camada ativa não gerenciada para um dos formulários principais e a personalização não gerenciada indica o formulário como o formulário de fallback. Isso garante que os usuários possam exibir um formulário quando não tiverem acesso a nenhum dos outros formulários de tabela. Mais informações: Definir o formulário de fallback para uma tabela

O formulário não aparece no ambiente de destino após a importação da solução não gerenciada

Durante a exportação de soluções não gerenciadas, alguns formulários que não são modificados são exportados com o atributo unmodified=1 no formulário XML do arquivo customizations.xml localizado no pacote de solução. Esse atributo está localizado no nó FormXml no arquivo customization.xml dentro do pacote de solução. Esse atributo garante que, embora esses formulários façam parte da solução sendo exportada, quando a mesma solução é importada em um novo ambiente, o formulário será omitido da importação. Para evitar esse cenário, o formulário precisa ter personalizações ativas para ser exportado sem o atributo unmodified=1. Para verificar isso, extraia o pacote de solução exportado e pesquise o arquivo customizations.xml para o nó FormXml em questão e verifique o atributo não modificado.

Microsoft.Crm.CrmInvalidOperationException: formXml completo é esperado para criar uma mensagem de <formid>

Esse erro pode ocorrer quando o formulário que você está importando não existe no ambiente de destino e o formulário é importado pela primeira vez. A solução que você está importando tem apenas alterações de formulário (diff) no formulário XML, quando deveria ter o formulário XML completo. Uma solução só deve importar um formulário diff XML quando ele já estiver presente no ambiente e você estiver importando as alterações. Para verificar, abra o arquivo customizations.xml de sua solução e pesquise o nó FormXml usando a ID do formulário que aparece na mensagem de erro. Se o formulário XML tiver um atributo denominado solutionaction, então o formulário XML será um diff. Para resolver este cenário, o formulário XML deve ser um XML de formulário completo (não deve conter o atributo solutionaction) e pode ser obtido na instância em que este formulário foi originalmente criado como não gerenciado.

Microsoft.Crm.CrmException: não é possível excluir este formulário porque ele é o único formulário de fallback do tipo principal para a tabela 'tabela'. Cada tabela deve ter pelo menos um formulário de fallback para cada mensagem do tipo de formulário durante a atualização ou a desinstalação da solução

Esse erro ocorre quando uma atualização ou desinstalação de solução tenta excluir o último formulário restante de uma tabela. Esse comportamento é estrutural. Cada tabela deve ser capaz de exibir um formulário para qualquer usuário válido. Portanto, pelo menos um formulário precisa ser designado como formulário de fallback. Um formulário de fallback está disponível para usuários com funções de segurança que não têm formulários explicitamente atribuídos a eles. Para contornar esse problema, crie um formulário temporário configurado como o formulário de fallback para a tabela e, em seguida, tente atualizar ou desinstalar novamente. Mais informações: Definir o formulário de fallback para uma tabela

Mensagem Não é possível excluir a solução devido a dependências de outros componentes do sistema ao desinstalar uma solução

Esse problema pode ocorrer quando a solução contém componentes que são referenciados por outras soluções na parte superior dela na pilha de camadas. Para resolver esse problema, exclua o componente ou remova a dependência da solução que você está tentando desinstalar. Mais informações: Removendo dependências

Os componentes recém-adicionados não aparecem no aplicativo após a importação de uma atualização para o aplicativo

Uma mudança de aplicativo baseada em modelo que usa Tudo ao selecionar um componente, como uma exibição, não é refletida após a importação de uma atualização para o aplicativo no ambiente de destino. Isso pode acontecer quando o seguinte for verdadeiro:

1. Você não selecionou inicialmente Tudo no designer do aplicativo, mas selecionou os componentes individualmente. Por exemplo, você seleciona duas exibições e, em seguida, exporta o aplicativo em uma solução gerenciada de seu ambiente de desenvolvimento e o importa para seu ambiente de teste (destino).
2. Em seguida, você criou outra solução com o mesmo aplicativo no ambiente de desenvolvimento. Você selecionou Tudo para selecionar todas as exibições no designer de aplicativo. A solução é então exportada como gerenciada de seu ambiente de desenvolvimento e importada para seu ambiente de teste (destino).

Para contornar esse comportamento, selecione cada componente individualmente, como as exibições recém-adicionadas descritas na etapa 2, em vez de selecionar Tudo.

O texto do rótulo não é exibido em idiomas adicionais após a importação

O texto do rótulo não é exibido em idiomas adicionais após importar uma solução. Esse problema pode ocorrer quando você importa a solução com as traduções antes de habilitar o idioma no ambiente de destino.

Para solucionar esse problema, habilite os idiomas desejados e importe a solução novamente. Mais informações: Habilitar o idioma

Direitos de acesso duplicados após a importação da solução

Observe que, ao tentar criar um direito de acesso no centro de administração do Power Platform quando já existe um direito de acesso com o mesmo nome no ambiente, você recebe uma mensagem informando que um direito com o nome especificado já existe e o direito não é criado. No entanto, por meio da importação da solução, é possível importar um direito de acesso para um ambiente que já tenha um direito de acesso diferente com o mesmo nome. Quando isso ocorre, os dois direitos de acesso com o mesmo nome existem no ambiente, o que pode dificultar a distinção entre os dois.

Consulte também

Atualizar soluções
Exportar soluções
Publicar alterações
Para desenvolvedores: Criar, exportar ou importar uma solução não gerenciada

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).