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 executar a comprobación da solución [Nome da solución]. Tenta executala 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. Seleccione "Máis información" para ver os detalles.
Os fallos que ocorren durante o procesamento en segundo plano da análise fallarán con estado 'Non se puido completar' e mostrarán unha mensaxe de erro no portal de Power Apps, ademais de enviar 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 frecuentes que se mostran non resolve o problema, tamén se mostra un número de referencia. Proporcione este número de referencia ao soporte técnico de Microsoft para máis investigación.
O comprobador de solucións non pode comprobar 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: O verificador de solucións non exporta grandes solucións.
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 ten unha versión da aplicación do verificador de Power Apps instalada anterior a 1.0.0.47, o verificador de solucións pode non completarse correctamente. Debe actualizar a versión do verificador de Power Apps desde o Centro de administración de Power Platform.
No entanto, se ten unha versión do verificador de Power Apps anterior a 1.0.0.45 instalada, recomendámoslle que elimine a solución e que volva instalala. Debido a modificacións recentes no esquema, é posible que non funcione a actualización do verificador de Power Apps de versións anteriores a 1.0.0.45.
Se desexa manter os resultados anteriores do verificador de solucións, exporte os resultados dunha execución anterior ou exporte todos os datos do verificador de solucións utilizando Exportar datos a Excel para exportar os datos desde as 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:
- Como administrador do sistema ou personalizador do sistema, abra o portal de Power Apps indo a https://make.powerapps.com/environments.
- Seleccionar Solucións.
- Seleccione Verificador de Power Apps e despois, na barra de ferramentas da solución, seleccione Eliminar.
Como instalar o verificador de Power Apps
Para instalar Power Apps Checker de novo no teu entorno:
- Como administrador do sistema ou personalizador do sistema, abra o portal de Power Apps indo a https://make.powerapps.com/environments.
- Seleccionar Solucións.
- Na barra de ferramentas da solución, seleccione Verificador de solucións e despois, seleccione Instalar.
O verificador de solucións non pode acceder aos ambientes no modo de administración
Os ambientes que se colocaron en Modo de administración restrinxen deliberadamente o acceso a só os usuarios cos roles de administrador do sistema e 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:
Inicie sesión no Centro de administración de Power Platform.
Abra o contorno que ten problemas ao executar o verificador de solucións e seleccione Editar.
Defina o Modo de administración en desactivado e, a seguir, prema Gardar.
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 dous roles de seguranza asignados para proporcionar os privilexios necesarios para comunicarse co Dataverse organización. Se algún destes roles non está atribuído ao 'Verificador de Power Apps' do usuario, fallarán os intentos de executar a análise, descargar os resultados e executar a cancelació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:
- Exportar personalizacións
- Verificador de solucións
Como atribuír os roles de seguranza que faltan
Para atribuír os roles de seguranza que faltan ao usuario do verificador de Power Apps:
- Abra a súa organización de Dataverse e navegue a Configuración > Seguranza > Usuarios.
- Seleccione o usuario de 'Verificador de Power Apps' na lista de usuarios.
- Seleccione XESTIONAR ROLES na barra de comandos.
- Seleccione as caixas de roles "Exportar personalizacións" e "Verificador de solucións", e, a seguir, seleccione Aceptar.
- 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 verificador de solucións require un modo de acceso de "Non interactivo" ou "Lectura-Escritura" para comunicarse coa organización de Dataverse. Se o modo de acceso cambiou a outro valor como "Administrativo", fallarán os intentos de executar a análise, descargar resultados e executar a cancelación.
Para resolver este problema, debe actualizar o usuario da aplicación do 'Verificador de Power Apps' 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:
- Abra a súa organización de Dataverse e navegue a Configuración > Seguranza > Usuarios.
- Seleccione o usuario do 'Verificador de Power Apps' na lista de usuarios e prema dúas veces para abrir o formulario de usuario.
- Desprácese ata a sección "Administración" > "Información da licenza de acceso do cliente (CAL)" do formulario.
- Seleccione "Non interactivo" no control despregable Modo de acceso.
- Garde e peche o formulario de usuario.
- 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 Verificador de Power Apps
- No Centro de administración de Power Platform, seleccione o contorno e vaia a Configuración > Usuarios + Permisos > Usuarios.
- Na visualización Usuarios da aplicación, seleccione a marca de verificación situada ao lado do usuario da aplicación Verificador de Power Apps.
- Na barra de ferramentas Accións, seleccione Activar.
- Na mensaxe Confirmar activación de usuario, seleccione Activar.
- Un enfoque alternativo consiste en abrir o formulario do usuario da aplicación e seleccionar o estado Activado no pé de páxina do formulario. Garde a modificación.
O comprobador de solucións permanece en estado de execución durante máis de trinta 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úe o compoñente do complemento eliminándoo da solución de destino ou utilizando o parámetro 'ExcludedFileNamePattern' no Power Apps Módulo 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:
- Recuperar datos da solución, do usuario do sistema e da táboa de 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 verificador de solucións falla debido a unha excepción de "usuario sen licenza", moitas veces é causada por un paso de complemento activado configurado para executarse no contexto dun usuario específico do sistema actualmente sen 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 verificador de solucións falla debido a que Dataverse denega o acceso baseándose nun privilexio que falta, moitas veces é causado por un paso de complemento activado que realiza operacións que requiren privilexios que actualmente non se conceden ao usuario da aplicación Verificador de Power Apps. 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 activou un paso do complemento que interrompeu explicitamente a execución lanzando unha excepción InvalidPluginExcecutionException ou que un erro non se captou 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 Verificador de solucións falla debido a que a aplicación da primeira parte está desactivada en Azure Active Directory
A identidade de aplicación empresarial da primeira parte utilizada polo verificador de solucións (PowerApps-Advisor) non debe desactivarse en Azure Active Directory (AAD). Se está desactivada, a identidade non se pode autenticar ao solicitar tokens ao portador para Dataverse e outros fornecedores de recursos necesarios en nome do usuario solicitante.
Siga os pasos que se indican debaixo para comprobar que a identidade da aplicación non foi desactivada en AAD e, se é necesario, active 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
- Acceda ao seu arrendatario no Portal de Azure Active Directory (AAD).
- Navegue a Aplicacións empresariais.
- Seleccione Todas as aplicacións e busque 'PowerApps-Advisor'.
- Seleccione 'PowerApps-Advisor' para ver os detalles da aplicación.
- Seleccione Propiedades.
- Comprobe o estado de Activado para que os usuarios inicien sesión. Se é "Non", a aplicación foi desactivada.
- Seleccione o control de opción para cambiar o valor a "Si". Isto activa a aplicación.
- Seleccione Gardar. Agora a aplicación está activada É posible que teña que agardar uns minutos para que se propague o cambio.
- Execute de novo o verificador de solucións.
Importante
Debe ter privilexios de administrador en Azure Active Directory (AAD) para editar aplicacións empresariais.
O comprobador de solucións non pode exportar solucións con compoñentes de borrador fluxo do proceso de negocio
Se unha solución contén un compoñente fluxo do proceso de negocio en estado de borrador que nunca se activou previamente, o comprobador de solucións non poderá exportar a solución para a súa análise. Este erro non é exclusivo do comprobador de solucións e é causado porque o fluxo do proceso de negocio ten unha dependencia 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.
Referencia Artigo de KB n.º 4337537: Exportación non válida - Falta a táboa do proceso de negocio para obter máis información sobre o problema e os pasos para resolvelo.
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, o comprobador de solucións pode fallar ao exportar a solución para a súa análise. Este erro é causado pola seguridade baseada en funcións para compartir aplicacións. Se o usuario da aplicación Verificador de Power Apps non ten o acceso axeitado ás aplicacións baseadas en modelos; as solucións que as conteñan non poderán exportarse co verificador de solucións.
Para resolver este problema, conceda o rol de seguranza Creador de ambientes ao usuario da aplicación de comprobación de Power Apps.
O verificador de solucións non pode exportar solucións con parches
Se unha solución tivo a 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 máis información, consulte Clonar unha solución.
O verificador 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, finalizará o procesamento posterior e considerará a execución como un erro. Asegúrese de que a solución seleccionada enviada para unha análise do comprobador de solucións conteña polo menos un compoñente.
O comprobador de solucións non consegue exportar solucións grandes
O escenario principal para non exportar unha solución grande dende o ambiente implica unha excepción de tempo de espera na solicitude de exportación. Isto ocorrerá se a solicitude supera os 20 minutos. As solucións grandes, como a solución predefinida, poden non exportarse neste período de tempo e a comprobación non se completará correctamente. Se o verificador de solucións atopa un tempo de espera durante a exportación, fará tres intentos antes de non poder procesar o traballo, polo que recibir unha notificación de erro pode demorar máis de unha hora.
A solución é crear solucións máis pequenas con menos compoñentes para analizar. Se o gran tamaño da solución é debido aos moitos compoñentes da ensamblaxe do complemento, consulte a orientación para Optimizar o desenvolvemento da ensamblaxe personalizada.
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 do número de liña para problemas nos recursos de 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 no <script> do recurso web HTML non será correcto.
Erro de avaliación que evita a web para compoñentes de código de Power Apps Component Framework
Se se informa dun erro de avaliación que evita a web por un compoñente de código de Power Apps Component Framework creado con ferramentas CLI, empaquete o control con msbuild /p:configuration=Release ou npm run build -- --buildMode production para producir unha versión de lanzamento que non inclúa o uso de "eval".
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
No caso de regras da actividade do fluxo de traballo e complemento onde o problema só é relevante no contexto de chamas, a ferramenta Verificador de solucións comeza a súa análise na implantación da interface de IPlugin e percorre a gráfica de chamadas para detectar os problemas dentro do ámbito desa implantació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 enumerará 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 de deseño é menor, abra Test Studio e busque os erros nas expresións empregadas nas probas.
Notificáronse infraccións do comprobador de solucións para compoñentes de código
O verificador de solucións notifica varias violacións cando se executa na solución que ten compoñentes de código integrados no modo de depuración. O comprobador de solucións está enfocado a validar o código para o seu uso na produción, polo que os compoñentes de código deben construírse usando o buildMode axeitado: npm run build -- --buildMode production or msbuild /p:configuration=Release dependendo do seu sistema de construción. Máis información: Crear e compilar un compoñente de código.
Consulte tamén
Prácticas recomendadas e orientación para Dataverse
Prácticas recomendadas e orientación para aplicacións controladas por modelos
Nota
Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)
Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).
Comentarios
Enviar e ver os comentarios