Problemas comúns e resolucións do verificador de solucións

Neste artigo indícanse algúns problemas comúns que poden xurdir durante a utilización do verificador de solucións. Proporciónanse solucións alternativas se é necesario.

Non pode usar o verificador de solucións para executar análises ou descargar resultados

Pouco despois de enviar unha solicitude do verificador de solucións para realizar unha análise ou descargar resultados, a operación non se completa e móstrase unha mensaxe de erro, como:

"Non puidemos realizar a comprobación da solución [Nome da solución] . Tenta executalo de novo".

Sempre que sexa posible, o verificador de solucións tenta devolver unha mensaxe de erro específica cunha ligazón aos detalles sobre a posible causa e os pasos para a resolución. Selecciona "Máis información" para obter máis información.

Os erros que se produzan durante o procesamento en segundo plano da análise fallarán co estado "Non se puido completar" e devolverán unha mensaxe de erro no Power Apps portal e enviarán unha notificación por correo electrónico ao solicitante.

A selección da notificación do portal ligará a esta páxina de problemas frecuentes para solucionar os problemas. Se un dos problemas comúns proporcionados non resolve o problema, tamén se devolve un número de referencia. Proporcione este número de referencia ao soporte técnico de Microsoft para máis investigación.

O verificador de solucións non comproba a solución predeterminada

O verificador de solucións exporta a solución desde o ambiente de Microsoft Power Platform para a análise. Non se admite a exportación da solución predeterminada e é posible que a comprobación non se complete correctamente. Máis información: Solution Checker non pode exportar solucións grandes.

O verificador de solucións falla debido a que a versión do verificador de Power Apps non é compatible

O verificador de solucións é unha funcionalidade activada pola aplicación do verificador de Power Apps. Se instalou unha Power Apps versión da aplicación Checker anterior á versión 1.0.0.47, é posible que as execucións do comprobador de solucións non se completen correctamente. Deberías actualizar a túa Power Apps versión de Checker desde o Power Platform centro de administración.

Non obstante, se tes instalada unha Power Apps versión de Checker anterior á versión 1.0.0.45 , recomendámosche que elimines a solución e a instales de novo. Debido aos cambios recentes no esquema, é posible que falle a actualización de Power Apps Checker desde versións anteriores á versión 1.0.0.45 .

Se queres conservar os resultados anteriores do comprobador de solucións, exporta os resultados dunha execución anterior ou exporta todos os datos do comprobador de solucións mediante Exportar datos a Excel para exportar os datos das seguintes táboas:

• Compoñente de análise
• Traballo de análise
• Resultado da análise
• Detalle do resultado de análise

Como desinstalar o verificador de Power Apps

Para desinstalar a solución do verificador de Power Apps:

1. Como administrador do sistema ou como personalizador do sistema, abra o Power Apps portal accedendo a https://make.powerapps.com/environments.
2. Seleccionar Solucións.
3. Seleccione Power Apps Comprobador e, a continuación, na barra de ferramentas de solucións seleccione Eliminar.

Como instalar o verificador de Power Apps

Para instalar o verificador de Power Apps de novo no seu ambiente:

1. Como administrador do sistema ou como personalizador do sistema, abre o teu Power Apps portal accedendo a https://make.powerapps.com/environments.
2. Seleccionar Solucións.
3. Na barra de ferramentas da solución, seleccione Comprobador de solucións e, a continuación, seleccione Instalar.

O verificador de solucións non pode acceder aos ambientes no modo de administración

Os ambientes que se colocaron no Modo de administración restringen o acceso só aos usuarios con roles de administrador do sistema e de personalizador do sistema. Como a identidade da aplicación do verificador de Power Apps non ten ningún destes roles asignados por defecto, non pode acceder a organizacións que operan neste modo.

Para usar o verificador de solucións nesta organización, o modo de administración debe desactivarse.

Como desactivar o modo de administración

Para desactivar o modo de administración para unha instancia de organización:

1. Inicie sesión no Power Platform centro de administración.

2. Abre o ambiente que ten problemas ao executar o comprobador de solucións e, a continuación, selecciona Editar.

3. Establece o Modo de administración en Desactivado e, a continuación, selecciona Gardar.

   

4. Execute de novo o verificador de solucións.

O verificador de solucións falla debido a que faltan roles de seguranza

O usuario da aplicación para o comprobador de solucións require as seguintes funcións de seguranza asignadas para proporcionar os privilexios necesarios para comunicarse coa Dataverse organización. Se algún destes roles non está asignado ao usuario 'Power Apps Aplicación Checker', os intentos de realizar análises, descargar resultados e cancelar a execución fallarán. Isto ocorre con máis frecuencia cando os clientes teñen unha automatización que elimina os roles de seguranza de usuarios inesperados. Os seguintes roles de seguranza conteñen os permisos mínimos necesarios:

• Personalizacións de exportación (Comprobador de solucións)
• Escritor de servizos
• Verificador de solucións

Como atribuír os roles de seguranza que faltan

Para asignar as funcións de seguranza que faltan ao usuario da aplicación Power Apps Checker:

1. No Power Platform centro de administración, abre o teu contorno e, a continuación, selecciona Usuarios>lista de usuarios da aplicación.
2. Seleccione o usuario Power Apps Aplicación Checker da lista de usuarios.
3. Seleccione Editar roles de seguranza na barra de comandos.
4. Seleccione as caixas de verificación dos roles indicados anteriormente e, a continuación, seleccione Gardar.
5. Execute de novo o verificador de solucións.

O verificador de solucións falla debido ao modo de acceso restrinxido

O usuario da aplicación para o comprobador de solucións require un modo de acceso 'Non interactivo' ou 'Lectura-Escritura' para comunicarse coa Dataverse organización. Se se cambiou o modo de acceso a outro valor como "Administrativo", os intentos de realizar análises, descargar resultados e cancelar a execución fallarán.

Para resolver este problema, debes actualizar o usuario da Power Apps Aplicación Checker co modo de acceso "Non interactivo".

Como actualizar o modo de acceso do usuario

Para actualizar o modo de acceso para o usuario do verificador de Power Apps:

1. En Power Apps (make.powerapps.com) seleccione o seu entorno e, a continuación, seleccione Configuración>Configuración avanzada>Administración>Usuarios para abrir a configuración de usuario antiga.

2. Abre o usuario Power Apps Aplicación Checker da lista de usuarios.

3. Desprácese ata a sección Información da licenza de acceso ao cliente (CAL)>de administración e seleccione "Non interactivo" no Control do modo de acceso p>.

   

4. Garde e peche o formulario de usuario.

5. Execute de novo o verificador de solucións.

O verificador de solucións falla debido a que o usuario da aplicación está desactivado

O usuario da aplicación do Verificador de Power Apps na organización Dataverse que contén solucións para analizar debe estar activado. Se o usuario da aplicación queda desactivado, as solicitudes para analizar solucións na mesma organización fallarán. Se recibe esta mensaxe de erro, verifique primeiro que o usuario da aplicación Verificador de Power Apps está desactivado. A continuación, siga os pasos de mitigación seguintes.

Como activar o usuario da aplicación Power Apps Checker

1. No Power Platform Centro de administración, abre o contorno e vai a Configuración>Permisos de usuario+>Usuarios.
2. Na vista Usuarios da aplicación , seleccione o usuario Power Apps Aplicación Checker .
3. Na barra de comandos, seleccione Activar
4. Na mensaxe Confirmar activación do usuario , seleccione Activar.

O comprobador de solucións permanece en estado de execución durante máis de 30 minutos

O comprobador de solucións pode permanecer en estado de execución indefinidamente se a solución analizada contén compoñentes de complementos desenvolvidos mediante .NET Standard 2.0. Os complementos que usan .NET Standard 2.0 non se admiten actualmente no comprobador de solucións e deben excluírse da análise. Exclúa o compoñente do complemento eliminándoo da solución de destino ou utilizando o parámetro "ExcludedFileNamePattern" no módulo Power Apps Checker PowerShell.

Condicións comúns de complemento que fan que o verificador de solucións falle

Cando o comprobador de solucións recibe e procesa solicitudes de análise, debe chamar ao extremo de Dataverse para recuperar/actualizar datos relevantes do traballo e exportar as solucións seleccionadas. Cada interacción feita polo servizo do verificador de solucións co Dataverse podería provocar un ou varios pasos do complemento rexistrados na mensaxe enviada na solicitude. É posible que estes complementos introduzan condicións que impidan que a mensaxe sexa manexada como é esperado polo Dataverse e interrompa a capacidade do verificador de solucións de procesar o traballo de análise solicitado. Pódense producir situacións similares ao descargar os resultados do traballo do verificador de solucións ou cancelar un traballo de análise en curso.

Operacións do Dataverse típicas solicitadas polo verificador de solucións:

• Recupera os datos da táboa de solucións, systemuser e da organización
• Crear, actualizar e recuperar datos do traballo de análise, compoñente de análise e táboa de resultados de análise
• Exportar solucións

Paso de complemento rexistrado para executar no contexto dun usuario sen licenza

Cando o comprobador de solucións falla debido a unha excepción de "usuario sen licenza", adoita ser causado por un paso de complemento activado configurado para executarse no contexto dun usuario específico do sistema que actualmente non ten licenza. Asegúrese de que todos os pasos de complemento que poidan ser activados polo comprobador de solucións se executen no contexto dun usuario con licenza.

Importante

É moi recomendable que se configuren os pasos do complemento para que se executen no contexto do usuario que chama en lugar de usuarios específicos que están suxeitos a que a licenza asignada sexa revogada.

O paso do complemento realiza operacións que requiren privilexios non concedidos ao usuario da aplicación Verificador de Power Apps

Cando o comprobador de solucións falla debido a Dataverse denegar o acceso en base a un privilexio que falta, moitas veces é causado por un paso de complemento desencadeado que realiza operacións que requiren privilexios que non se conceden actualmente ao usuario da aplicación Power Apps Checker. Configure de novo o paso do complemento para que non se execute na operación invocada polo verificador de solucións ou conceda ao usuario da aplicación Verificador de Power Apps os privilexios necesarios para executar o paso do complemento personalizado.

O paso do complemento interrompe inesperadamente a execución lanzando InvalidPluginExecutionException

O comprobador de solucións pode fallar debido aos erros "O código ISV interrompeu a operación" ou "Produciuse un erro inesperado a partir do código ISV". Cando isto ocorre, indica que se disparou un paso do complemento que interrompeu explícitamente a execución ao lanzar unha excepción InvalidPluginExcecutionException ou que un erro non se detectou correctamente no código do complemento. Configure de novo o paso do complemento para non executar a operación invocada polo verificador de solucións ou axuste a implementación do complemento para non interromper a execución en función das condicións presentadas polo verificador de solucións.

As operacións comúns invocadas polo comprobador de solucións inclúen Crear e Actualizar. Estas operacións pódense producir nas táboas seguintes: traballo de análise, compoñente de análise ou resultado da análise.

O comprobador de solucións falla debido a unha aplicación propia desactivada en Microsoft Entra ID

Non se debe desactivar a identidade da aplicación empresarial propia que utiliza o comprobador de solucións (PowerApps-Advisor) no Microsoft Entra ID. Se está desactivada, a identidade non se pode autenticar cando se solicitan tokens de portador para Dataverse e outros provedores de recursos necesarios en nome do usuario solicitante.

Siga os pasos seguintes para verificar que a identidade da aplicación non se desactivou en Microsoft Entra e, se é necesario, activa a aplicación.

Como verificar e/ou modificar o estado de activación da aplicación

Para verificar e/ou modificar o estado de activación da identidade da aplicación empresarial PowerApps-Advisor

1. Accede ao teu inquilino no Microsoft Entra Portal.
2. Vaia a Aplicacións empresariais.
3. Seleccione Todas as aplicacións e busque 'PowerApps-Advisor'.

4. Seleccione 'PowerApps-Advisor' para ver os detalles da aplicación.
5. Seleccione Propiedades.
6. Comproba o estado de Activado para que os usuarios inicien sesión. Se 'Non', a aplicación desactivouse.

7. Seleccione o control de radio para cambiar o valor a 'Si'. Isto activa a aplicación.

8. Seleccione Gardar. Agora a aplicación está activada É posible que teña que agardar uns minutos para que se propague o cambio.
9. Execute de novo o verificador de solucións.

Importante

Debes ter privilexios de administrador en Microsoft Entra ID (Microsoft Entra ID) para editar aplicacións empresariais.

O verificador de solucións non pode exportar solucións co borrador dos compoñentes de fluxo do proceso de negocio

Se unha solución contén un compoñente de fluxo do proceso de negocio en estado de borrador que nunca foi activado previamente, o verificador de solucións non pode exportar a solución para a análise. Este erro non é exclusivo do comprobador de solucións e é causado porque o fluxo do proceso de negocio depende dun compoñente de táboa de apoio (personalizado) que non se crea ata que o fluxo do proceso de negocio se activa por primeira vez. Este problema tamén pode ocorrer se se activa un fluxo do proceso de negocio desde o explorador de solucións.

Consulta o Artigo da KB #4337537: Exportación non válida: falta a táboa de procesos de negocio para obter máis información sobre o problema e os pasos para resolver.

O comprobador de solucións non exporta solucións con compoñentes de aplicacións baseadas en modelos

Se unha solución contén unha aplicación baseada en modelos, pode que o verificador de solucións non exporte a solución para a análise. Este erro é causado pola seguridade baseada en funcións para compartir aplicacións. Se o usuario da aplicación Power Apps Checker non ten acceso adecuado ás aplicacións baseadas en modelos, as solucións que as conteñan non poderán exportar co comprobador de solucións.

Para resolver este problema, concede a Environment Maker función de seguranza ao Power Apps usuario da aplicación Checker.

O verificador de solucións non pode exportar solucións con parches

Se unha solución ten un parche aplicado, o comprobador de solucións non poderá exportar a solución para a súa análise. Se unha solución xa tivo un parche aplicado, bloquearase solución orixinal e non se poderá cambiar nin exportar mentres haxa parches dependentes que existen na organización que identifiquen a solución como a solución primaria.

Para resolver este problema, clone a solución para que todos os parches relacionados coa solución se revertan á nova solución creada. Isto desbloquea a solución e permite que a solución se poida exportar do sistema. Para obter máis información, consulte Clonar unha solución.

O comprobador de solucións non analizará solucións baleiras

Se o comprobador de solucións exporta unha solución que non contén compoñentes para analizar, finaliza o procesamento posterior e considera que a execución é un erro. Asegúrese de que a solución seleccionada presentada para a análise do verificador de solucións contén polo menos un compoñente.

O verificador de solucións non pode exportar solucións grandes

O escenario principal para non exportar unha solución grande desde o ambiente implica unha excepción de tempo de espera na solicitude de exportación. Isto ocorre se a solicitude supera os 20 minutos. É posible que as solucións grandes, como a solución predeterminada, non se exporten neste período de tempo e a comprobación non se complete correctamente. Se o comprobador de solucións atopa un tempo de espera durante a exportación, tente de novo tres veces antes de que falle ao procesar o traballo, polo que pode tardar máis dunha hora en recibir unha notificación de fallo.

A solución é crear solucións máis pequenas con menos compoñentes para analizar. Se o gran tamaño do ficheiro da solución débese a moitos compoñentes do conxunto de complementos, consulta a orientación para Optimizar o desenvolvemento de conxuntos personalizados.

Importante

Para minimizar os falsos positivos, asegúrese de engadir personalizacións dependentes. Ao crear unha solución e engadir estes compoñentes, debe incluír o seguinte:

• Cando engada complementos, inclúa os pasos de procesamento da mensaxe de SDK para o complemento.
• Cando engada formularios de táboa, inclúa os recursos web de JavaScript anexados aos eventos de formulario.
• Cando engada recursos web de JavaScript, inclúa calquera recurso web de JavaScript dependente.
• Cando engada recursos web de HTML, inclúa calquera script dependente que estea definido no recurso web de HTML.
• Cando engada fluxos de traballo personalizados, inclúa a ensamblaxe utilizada no fluxo de traballo.

As referencias de números de liña para problemas nos recursos HTML con JavaScript incorporado non son correctas

Cando os recursos web HTML se procesan no verificador de solucións, o recurso web HTML procésase por separado do JavaScript no recurso web HTML. Debido a isto, o número de liña da infracción atopada dentro <script> do recurso web HTML non será correcto.

Probema de sintaxe non compatible coa web para recursos web

O comprobador de solucións admite variables globais para ECMAScript 2015 (ES6) e ata sintaxe ECMAScript 2018 (ES9). Cando o comprobador de solucións analiza JavaScript usando variables globais posteriores a ES6 ou sintaxe posterior a ES9, infórmase dun problema de sintaxe non compatible coa web para o recurso web.

Notificáronse varias violacións de actividades de fluxos de traballo e complementos baseadas no ámbito de chamadas

Para as regras de actividade de complementos e fluxos de traballo onde o problema só é relevante no contexto da chamada, a ferramenta de verificación de solucións inicia a súa análise na IPlugin implementación da interface e percorre un gráfico de chamadas para detectar problemas no ámbito desa implementación. Nalgúns casos, moitos camiños de chamadas poden chegar á mesma localización onde se detecta o problema. Posto que o problema é relevante para o ámbito de chamadas, a ferramenta pode realizar informes segundo ese ámbito para fornecer unha imaxe mellor do impacto en lugar de facelo en distintas localizacións. Como resultado, varios problemas poden facer referencia a unha única organización que se debería corrixir.

app-formula-issues-high pode mostrar un número diferente de erros que os que se amosan no modo de deseño

O comprobador de solucións enumera o número de erros atopados na aplicación, incluídos os das probas. O comprobador de aplicacións no modo de deseño só mostra erros dos controis e compoñentes da pantalla. Se o reconto de erros que se mostra no comprobador de aplicacións no modo deseño é menor, abre o Estudio de probas e busca os erros nas expresións utilizadas nas probas.

Informáronse violacións do comprobador de solucións para os compoñentes do código

O comprobador de solucións informa de varias infraccións cando se executa na solución que ten compoñentes de código construídos no modo de depuración. Un erro común que se produce no modo de depuración é web-avoid-eval. O comprobador de solucións está dirixido a validar o código para o seu uso en produción, polo que os compoñentes do código deben crearse mediante o buildMode adecuado: npm run build -- --buildMode production ou msbuild /p:configuration=Release en función do seu sistema de construción. Máis información: Crea e crea un compoñente de código

Se se producen erros en bundle.js introducidos polos compoñentes do código, podes excluír este ficheiro da análise. Máis información: Módulo de Microsoft.PowerApps.Checker.PowerShell e CLI de PAC

Consulte tamén

Mellores prácticas e orientacións para o Dataverse

Mellores prácticas e orientación para aplicacións baseadas en modelos