Problemas comuns e resoluções para o verificador de soluções

Este artigo lista alguns problemas comuns que podem ser encontrados durante a utilização do verificador de soluções. Quando aplicável, são disponibilizadas soluções.

Não consegue utilizar o verificador de soluções para executar análises ou transferir resultados

Pouco depois de submeter um pedido do verificador de soluções para executar uma análise ou transferir resultados, a operação não é concluída e é apresentada uma mensagem de erro, como:

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

Sempre que possível, o verificador de soluções tenta devolver uma mensagem de erro específica com uma ligação para os detalhes sobre a causa potencial e os passos de resolução. Selecione "Mais informações" para obter mais detalhes.

As falhas que ocorrem durante o processamento em fundo da análise falharão com o estado "Não foi possível concluir" e devolvem uma mensagem de erro no portal Power Apps, bem como enviam uma notificação por e-mail para o requerente.

Selecionar a notificação do portal irá ligar a esta página de problemas comuns para resolver mais problemas. Se um dos problemas comuns fornecidos não resolver o problema, também é devolvido um número de referência. Forneça este número de referência ao suporte da Microsoft para uma investigação adicional.

O Verificador de soluções não consegue verificar a Solução predefinida

O Verificador de soluções exporta a solução do ambiente do Microsoft Power Platform para análise. A exportação da Solução predefinida não é suportada e a verificação poderá não ser concluída com êxito. Mais informações: O Verificador de Soluções não consegue exportar soluções grandes.

O verificador de soluções falha devido à versão não suportada do Verificador do Power Apps

O verificador de Soluções é uma funcionalidade ativada pela aplicação Verificador do Power Apps. Se instalou uma versão da aplicação Verificador do Power Apps anterior à 1.0.0.47, as execuções do verificador de soluções podem não ser concluídas com êxito. Deve atualizar a versão do Verificador do Power Apps a partir do Centro de administração do Power Platform.

No entanto, se tiver uma versão do Verificador do Power Apps anterior à versão 1.0.0.45 instalada, recomendamos que elimine a solução e a instale novamente. Devido a alterações recentes ao esquema, a atualização do Verificador do Power Apps das versões anteriores à versão 1.0.0.45 pode falhar.

Se pretende manter os resultados passados do verificador de soluções, exporte os resultados de uma execução anterior ou exporte todos os dados do verificador de soluções através da opção Exportar dados para o Excel para exportar os dados das seguintes tabelas:

• Componente de Análise
• Tarefa de Análise
• Resultado da Análise
• Detalhe de Resultados da Análise

Como desinstalar o Verificador do Power Apps

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

1. Como Administrador de Sistema ou Personalizador de Sistemas, abra o portal Power Apps ao visitar https://make.powerapps.com/environments.
2. Selecione Soluções.
3. Selecione Verificador do Power Apps e, em seguida, na barra de ferramentas de soluções, selecione Eliminar.

Como instalar o Verificador do Power Apps

Para instalar o Verificador do Power Apps no seu ambiente:

1. Como Administrador de Sistema ou Personalizador de Sistemas, abra o portal Power Apps ao visitar https://make.powerapps.com/environments.
2. Selecione Soluções.
3. Na barra de ferramentas de soluções, selecione Verificador de soluções e, em seguida, selecione Instalar.

O Verificador de soluções não consegue aceder aos ambientes em Modo de Administração

Os ambientes colocados no Modo de Administração restringem intencionalmente o acesso a utilizadores com as funções de Administrador de Sistema e de Personalizador de Sistemas. Como a identidade de aplicação Verificador do Power Apps não tem nenhuma destas funções atribuída por predefinição, não consegue aceder às organizações a funcionar neste modo.

Para utilizar o Verificador de soluções nesta organização, o Modo de Administração tem de estar desativado.

Como desativar o modo de administração

Para desativar o modo de administração para uma instância de organização:

1. Inicie sessão no centro de administração do Power Platform.

2. Abra o ambiente com problemas ao executar o verificador de soluções e, em seguida, selecione Editar.

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

   

4. Execute novamente o verificador de soluções.

O verificador de soluções falha devido à falta de direitos de acesso

O utilizador da aplicação para o verificador de soluções necessita dos seguintes direitos de acesso atribuídos para fornecer os privilégios necessários para comunicar com a organização do Dataverse. Se quaisquer destas funções não forem atribuídas à "Aplicação Verificador de Power Apps" do utilizador, as tentativas para executar análises, transferir resultados e executar o cancelamento falharão. Isto ocorre com maior frequência quando os clientes têm automatização no local que remove os direitos de acesso de utilizadores inesperados. Os seguintes direitos de acesso contêm as permissões mínimas necessárias:

• Exportar personalizações (verificador de soluções)
• Escritor do Serviço
• Verificador de Soluções

Como atribuir os direitos de acesso em falta

Para atribuir os direitos de acesso em falta ao utilizador da Aplicação Verificador de Power Apps:

1. No centro de administração do Power Platform, navegue para o seu ambiente e, em seguida, para Utilizadores > lista de utilizadores da aplicação.
2. Selecione o utilizador da "Aplicação Verificador de Power Apps" a partir da lista de utilizadores.
3. Selecione Editar direitos de acesso na barra de comando.
4. Selecione as caixas de verificação para as funções listadas acima e, em seguida, selecione Guardar.
5. Execute novamente o verificador de soluções.

O Verificador de soluções falha devido ao modo de acesso restrito

O utilizador da aplicação para o verificador de soluções necessita de um modo de acesso "Não-interativo" ou "Leitura-Escrita" para comunicar com a organização do Dataverse. Se o modo de acesso tiver sido alterado para outro valor, como "Administrador", as tentativas de execução da análise, transferência de resultados e execução da cancelamento irão falhar.

Para resolver este problema, tem de atualizar o utilizador da aplicação "Verificador do Power Apps" com o modo de acesso "Não interativo".

Como atualizar o modo de acesso de utilizador

Para atualizar o modo de acesso de utilizador para o utilizador Verificador do Power Apps:

1. Abra a sua organização do Dataverse e navegue para Definições > Segurança > Utilizadores.
2. Selecione o utilizador "Verificador do Power Apps" a partir da lista de utilizadores e faça duplo clique para abrir o formulário de utilizador.
3. Desloque-se para a secção "Administração" > "Informações de Licença de Acesso de Cliente (CAL)" do formulário.
4. Selecione "Não interativo" no controlo drop-down Modo de Acesso.

5. Guarde e feche o formulário de utilizador.
6. Execute novamente o verificador de soluções.

O Verificador de Soluções falha devido a utilizador de aplicação desativado

O utilizador da aplicação do Verificador do Power Apps na organização do Dataverse que contém soluções a ser analisadas tem de estar ativado. Se o utilizador da aplicação for desativado, as solicitações para analisar soluções na mesma organização irão falhar. Se estiver a receber esta mensagem de erro, primeiro verifique se o utilizador da aplicação do Verificador do Power Apps está de fato desativado. Em seguida, siga os passos de mitigação fornecidos abaixo.

Como ativar o utilizador da aplicação do verificador de soluções do Power Apps

1. No Centro de Administração do Power Platform, selecione o ambiente e aceda a Definições > + Permissões do Utilizador > Utilizadores.
2. Na vista Utilizadores da Aplicação, selecione a marca de verificação junto do utilizador da Aplicação do Verificador do Power Apps.
3. Na barra de ferramentas Ações, selecione Ativar.

4. Na mensagem Confirmar Ativação de Utilizador, selecione Ativar.
5. Uma abordagem alternativa consiste em abrir o formulário de utilizador da aplicação e selecionar o estado Ativado no rodapé do formulário. Guarde a alteração.

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

O Verificador de solução pode permanecer indefinidamente em funcionamento se a solução analisada contiver componentes plugin desenvolvidos utilizando .NET Standard 2.0. Os plugins que utilizam .NET Standard 2.0 não são atualmente suportados no verificador de soluções e devem ser excluídos da análise. Exclua o componente plugin removendo-o da solução-alvo ou utilizando o parâmetro 'ExcludedFileNamePattern' no módulo Power Apps Verificador PowerShell.

Condições de plug-in comuns que fazem com que o verificador de soluções falhe

Quando o verificador de soluções recebe e processa pedidos de análise, tem de chamar o ponto final do Dataverse para obter/atualizar dados de tarefas relevantes e exportar a(s) solução(ões) selecionada(s). Cada interação efetuada pelo serviço do verificador de soluções com o Dataverse poderá acionar potencialmente um ou mais passos de plug-in que tenham sido registados na mensagem submetida no pedido. Estes plug-ins poderão, por sua vez, introduzir condições que impeçam a mensagem de ser processada conforme esperado pelo Dataverse e interromper a capacidade do verificador de soluções processar a tarefa de análise solicitada. Situações semelhantes podem ocorrer ao transferir resultados de tarefas do verificador de soluções ou ao cancelar uma tarefa de análise em curso.

Operações do Dataverse típicas pedidas pelo verificador de soluções:

• Obter dados de tabela de solução, de systemuser e de organização
• Criar, atualizar e obter tarefa de análise, componente de análise e dados de tabela de resultados de análise
• Exportar soluções

Passo do plug-in registado para ser executado no contexto de um utilizador não licenciado

Quando o verificador de soluções falha devido a uma exceção "utilizador não licenciado", normalmente, é causado por um passo de plug-in acionado configurado para ser executado no contexto de um utilizador de sistema específico que atualmente não está licenciado. Certifique-se de que os passos de plug-in que podem ser acionados pelo verificador de soluções são executados no contexto de um utilizador licenciado.

Importante

É altamente recomendável que os passos do plug-in sejam configurados para serem executados no contexto do utilizador que faz a chamada, em vez de utilizadores específicos que estão sujeitos à licença atribuída que está a ser revogada.

O passo do plug-in efetua operações que necessitam de privilégios não concedidos ao utilizador da aplicação do Verificador do Power Apps

Quando o verificador de soluções falha devido ao Dataverse negar acesso com base num privilégio em falta, normalmente, é causado por um passo de plug-in acionado que efetua operações que requerem privilégios que não são concedidos atualmente ao utilizador da aplicação do Verificador do Power Apps. Reconfigure o passo de plug-in para não ser executado na operação chamada pelo verificador de soluções ou conceda ao utilizador da aplicação do Verificador do Power Apps os privilégios necessários para executar o passo de plug-in personalizado.

O passo do plug-in interrompe inesperadamente a execução lançando InvalidPluginExecutionException

O verificador de solução pode falhar devido aos erros "O código ISV abortou a operação" ou "Ocorreu um erro inesperado do código ISV". Quando isto ocorre, indica que foi acionado um passo do plug-in que interrompeu explicitamente a execução ao gerar uma InvalidPluginExcecutionException ou que um erro não foi detetado devidamente no código do plug-in. Reconfigure o passo de plug-in para não executar na operação chamada pelo verificador de soluções 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ções.

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

O verificador de solução falha devido a uma aplicação própria desativada no Microsoft Entra ID

A identidade de aplicação empresarial própria utilizada pelo verificador de soluções (PowerApps-Advisor) não deve estar desativada no Microsoft Entra (AAD). Se estiver desativada, a identidade não consegue fazer a autenticação quando pede tokens de portador para o Dataverse e outros fornecedores de recursos necessários em nome do utilizador requerente.

Siga os passos abaixo para verificar se a identidade de aplicação não foi desativada no Microsoft Entra e, se necessário, ativar a aplicação.

Como verificar e/ou modificar o estado ativado da aplicação

Para verificar e/ou modificar o estado ativado da identidade de aplicação empresarial do PowerApps-Advisor

1. Aceda ao seu inquilino noPortal do Microsoft Entra.
2. Navegue para Aplicações Empresariais.
3. Selecione Toda a Aplicação e procure "PowerApps-Advisor".

4. Selecione "PowerApps-Advisor" para ver os detalhes da aplicação.
5. Selecione Propriedades.
6. Verifique o estado de Ativado para os utilizadores iniciarem sessão. Se "Não", a aplicação foi desativada.

7. Selecione o controlo de rádio para mudar o valor para "Sim". A aplicação é ativada.

8. Selecione Guardar. A aplicação está agora ativada. Pode ter de esperar alguns minutos para a alteração ser propagada.
9. Execute novamente o verificador de soluções.

Importante

Tem de ter privilégios de administrador no Microsoft Entra ID (Microsoft Entra ID) para editar aplicações empresariais.

O verificador de soluções falha na exportação de soluções com componentes fluxos do processo de negócio de rascunho

Se uma solução contiver um componente do fluxo do processo de negócio no estado de rascunho que nunca tenha sido ativado anteriormente, o verificador de soluções falhará na exportação da solução para análise. Este erro não é exclusivo do verificador de soluções e é causado pelo fluxo de processo empresarial com uma dependência de um componente de tabela de contingência (personalizada) que não é criada até que o fluxo de processo empresarial seja ativado pela primeira vez. Este problema também pode ocorrer se um fluxo do processo de negócio for ativado no explorador de soluções.

Consulte Artigo BDC #4337537: Exportação Inválida – Tabela de Processo de Negócio em Falta para obter mais informações sobre o problema e os passos para a resolução.

Verificador de soluções falha na exportação de soluções com componentes de aplicações condicionadas por modelos

Se uma solução contém uma aplicação condicionada por modelo, o verificador de soluções poderá falhar na exportação da solução para análise. Este erro é causado pela segurança baseada em papéis para a partilha de aplicações. Se o utilizador da aplicação Verificador do Power Apps não tiver acesso adequado a aplicações condicionadas por modelos, quaisquer soluções que as contenham não serão exportadas com verificador de soluções.

Para resolver este problema, conceda o direito de acesso do Criador do ambiente ao utilizador da aplicação do verificador do Power Apps.

O Verificador de soluções falha na exportação de soluções corrigidas

Se uma solução tiver tido uma correção aplicada, o verificador de soluções falhará na exportação da solução para análise. Quando uma solução teve uma correção aplicada, a solução original fica bloqueada e não pode ser alterada ou exportada, desde que existam correções dependentes na organização que identifiquem a solução como solução principal.

Para resolver este problema, clone a solução para todas as correções relacionadas com a solução serem integradas na solução criada recentemente. Isto desbloqueia a solução e permite que a solução seja exportada a partir do sistema. Para mais informações, consulte Clonar uma Solução.

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

Se o verificador de soluções exportar uma solução que não contenha componentes para análise, termina o processamento futuro e considera a execução como uma falha. Certifique-se de que a solução selecionada submetida para uma análise do verificador de soluções contém pelo menos um componente.

O Verificador de soluções falha na exportação de grandes soluções

O cenário primário por falha na exportação de uma grande solução a partir do ambiente envolve uma exceção de tempo limite no pedido de exportação. Isto ocorre se o pedido exceder 20 minutos. As grandes soluções, como a Solução Predefinida, podem falhar na exportação neste intervalo de tempo e a verificação não será concluída com êxito. Se o verificador de soluções encontrar um tempo limite durante a exportação, volta a tentar três vezes antes de falhar o processamento da tarefa, pelo que pode demorar mais de uma hora antes de receber uma notificação de falha.

A solução é criar soluções de menor dimensão com menos componentes para análise. Se o tamanho de ficheiro grande da solução for devido a demasiados componentes do conjunto de plug-in, consulte a documentação de orientação Otimizar o desenvolvimento do conjunto personalizado.

Importante

Para minimizar os falsos positivos, certifique-se de que adiciona personalizações dependentes. Quando cria uma solução e adiciona estes componentes, inclua o seguinte:

• Quando adiciona plug-ins, inclua os Passos de Processamento de Mensagens SDK para o plug-in.
• Quando adiciona formulários de tabela, inclua os recursos Web de JavaScript anexados aos eventos de formulário.
• Quando adiciona recursos Web JScript, inclua quaisquer recursos Web JScript dependentes.
• Quando adiciona recursos Web de HTML, inclua quaisquer scripts dependentes que sejam definidos no recurso Web de HTML.
• Quando adiciona fluxos de trabalho personalizados, inclua a assemblagem utilizada no fluxo de trabalho.

As referências de linha de número para os problemas nos recursos HTML com JavaScript incorporado não estão corretas

Quando os recursos Web de HTML são processados no verificador de soluções, o recurso Web de HTML é processado separadamente do JavaScript no recurso Web de HTML. Por isto, o número de linha da violação encontrada no <script> do recurso Web de HTML não será corrigido.

Problema de sintaxe não suportada na Web para recursos Web

O verificador de soluções suporta variáveis globais para a sintaxe ECMAScript 2015 (ES6) e até ECMAScript 2018 (ES9). Quando o verificador de soluções analisa o JavaScript através de variáveis globais posteriores ao ES6, ou com sintaxe posterior ao ES9, é reportado um problema de sintaxe não suportada para o recurso Web.

Várias violações reportadas para plug-ins e atividades de fluxo de trabalho com base no âmbito de chamada

Para regras de plug-ins e de atividades de fluxo de trabalho em que o problema só é relevante no contexto de chamada, a ferramenta verificador de soluções inicia a análise na implementação da interface do IPlugin e percorre um gráfico de chamadas para detetar problemas dentro do âmbito da implementação. Em alguns casos, muitos caminhos de chamada podem chegar ao mesmo local onde o problema é detetado. Uma vez que o problema é relevante para o âmbito de chamada, a ferramenta poderá reportar com base nesse âmbito para fornecer uma melhor visão do impacto, em vez de em localizações diferentes. Como resultado, vários problemas podem fazer referência a uma única localização que deve ser corrigida.

aplicações-fórmula-problemas-alto pode mostrar um número diferente de erros do que os mostrados no modo de desenho

O verificador de soluções lista o número de erros encontrados na aplicação, incluindo os dos testes. O verificador de aplicações no modo de design apenas mostra erros dos controlos e componentes do ecrã. Se a contagem de erros mostrada no verificador de aplicações no modo de design for menor, abra o Test Studio e procure os erros nas expressões utilizadas nos testes.

Violações do Verificador de soluções reportadas para componentes de código

O Verificador de soluções reporta múltiplas violações quando é executado na solução que tem componentes de código incorporados no modo de depuração. Um erro comum que ocorre no modo de depuração é web-avoid-eval. O Verificador de soluções é direcionado para validar código para utilização de produção, pelo que os componentes do código devem ser compilados utilizando 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 no bundle.js introduzidos por componentes de código, pode excluir este ficheiro da análise. Mais informações: Microsoft.PowerApps.Checker.PowerShell module e PAC CLI

Consulte também

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

Melhores práticas e orientação para aplicações orientadas por modelos

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).