Problemas comuns e soluções do verificador de solução

Este artigo lista alguns problemas comuns que podem ocorrer ao usar o verificador de solução. Quando aplicável, são fornecidas soluções alternativas.

Você não consegue usar o verificador de solução para executar análises ou baixar resultados

Logo após o envio de uma solicitação do verificador de solução para executar uma análise ou baixar resultados, a operação não é concluída e uma mensagem de erro é exibida, como:

"Não foi possível executar a verificação da solução [Nome da Solução]. Tente executá-la novamente."

Sempre que possível, o verificador de soluções tenta retornar uma mensagem de erro específica com um link para detalhes sobre as possíveis causas e etapas de resolução. Selecione "Saiba mais" para obter detalhes.

As falhas que ocorrem durante o processamento em segundo plano da análise apresentarão o status "Não foi possível concluir" e retornarão uma mensagem de erro no portal do Power Apps, bem como enviarão uma notificação por email ao solicitante.

A seleção da notificação do portal será vinculada a esta página de problemas comuns para solução de problemas adicionais. Se um dos problemas comuns fornecidos não resolver o problema, um número de referência também será retornado. Forneça esse número de referência ao Suporte da Microsoft para investigação adicional.

O Verificador de solução falha ao verificar a solução Padrão

O verificador de solução exporta a solução do ambiente do Microsoft Power Platform para análise. A exportação da Solução padrão não é compatível e a verificação pode não ser concluída com êxito. Mais informações: O Verificador de Solução falha ao exportar soluções grandes.

O verificador de solução falha por causa da versão sem suporte do Verificador do Power Apps

O verificador de solução é um recurso habilitado pelo aplicativo Verificador do Power Apps. Se você instalou uma versão do aplicativo Verificador do Power Apps anterior à versão 1.0.0.47, talvez as execuções do verificador de solução não sejam concluídas com êxito. Você deve atualizar a versão do Verificador do Power Apps em Centro de administração do Power Platform.

No entanto, se você tiver uma versão do Verificador do Power Apps anterior à 1.0.0.45 instalada, recomendamos excluir a solução e instalá-la novamente. Devido a alterações recentes de esquema, podem ocorrer falhas ao atualizar o Verificador do Power Apps com versões anteriores à 1.0.0.45.

Se quiser manter os resultados anteriores do verificador de solução, exporte os resultados de uma execução passada ou exporte todos os dados do verificador de solução usando a opção Exportar dados para o Excel para exportar os dados das seguintes tabelas:

• Componente de Análise
• Trabalho de Análise
• Resultado da Análise
• Detalhe do Resultado da Análise

Como desinstalar o Verificador do Power Apps

Para desinstalar a solução Verificador do Power Apps:

1. Como Administrador do Sistema ou Personalizador de Sistema, abra o portal do Power Apps acessando https://make.powerapps.com/environments.
2. Selecione Soluções.
3. Selecione Verificador do Power Apps e, na barra de ferramentas da solução, selecione Excluir.

Como instalar o Verificador do Power Apps

Para instalar o Verificador do Power Apps novamente no ambiente:

1. Como Administrador do Sistema ou Personalizador de Sistema, abra seu portal do Power Apps acessando https://make.powerapps.com/environments.
2. Selecione Soluções.
3. Na barra de ferramentas da solução, selecione Verificador de solução e Instalar.

O verificador de solução não pode acessar ambientes no modo de administração

Os ambientes que foram colocados no Modo de Administração registram propositadamente o acesso só aos usuários com as funções de administrador do sistema e personalizador de sistema. Como a identidade do aplicativo Verificador do Power Apps não tem nenhuma dessas funções atribuídas por padrão, ela não pode acessar as organizações que operam nesse modo.

Para usar o verificador de solução nessa organização, o Modo de Administração deve ser desabilitado.

Como desabilitar o modo de administração

Para desabilitar o modo de administração de uma instância da organização:

1. Entre no centro de administração da Power Platform.

2. Abra o ambiente que apresenta problemas ao executar o verificador de solução e selecione Editar.

3. Defina o Modo de administração como desativado e, em seguida, selecione Salvar.

   

4. Execute o verificador de solução novamente.

O verificador de solução falha em razão da falta de direitos de acesso

O usuário do aplicativo para o verificador de solução requer os direitos de acesso a seguir atribuídos para fornecer os privilégios necessários para se comunicar com a organização do Dataverse. Se nenhum desses direitos tiver sido atribuído ao usuário 'Aplicativo Verificador do Power Apps', haverá falha nas tentativas de executar análises, baixar resultados e executar o cancelamento. Isso ocorre com mais frequência quando os clientes têm uma automação que remove os direitos de acesso de usuários inesperados. Os seguintes direitos de acesso contêm permissões mínimas necessárias:

• Exportar Personalizações (Verificador de Solução)
• Gravador de Serviços
• Verificador de Solução

Como atribuir direitos de acesso ausentes

Para atribuir direitos de acesso ausentes ao Aplicativo Verificador do Power Apps:

1. No centro de administração do Power Platform, navegue até o ambiente e, em seguida, até Usuários > lista de usuários do aplicativo.
2. Selecione o usuário do 'Aplicativo Verificador do Power Apps' na lista de usuários.
3. Selecione Editar direitos de acesso na barra de comandos.
4. Marque as caixas de seleção para as funções listadas acima e selecione Salvar.
5. Execute o verificador de solução novamente.

O verificador de solução falha em razão do modo de acesso restrito

O usuário do aplicativo para o verificador de solução requer um modo de acesso 'Não interativo' ou 'Leitura-Gravação' para se comunicar com a organização Dataverse. Se o modo de acesso tiver sido alterado para outro valor, como "Administrativo", as tentativas de executar análises, baixar resultados e executar o cancelamento falharão.

Para resolver esse problema, você deve atualizar o usuário do aplicativo "Verificador do Power Apps" com o modo de acesso "Não Interativo".

Como atualizar o modo de acesso do usuário

Para atualizar o modo de acesso do usuário Verificador do Power Apps:

1. Abra a organização Dataverse e navegue até Configurações > Segurança > Usuários.
2. Selecione o usuário "Verificador do Power Apps" na lista de usuários e clique duas vezes para abrir o formulário do usuário.
3. Role para a seção "Administração" > "Informações sobre CAL (Licença de Acesso para Cliente)" do formulário.
4. Selecione "Não interativo" no controle suspenso Modo de Acesso.

5. Salve e feche o formulário do usuário.
6. Execute o verificador de solução novamente.

O Verificador de Solução falha pois há um usuário de aplicativo desabilitado

Deve-se habilitar o usuário de aplicativo do Verificador do Power Apps na organização Dataverse que contém soluções a serem analisadas. Se o usuário do aplicativo ficar desativado, as solicitações para analisar soluções na mesma organização falharão. Se receber esta mensagem de erro, verifique primeiro se o usuário do aplicativo Verificador do Power Apps está realmente desabilitado. Siga as etapas de mitigação fornecidas abaixo.

Como habilitar o usuário do aplicativo Verificador do Power Apps

1. No centro de administração da Power Platform, selecione o ambiente e vá para Configurações > Do Usuário + Permissões > Usuários.
2. Na exibição Usuários do Aplicativo, selecione a marca de seleção ao lado de usuário de aplicativo do Verificador do Power Apps
3. Na barra de ferramentas Ações, selecione Habilitar.

4. Na mensagem Confirmar ativação do usuário, selecione Ativar.
5. Outra abordagem é abrir o formulário do usuário do aplicativo e selecionar o status Habilitado no rodapé do formulário. Salvar a alteração.

O Verificador de solução permanece em estado de Execução por mais de 30 minutos

O verificador de solução pode permanecer em execução indefinidamente, se a solução analisada contiver componentes de plug-in desenvolvidos usando o .NET Standard 2.0. Os plug-ins que usam o .NET Standard 2.0 não têm suporte no verificador de solução e devem ser excluídos da análise. Exclua o componente de plug-in removendo-o da solução de destino ou usando o parâmetro 'ExcludedFileNamePattern' no módulo do PowerShell do Verificador do Power Apps.

Condições comuns de plug-in que causam falha no verificador de solução

Quando o verificador de solução recebe e processa solicitações de análise, ele deve chamar o ponto de extremidade do Dataverse para recuperar/atualizar dados relevantes do trabalho e exportar as soluções selecionadas. Cada interação feita pelo serviço verificador de solução com o Dataverse tem o potencial de disparar uma ou mais etapas de plug-in que foram registradas na mensagem enviada na solicitação. Esses plug-ins podem, por sua vez, apresentar condições que impeçam o tratamento da mensagem como esperado pelo Dataverse e interrompam a capacidade do verificador de solução de processar o trabalho de análise solicitado. Situações semelhantes podem ocorrer ao baixar resultados do trabalho do verificador de solução ou ao cancelar um trabalho de análise em andamento.

Operações típicas do Dataverse solicitadas pelo verificador de solução:

• Recuperar solução, systemuser e dados da tabela de organização
• Criar, atualizar e recuperar trabalho de análise, componente de análise e dados da tabela de resultados de análise
• Exportar soluções

Etapa de plug-in registrada para execução no contexto de um usuário não licenciado

Quando o verificador de solução falha devido a uma exceção de "usuário não licenciado", geralmente ela é causada por uma etapa do plug-in disparado configurada para ser executada no contexto de um usuário de sistema específico que atualmente não está licenciado. Certifique-se de que quaisquer etapas do plug-in que possam ser disparadas pelo verificador de solução sejam executadas no contexto de um usuário licenciado.

Importante

É altamente recomendável que as etapas do plug-in sejam configuradas para serem executadas no contexto do usuário da chamada, em vez de usuários específicos que estão sujeitos à revogação da licença atribuída.

A etapa de plug-in executa operações que exigem privilégios não concedidos ao usuário do aplicativo Verificador do Power Apps

Quando o verificador de solução falha devido ao acesso negado ao Dataverse com base em um privilégio ausente, geralmente isso é causado por uma etapa de plug-in disparado que executa operações que exigem privilégios não concedidos atualmente ao usuário do aplicativo do Verificador do Power Apps. Reconfigure a etapa do plug-in para não executar na operação chamada pelo verificador de solução ou conceda ao usuário do aplicativo do Verificador do Power Apps os privilégios necessários para executar a etapa do plug-in personalizado.

A etapa do plug-in interrompe inesperadamente a execução, gerando InvalidPluginExecutionException

O verificador de soluções pode falhar devido aos erros "ISV code aborted the operation" (O código ISV abortou a operação) ou "An unexpected error occurred from ISV code" (Ocorreu um erro inesperado no código ISV). A ocorrência disso indica que uma etapa do plug-in foi acionada e interrompeu explicitamente a execução lançando uma InvalidPluginExcecutionException ou que um erro não foi detectado corretamente no código do plug-in. Reconfigure a etapa do plug-in para não executar na operação chamada pelo verificador de solução ou ajuste a implementação do plug-in para não interromper a execução com base nas condições apresentadas pelo verificador de solução.

As operações comuns invocadas pelo verificador de soluções incluem Criar e Atualizar. Essas operações podem ocorrer nas seguintes tabelas: Trabalho de Análise, Componente de Análise ou Resultado da Análise.

O verificador de solução falha por causa do aplicativo primário desabilitado na ID do Microsoft Entra

A identidade do aplicativo empresarial primário usado pelo verificador de solução (PowerApps-Advisor) não deve ser desabilitada na ID do Microsoft Entra. Se desabilitada, a identidade não poderá ser autenticada ao solicitar tokens de portador para o Dataverse e outros provedores de recursos necessários em nome do usuário solicitante.

Siga as etapas abaixo para verificar se a identidade do aplicativo não foi desabilitada no Microsoft Entra e, se necessário, habilitar o aplicativo.

Como verificar e/ou modificar o status habilitado do aplicativo

Para verificar e/ou modificar o status habilitado da identidade do aplicativo empresarial PowerApps-Advisor

1. Acesse o locatário no Portal do Microsoft Entra.
2. Navegue até Aplicativos Empresariais.
3. Selecione Todos os aplicativos e procure por "PowerApps-Advisor".

4. Selecione "PowerApps-Advisor" para exibir os detalhes do aplicativo.
5. Selecione Propriedades.
6. Marque o estado de Habilitado para os usuários entrarem. Se for "Não", o aplicativo foi desabilitado.

7. Selecione o controle de opção para mudar o valor para "Sim". Isso habilita o aplicativo.

8. Selecione Salvar. O aplicativo agora está habilitado. Talvez seja necessário aguardar alguns minutos para que a alteração se propague.
9. Execute o verificador de solução novamente.

Importante

Você deve ter privilégios de administrador na ID do Microsoft Entra (ID do Microsoft Entra) para editar aplicativos empresariais.

Falha do verificador de solução ao exportar soluções com rascunho de componentes do fluxo do processo empresarial

Se uma solução contiver um componente de fluxo do processo empresarial no estado de rascunho que nunca foi ativado anteriormente, o verificador de solução não exportará a solução para análise. Esse erro não é exclusivo do verificador de solução e é causado pelo fluxo do processo empresarial com uma dependência de um componente de tabela (personalizado) de suporte que não é criado até que o fluxo do processo empresarial seja ativado pela primeira vez. Esse problema também pode ocorrer se um fluxo do processo empresarial for ativado no gerenciador de soluções.

Referência Artigo da Base de Dados de Conhecimento nº 4337537: Exportação Inválida: a tabela do Processo Empresarial está Ausente para obter detalhes sobre o problema e as etapas a serem resolvidas.

Falha no verificador de solução ao exportar soluções com componentes de aplicativo baseado em modelo

Se uma solução contiver um aplicativo baseado em modelo, talvez ocorra falha no verificador de solução para exportar a solução para análise. Este erro é causado pela segurança baseada em função para compartilhamento de aplicativos. Se o usuário de aplicativo Verificador do Power Apps não tiver acesso apropriado aos aplicativos baseados em modelo, as soluções que os contêm não serão exportadas com o verificador de solução.

Para resolver esse problema, conceda o direito de acesso Criador de Ambiente para o usuário do aplicativo Verificador do Power Apps.

O verificador de solução não exporta solução com patches

Se uma solução tiver um patch aplicado, haverá falha do verificador de solução para exportar a solução para análise. Quando uma solução tiver um patch aplicado, a solução original será bloqueada e não será possível alterá-la ou exportá-la, enquanto houver patches dependentes que estejam na organização que identifica a solução como a solução primária.

Para solucionar esse problema, clone a solução para que todos os patches relacionados à solução sejam colocados na solução recém-criada. Isto desbloqueará a solução e permitirá que a solução seja exportada do sistema. Para obter mais informações, consulte Clonar uma Solução.

O verificador de solução não analisará soluções vazias

Se o verificador de solução exportar uma solução que não contenha componentes para analisar, ela encerrará o processamento adicional e considerará a falha como resultado. Certifique-se de que a solução selecionada enviada para uma análise do verificador de solução contenha pelo menos um componente.

O Verificador de solução não exporta soluções grandes

O cenário principal de falha na exportação de uma solução grande do ambiente envolve uma exceção de tempo limite na solicitação de exportação. Isso ocorrerá se a solicitação exceder 20 minutos. Pode haver falha na exportação de soluções grandes, como a Solução Padrão, dentro desse período e a verificação não será completamente bem-sucedida. Se o verificador de solução encontrar um tempo limite durante a exportação, ele repetirá três vezes antes de considerar uma falha no processamento do trabalho; portanto, pode levar mais de uma hora até você receber uma notificação de falha.

A solução alternativa é criar soluções menores com menos componentes a serem analisados. Se o arquivo de tamanho grande da solução é devido a muitos componentes de montagem de plug-in, consulte as diretrizes para Otimizar desenvolvimento de montagem personalizada.

Importante

Para minimizar falsos positivos, certifique-se de que adicionar personalizações dependentes. Quando você criar uma solução e adicionar esses componentes, inclua o seguinte:

• Ao adicionar plug-ins, inclua as etapas de processamento de mensagens do SDK para o plug-in.
• Ao adicionar formulários de tabela, inclua os recursos de JavaScript da Web anexados aos eventos de formulário.
• Ao adicionar recursos de JavaScript da Web, inclua todos os recursos de JavaScript da Web dependentes.
• Ao adicionar recursos HTML da Web, inclua todos os scripts dependentes que forem definidos no recurso HTML da Web.
• Ao adicionar fluxos de trabalho personalizados, inclua o assembly usado no fluxo de trabalho.

As referências do número da linha para problemas em recursos HTML com Javascript incorporado não estão corretas

Quando os recursos HTML da Web são processados no verificador de solução, o recurso HTML da Web é processado separadamente do Javascript no recurso HTML da Web. Por causa disso, o número da linha da violação encontrado no <script> do recurso HTML da Web não estará correto.

Problemas de sintaxe sem suporte na Web para recursos da Web

O verificador de solução é compatível com variáveis globais para a sintaxe ECMAScript 2015 (ES6) e até ECMAScript 2018 (ES9). Quando o verificador de solução analisa o JavaScript usando variáveis globais posteriores a ES6 ou sintaxe posterior a ES9, é relatado um problema de sintaxe sem suporte para o recurso da Web.

Várias violações relatadas para atividades de plug-in e fluxo de trabalho com base no escopo da chamada

Para regras de atividade de fluxo de trabalho e plug-in em que o problema é relevante apenas no contexto de chamada, a ferramenta verificador de solução inicia a análise na implementação da interface IPlugin e percorre um gráfico de chamadas para detectar problemas no escopo dessa implementação. Em alguns casos, muitos caminhos de chamada podem chegar ao mesmo local onde o problema foi detectado. Uma vez que o problema é relevante para o escopo da chamada, a ferramenta pode relatar com base nesse escopo, e não em locais distintos, para fornecer um melhor panorama geral do impacto. Consequentemente, vários problemas podem fazer referência a um único local que deve ser corrigido.

app-formula-issues-high pode mostrar um número diferente de erros do que aqueles mostrados no modo de design

O verificador de solução listará o número de erros encontrados no aplicativo, incluindo os erros de testes. O verificador de aplicativos no modo de design mostra apenas erros de controles e componentes da tela. Se a contagem de erros mostrada no verificador de aplicativos no modo de design for menor, abra o Test Studio e procure os erros nas expressões usadas em testes.

Violações do Verificador de solução relatadas para componentes de código

O Verificador de solução relata várias violações quando executado na solução que tem componentes de código integrados no modo de depuração. Um erro comum que ocorre no modo de depuração é web-avoid-eval. O Verificador de solução tem como objetivo validar o código para uso em produção; portanto, os componentes do código devem ser criados usando o buildMode adequado: npm run build -- --buildMode production ou msbuild /p:configuration=Release dependendo do seu sistema de compilação. Mais informações: Criar e compilar um componente de código

Se ocorrerem erros bundle.js introduzidos por componentes de código, você poderá excluir esse arquivo da análise. Mais informações: módulo Microsoft.PowerApps.Checker.PowerShell e PAC CLI

Confira também

Melhores práticas e orientação para o Dataverse

Práticas recomendadas e orientações para aplicativos controlados por modelos

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).