Erro de dependências ausentes durante a importação da solução

Ao importar uma solução para um ambiente de destino no Microsoft Power Apps, você pode encontrar erros sobre dependências ausentes. Este artigo ajuda você a identificar a causa de erros de dependência ausentes e fornece soluções alternativas para resolvê-los. Ele também inclui práticas recomendadas para ajudá-lo a evitar esses erros em importações futuras de solução.

Aplica-se a: Power Platform, Solutions

Sintomas de problemas de dependência ausentes

Ao tentar importar uma solução no Power Apps, você recebe uma mensagem de erro semelhante à seguinte mensagem:

A importação falhou devido à falta de dependências.

Nessa situação, você não pode continuar a importação da solução até resolver as dependências ausentes.

Causa de erros de dependência ausentes

Erros de dependência ausentes ocorrem quando uma solução faz referência a aplicativos ou componentes que existem no ambiente de origem, mas não no ambiente de destino. Esses componentes podem incluir tabelas, colunas, formulários ou outros elementos de solução.

Esse problema poderá ocorrer se os aplicativos forem atualizados para a versão mais recente (por meio da manutenção agendada da Microsoft) no ambiente de origem, mas não no ambiente de destino.

Solução alternativa 1: resolver erros de dependência ausentes

Para resolver este problema, siga estas etapas:

1. Navegue até a página Dependências Ausentes selecionando o botão Mostrar dependências . Esta página lista todos os componentes ausentes e os classifica nas seguintes categorias:

   • Aplicativos
   • Soluções Gerenciadas
   • Componentes não gerenciados

   Tip

   Outro método para localizar dependências de componentes é abrir o arquivo de solução, expandi-lo e, em seguida, abrir o arquivo solution.xml . Neste arquivo, procure o <MissingDependencies> elemento que lista todas as dependências ausentes.

2. Expanda cada seção de dependências e reduza o problema com base no tipo de dependências descritas nas seções a seguir. Depois que as dependências ausentes forem restauradas ou atualizadas, repita a importação.

Dependências ausentes provenientes de um aplicativo do Dynamics 365

Esse problema ocorrerá se a solução depender de componentes de aplicativos do Dynamics 365 que estão ausentes ou desatualizados no ambiente de destino. Você pode encontrar essas dependências na seção Aplicativos da página Dependências ausentes. Cada entrada fornece detalhes sobre o aplicativo ausente no seguinte formato:

<nome_solução> (<solution_version>) de <nome_aplicativo>

Ao lado do nome do aplicativo está um botão Instalar ou Atualizar que redireciona você para o centro de administração do Power Platform.

Para contornar esse problema, use um dos seguintes métodos:

• Se o aplicativo não estiver instalado no ambiente de destino:

  • Os administradores do sistema podem usar o botão Instalar para serem redirecionados para a página de instalação do aplicativo no Centro de administração do Power Platform. Alternativamente, um administrador de sistema pode ir diretamente para a página de instalação do aplicativo para instalar o aplicativo no centro de administração do Power Platform.
  • Os administradores que não são do sistema podem usar o botão Copiar Link de Instalação para copiar o link de instalação do aplicativo e solicitar que o administrador do sistema instale o aplicativo.

• Se o aplicativo estiver instalado, mas desatualizado no ambiente de destino:

  • Os administradores do sistema podem usar o botão Atualizar para abrir a página de atualização do aplicativo no centro de administração do Power Platform.
  • Os administradores que não são do sistema podem usar o botão Copiar Link de Atualização para copiar o link de atualização do aplicativo e solicitar que o administrador do sistema atualize o aplicativo.

Dependências ausentes provenientes de um aplicativo Dynamics 365 nativo

Uma solução pode depender apenas de componentes de aplicativos do Dynamics 365 de primeira parte que estão ausentes ou desatualizados no ambiente de destino. Nessa situação, o sistema pode ser capaz de atualizar ou instalar automaticamente esses componentes, e nenhuma ação manual é necessária do usuário. A página Dependências Ausentes exibe a opção Implantar Dependências . Se você selecionar essa opção e selecionar o botão Importar , o sistema primeiro instalará ou atualizará as dependências necessárias e importará a solução. Se a atualização ou instalação de um aplicativo dependente falhar, a importação da solução também falhará. Você pode acompanhar o status dessas atualizações ou instalações na página de histórico da solução.

Dependências ausentes provenientes de outra solução gerenciada

Esse problema ocorre quando a solução depende de componentes de outra solução gerenciada que está ausente no ambiente de destino. Você pode encontrar essas dependências na seção Soluções Gerenciadas da página Dependências Faltando. Expanda a seção para ver detalhes adicionais.

Para contornar esse problema, importe a mesma versão da solução instalada no ambiente de origem para o ambiente de destino.

Dependências ausentes nas soluções "Ativas"

Esse problema ocorre quando a solução depende de personalizações não gerenciadas do ambiente de origem que estão ausentes no ambiente de destino. Você pode encontrar essas dependências na seção Componentes Não Gerenciados da página de Dependências Ausentes. Expandir a seção fornece detalhes adicionais.

Para contornar esse problema, retorne ao ambiente de origem, inclua os componentes ausentes, exporte a solução novamente e importe-a para o ambiente de destino.

Solução alternativa 2: práticas recomendadas para evitar erros de dependência ausentes

Ao criar uma solução no Power Platform, muitas vezes você reutiliza os componentes existentes para melhorar a consistência e a velocidade de desenvolvimento. Há algumas considerações importantes para reutilização de objetos existentes em ambientes.

Disponibilidade de componentes em ambientes de destino

Se sua solução tiver dependências de componentes (como tabelas, fluxos ou aplicativos) no ambiente de origem, esses componentes também deverão existir no ambiente de destino ao implantar a solução. Esse requisito se aplica a implantações de pipeline e importação manual. Se os componentes estiverem ausentes no ambiente de destino, ocorrerá um erro de dependência ausente durante a importação.

Selecionar somente os componentes necessários

Para evitar problemas de dependência, não inclua tabelas ou componentes inteiros se você precisar apenas de um subconjunto de seus elementos (por exemplo, colunas, exibições ou formulários específicos). A adição de elementos desnecessários pode causar:

• Maior complexidade da solução
• Várias camadas gerenciadas que são aplicadas a componentes
• Possíveis conflitos durante as atualizações

Em vez disso, inclua apenas as partes do componente que sua solução usa ativamente.

Evite modificar componentes em soluções gerenciadas

Não faça alterações diretamente em componentes que fazem parte de uma solução gerenciada. Essas alterações criam uma camada não gerenciada sobre o componente gerenciado. Essa camada não gerenciada pode:

• Substituir atualizações da solução gerenciada pela origem
• Causar inconsistências entre ambientes
• Impedir que alterações (como atualizações em fluxos do Power Automate ou configurações de tabela) sejam refletidas corretamente após a implantação

Sempre aplique alterações em uma solução não gerenciada ou estenda a funcionalidade usando camadas de solução. Para obter mais informações sobre camadas de solução, consulte Camadas de solução.

Evitar dependências em aplicativos preteridos

Evite ter dependências em aplicativos obsoletos. Os aplicativos preteridos não estão mais disponíveis para instalação ou atualização. Você pode encontrar essas dependências na seção Aplicativos Preteridos da página Dependências Ausentes . Expandir a seção fornece detalhes adicionais.

Remova as dependências entre os componentes da solução e os aplicativos preteridos antes de importar sua solução.

Conteúdo relacionado

• Organizar suas soluções
• Imposição do verificador de solução