Verificador de fluxo (versión preliminar)

[Este artigo é a documentación de prelanzamento e está suxeito a cambios.]

Mellora o teu fluxo de traballo de desenvolvemento coa función de análise estática do verificador de solucións . Esta ferramenta admite as mellores prácticas na automatización de procesos robóticos (RPA) e cumpre cos requisitos críticos de fluxo avaliando automaticamente os fluxos para garantir un rendemento óptimo. A análise estática está dispoñible na sección *Comprobador de fluxo* do deseñador. Aplica directrices clave e proporciona comentarios en tempo real e inspección anticipada do código. Intégrase directamente no teu fluxo de traballo, mellora a calidade do código e senta as bases para unha experiencia de desenvolvemento máis eficiente e produtiva.

Importante

• Esta é unha funcionalidade de vista previa.
• As funcionalidades en versión preliminar non están destinadas a usarse en produción e poderían ter restrinxida a funcionalidade. Estas funcionalidades están suxeitas a *condicións de uso suplementarias* e están dispoñibles antes do lanzamento oficial para que os clientes poidan obter acceso anticipado e proporcionar comentarios. ...

Xestión de regras

As regras defínense e xestiónanse mediante o verificador de solucións no centro de administración. Power Platform Os administradores poden:

• Activar ou desactivar regras.
• Configurar os niveis de gravidade (erro, aviso, información).
• Aplicar regras a entornos ou grupos de entornos específicos (só para entornos xestionados ).

Configuración no centro de administración

Para configurar regras de análise estática:

1. Vaia ao Power Platform centro de administración.
2. Seleccione Xestionar>entornos para continuar.
3. Seleccione Editar entornos xestionados.
4. Na sección Aplicación do verificador de solucións , configure as regras que se deben excluír para o ambiente seleccionado.

Nota

• Se o ambiente forma parte dun grupo de ambientes cunha configuración definida, a configuración das regras herdarase e non se poderá editar individualmente. Obtén máis información sobre o verificador de solucións en Verificador de solucións e Aplicación do verificador de solucións en entornos xestionados.
• Power Platform Os administradores deben asignar o seguinte privilexio a calquera rol que requira acceso á funcionalidade: prvReadmsdyn_analysisoverride (o nome descriptivo é "Subscrición de análise (lectura)").

Executar unha análise estática no portal

Para activar manualmente a análise estática:

1. Vaia á páxina Solucións no Power Automate portal.

2. Abre o menú contextual (⋯) xunto a unha solución.

3. Pasa o cursor por riba do Comprobador de solucións.

4. Seleccione unha das seguintes opcións:

   • Executar: Inicia a análise estática.
   • Ver resultados: Abre o informe de análise máis recente.
   • Descargar resultados: Exporta o informe para a súa revisión sen conexión.

Nota

A análise estática execútase para todos os fluxos de escritorio incluídos nunha solución. Identifica que fluxo de escritorio desencadea unha infracción de regras específica comprobando a columna Nome do obxecto nos resultados. Esta columna mostra o nome do fluxo de escritorio correspondente.

Análise estática no deseñador

A análise estática execútase automaticamente, inspeccionando continuamente o código sen necesidade de intervención manual. Ao engadir, eliminar ou modificar accións no fluxo, esta funcionalidade actívase para avaliar os cambios e actualizar a análise. Este proceso fai que o desenvolvemento sexa fluido e eficiente. No lado dereito do deseñador, verás un botón dedicado ao Verificador de fluxo. O número do botón mostra o total de infraccións no fluxo do escritorio. Seleccione o botón para abrir o panel Comprobador de fluxo e ver información detallada sobre as regras específicas que se violan.

Cada análise xera unha puntuación porcentual que mostra a proporción de regras seguidas con éxito. Unha puntuación máis alta significa menos infraccións e mellor calidade do código.

Esta puntuación recalcúlase cada vez que se realiza un cambio no fluxo, o que proporciona retroalimentación inmediata e promove boas prácticas de desenvolvemento.

Se se infrinxen as regras, o informe de análise estática mostra un resumo claro. Enumera os nomes das regras e o número de accións ou variables do fluxo que violan cada regra. Ao seleccionar unha regra, a acción correspondente realzase e ofrécese unha explicación detallada do erro. Para as infraccións relacionadas con variables, o sistema navega ata o panel de variables, o que facilita as correccións. O panel Verificador de fluxos inclúe funcionalidade de busca e permite filtrar por subfluxo, para que poidas atopar rapidamente problemas específicos.

Cada infracción mostra unha tesela con detalles, incluíndo a natureza do erro, as correccións recomendadas e unha ligazón á documentación. Usa o control deslizante da cabeceira da regra para navegar entre as ocorrencias da mesma infracción. Esta guía axuda aos desenvolvedores a abordar os problemas de forma rápida e eficaz. As infraccións de erro do verificador de fluxo mostran un indicador en liña e unha xanela emerxente con máis detalles. Os avisos tamén aparecen en liña no espazo de traballo do deseñador, como os erros. O deseñador mostra estados de diagnóstico como avisos e erros nas lapelas de subfluxo e inclúe un botón que permite ir ao compoñente que require atención.

Lenda

1. Incorreccións da infracción específica da norma
2. Navegar ata a acción que infrinxe a regra
3. Ligazón a documentación

Regras de análise estática

As regras de análise estática son directrices predefinidas que axudan a garantir que os fluxos sexan seguros, mantébeis e teñan un bo rendemento. Cada regra céntrase en aspectos específicos do deseño do fluxo, como a seguridade, o rendemento e a mantenibilidade, e proporciona comentarios prácticos para mellorar a calidade do fluxo. A continuación móstrase unha lista das regras, as súas descricións e as correccións suxeridas.

Protección pouco segura dos contrasinais

• Gravidade Aviso
• Tipo Seguridade
• Detalles do erro Os contrasinais xestiónanse de forma insegura no fluxo.
• Descrición: Esta regra comproba se os contrasinais se xestionan de forma insegura nun fluxo de escritorio para garantir que non se expoñan nin se xestionen incorrectamente durante a execución.
• Solución suxerida: Asegúrate de que todas as entradas relacionadas co contrasinal se xestionen correctamente usando as funcións de contrasinal de Power Automate para escritorio. Usa a "Entrada de texto cifrada directa" para obter a máxima seguridade mediante o cifrado baseado na máquina. Para os fluxos empregados en diferentes máquinas, escolla "Entrada de contrasinal como variable" e marque a variable correspondente como sensible para mellorar a seguranza. Ademais, emprega funcións seguras de xestión de credenciais como a acción "Obter credencial", que se integra coas credenciais. CyberArk

Recorrencia entre dous subfluxos

• Gravidade: Aviso
• Tipo: Deseño
• Detalles do erro: Detectáronse chamadas recursivas entre subfluxos, o que pode causar un bucle infinito.
• Descrición: Esta regra comproba se hai chamadas recursivas entre dous ou máis subfluxos, garantindo que o fluxo non entre nun bucle infinito.
• Corrección suxerida: Eliminar calquera chamada recursiva entre os subfluxos.

Lonxitude variable superada

• Gravidade: Aviso
• Tipo: Mantenibilidade
• Detalles do erro: O nome da variable supera o límite de 40 caracteres.
• Descrición: Esta regra verifica se o nome de cada variable definida no fluxo supera un número especificado de caracteres. O límite predeterminado é de 40 caracteres.
• Solución suxerida: Renomee as variables que superen o límite de caracteres especificado para garantir que os seus nomes teñan menos de 40 caracteres.

Valores predefinidos das variables de entrada

• Gravidade: Aviso
• Tipo: Mantenibilidade
• Detalles do erro: As variables de entrada/saída non usan valores predeterminados.
• Descrición: Esta regra verifica se as variables de entrada/saída usan valores predeterminados, garantindo que estean configuradas correctamente para o fluxo.
• Corrección suxerida: Asignar valores predeterminados a todas as variables de entrada e saída do fluxo.

Limiar do número de variables de entrada e saída

• Gravidade: Aviso
• Tipo: Mantenibilidade
• Detalles do erro: O total de variables de entrada/saída supera o límite de 25 variables.
• Descrición: Esta regra verifica se o número total de variables de entrada/saída no fluxo supera un limiar especificado. O límite é de 25 variables.
• Solución suxerida: Asegúrate de que o número de variables de entrada e saída no fluxo non exceda de 25.

Acción de erro de bloque baleiro

• Gravidade predeterminada: Aviso
• Tipo: Deseño
• Detalles do erro: A acción "Erro ao bloquear" está baleira e non xestiona erros.
• Descrición: Esta regra comproba se as accións de "Erro ao bloquear" no teu fluxo están configuradas correctamente para xestionar os erros, garantindo que os erros se produzan e se xestionen segundo o esperado.
• Corrección suxerida: Para xestionar posibles erros, configure as accións Ao bloquear erros no fluxo.

Cláusulas if aniñadas

• Gravidade: Aviso
• Tipo: Mantenibilidade
• Detalles do erro: As cláusulas If aniñadas superan os cinco niveis.
• Descrición: Esta regra comproba se hai instrucións if aniñadas con máis de cinco niveis, garantindo que o fluxo siga sendo manexable e lexible.
• Corrección suxerida: Refactorizar o fluxo para reducir as instrucións if aniñadas a un máximo de cinco niveis.

Incompleto se

• Gravidade: Aviso
• Tipo: Deseño
• Detalles do erro: Detectouse unha acción incompleta Se, carece de contido ou só contén accións na rama Else.
• Descrición: Esta regra detecta accións If que carecen de contido ou que só conteñen accións na rama Else, garantindo que as instrucións condicionais se implementen de forma eficaz.
• Corrección suxerida: Percorre o fluxo e revisa cada condición "Se" para asegurarte de que inclúe accións significativas nas ramas "Se", "Se non, se" e "Se non".

Bucle infinito

• Gravidade: Aviso
• Tipo: Deseño
• Detalles do erro: Detectouse un bucle infinito no fluxo, o que pode provocar que se execute indefinidamente.
• Descrición: Esta regra comproba se hai bucles infinitos no fluxo, o que axuda a identificar e evitar escenarios nos que o fluxo poida executarse indefinidamente.
• Solución suxerida: Asegúrate de que cada bucle teña unha condición de terminación claramente definida e alcanzable. A condición pode basearse nun contador, nun valor específico ou na finalización dunha tarefa. Engade comprobacións ou condicións a proba de fallos para romper o bucle se se executa máis tempo do esperado. Por exemplo, define un número máximo de iteracións ou inclúe un tempo de espera.

Uso indebido das accións de espera

• Gravidade: Aviso
• Tipo: Rendemento
• Detalles do erro: Detectouse un mal uso das accións de espera, con máis de 10 accións de espera que causan posibles atascos.
• Descrición: Esta regra comproba se o fluxo contén un número excesivo de accións de espera (máis de 10) para axudar a identificar e minimizar os posibles obstáculos causados por atrasos prolongados.
• Corrección suxerida: Revisar o fluxo para identificar todas as accións de espera e comprobar se son esenciais para a lóxica do fluxo. Elimina as esperas innecesarias ou combínaas sempre que sexa posible.

Tempo de espera inmenso

• Gravidade: Aviso
• Tipo: Rendemento
• Detalles do erro: Detectouse un tempo de espera inmenso, que supera o límite de 600 segundos para as accións de espera codificadas.
• Descrición: Esta regra comproba se as accións de espera codificadas no fluxo superan unha cantidade de tempo especificada, co límite establecido en 600 segundos.
• Solución suxerida: Revisa o fluxo para atopar accións de espera que superen o límite de 600 segundos. Comprobe se estes longos tempos de espera son necesarios e axuste a súa duración ao tempo máis curto necesario para que o fluxo funcione correctamente. Se require unha espera longa, divídea en intervalos máis curtos e engada comprobacións ou condicións entre eles. Sempre que sexa posible, substitúe as accións de espera longa por activadores baseados en eventos.

Accións sen alcanzar

• Gravidade: Aviso
• Tipo: Mantenibilidade
• Detalles do erro: Unha ou máis accións no fluxo son inalcanzables e non se executarán baixo ningunha circunstancia.
• Descrición: Esta regra comproba as accións no fluxo que son loxicamente inalcanzables. As accións inalcanzables poden ser o resultado de ramificacións incorrectas, condicións mal colocadas ou segmentos desconectados, e poderían indicar fallos na lóxica ou estrutura do fluxo.
• Corrección suxerida: Revisa o fluxo para atopar accións que non estean conectadas a unha ruta de execución. Asegúrate de que cada acción sexa accesible a través dunha rama ou bucle lóxico válido. Elimina ou move accións inalcanzables para manter o fluxo limpo e eficiente.

Limitacións coñecidas

• Dispoñible só en entornos xestionados.
• A personalización das regras limítase á activación ou desactivación das regras e á configuración da gravidade.

Problemas coñecidos

• Eliminar accións copiadas despois de ver os detalles dunha infracción de regras pode provocar erros non xestionados.
• O uso dunha variable de contrasinal non confidencial nas seguintes accións provoca un fallo na análise estática durante a avaliación da regra.
  • Mostrar diálogo de entrada
  • Mostrar diálogo de selección de cartafol
  • Mostrar formulario personalizado