Comprobador de flujo (versión preliminar)

[Este artículo es documentación preliminar y está sujeto a modificaciones].

Mejore su flujo de trabajo de desarrollo con la característica de análisis estático en Comprobador de soluciones. Esta herramienta es compatible con las prácticas recomendadas en automatización robótica de procesos (RPA) y cumple con los requisitos de flujo críticos mediante la evaluación automática de sus flujos para garantizar un rendimiento óptimo. El análisis estático está disponible en la sección Comprobador de flujo del diseñador. Hace cumplir las directrices clave y proporciona comentarios en tiempo real y una inspección temprana del código. Se integra directamente en su flujo de trabajo, mejora la calidad del código y sienta las bases para una experiencia de desarrollo más eficiente y productiva.

Administración de reglas

Las reglas se definen y administran a través del Comprobador de soluciones en el centro de administración de Power Platform. Los administradores pueden:

• Habilitar o deshabilitar reglas.
• Configure los niveles de gravedad (error, advertencia, información).
• Aplique reglas a entornos o grupos de entornos específicos (solo Entornos administrados).

Configuración en el centro de administración

Para configurar reglas de análisis estático:

1. Vaya al centro de administración de Power Platform.
2. Seleccione Administrar>Entornos para continuar.
3. Seleccione Editar entornos gestionados.
4. En la sección Cumplimiento del comprobador de soluciones, configure qué reglas deben excluirse para el entorno seleccionado.

Ejecutar análisis estático en el portal

Para desencadenar manualmente el análisis estático:

1. Vaya a la página Soluciones en el portal de Power Automate.

2. Abra el menú contextual (⋯) junto a una solución.

3. Pasa el ratón por encima de Comprobador de soluciones.

4. Elija una de las siguientes opciones:

   • Ejecutar: inicia el análisis estático.
   • Ver resultados: abre el último informe de análisis.
   • Descargar resultados: exporta el informe para revisarlo sin conexión.

Análisis estático en el diseñador

El análisis estático se ejecuta automáticamente, inspeccionando continuamente su código sin necesidad de intervención manual. Al agregar, eliminar o modificar acciones en el flujo, esta característica se activa para evaluar los cambios y actualizar el análisis. Este proceso hace que el desarrollo sea fluido y eficiente. En el lado derecho del diseñador, verá un botón Comprobador de flujo dedicado. El número del botón muestra el total de infracciones en el flujo de escritorio. Seleccione el botón para abrir el panel Comprobador de flujo y ver información detallada sobre las reglas específicas que se infringen.

Cada análisis genera una puntuación porcentual que muestra la proporción de reglas seguidas correctamente. Una puntuación más alta significa menos infracciones y una mejor calidad del código.

Esta puntuación se recalcula cada vez que se realiza un cambio en el flujo, lo que proporciona comentarios inmediatos y promueve buenas prácticas de desarrollo.

Si se infringen las reglas, el informe de análisis estático muestra un resumen claro. Enumera los nombres de las reglas y el número de acciones o variables del flujo que infringen cada regla. Al seleccionar una regla, se resalta la acción correspondiente y se proporciona una explicación detallada del error. En el caso de las infracciones relacionadas con variables, el sistema se desplaza al panel de variables, lo que facilita las correcciones. El panel del comprobador de flujo incluye funciones de búsqueda y le permite filtrar por subflujo, para que pueda encontrar rápidamente problemas específicos.

Cada infracción muestra un cuadro con detalles, como la naturaleza del error, las correcciones recomendadas y un vínculo a la documentación. Use el control deslizante del encabezado de la regla para navegar entre las repeticiones de la misma infracción. Estas instrucciones ayudan a los desarrolladores a abordar los problemas de forma rápida y eficaz. Las infracciones de error del comprobador de flujo muestran un indicador insertado y una ventana emergente con más detalles. Las advertencias también aparecen insertadas en el espacio de trabajo del diseñador, como los errores. El diseñador muestra los estados de diagnóstico, como advertencias y errores, en las pestañas de subflujo, e incluye un botón que le permite ir al componente que necesita atención.

Leyenda

1. Ocurrencias de la infracción de la regla específica
2. Navegue hasta la acción que infringe la regla
3. Vínculo a la documentación

Reglas de análisis estático

Las reglas de análisis estático son directrices predefinidas que ayudan a garantizar que los flujos sean seguros, fáciles de mantener y de alto rendimiento. Cada regla se centra en aspectos específicos del diseño del flujo, como la seguridad, el rendimiento y la facilidad de mantenimiento, y proporciona comentarios prácticos para mejorar la calidad del flujo. A continuación se muestra una lista de las reglas, sus descripciones y correcciones sugeridas.

Seguridad de contraseña no segura

• Gravedad: advertencia
• Tipo: seguridad
• Detalles del error: las contraseñas se administran de forma insegura en el flujo.
• Descripción: rsta regla comprueba si las contraseñas se manejan de forma insegura dentro de un flujo de escritorio, para garantizar que no se expongan ni se controlen incorrectamente durante la ejecución.
• Solución sugerida: Asegúrese de que todas las entradas relacionadas con la contraseña se gestionen correctamente mediante el uso de las características de contraseña de Power Automate para escritorio. Utilice la "Entrada directa de texto cifrado" para obtener la máxima seguridad a través del cifrado basado en máquinas. Para los flujos utilizados en diferentes máquinas, elija "Introducir contraseña como variable" y marque la variable correspondiente como confidencial para mejorar la seguridad. Además, use características seguras de administración de credenciales, como la acción "Obtener credencial", que se integra con las credenciales de CyberArk.

Recursividad entre dos subflujos

• Gravedad: advertencia
• Tipo: Diseño
• Detalles del error: Se detectan llamadas recursivas entre subflujos, lo que puede provocar un bucle infinito.
• Descripción: esta regla comprueba si hay llamadas recursivas entre dos o más subflujos para garantizar que el flujo no entre en un bucle infinito.
• Corrección sugerida: elimine las llamadas recursivas entre los subflujos.

Longitud de variable superada

• Gravedad: advertencia
• Tipo: Mantenimiento
• Detalles del error: el nombre de la variable supera el límite de 40 caracteres.
• Descripción: Esta regla comprueba si el nombre de cada variable definida en el flujo supera un número de caracteres especificado. El límite predeterminado es de 40 caracteres.
• Corrección sugerida: cambie el nombre de todas las variables que superen el límite de caracteres especificado para asegurarse de que sus nombres tengan menos de 40 caracteres.

Valores predeterminados de variable de entrada

• Gravedad: advertencia
• Tipo: Mantenimiento
• Detalles del error: las variables de entrada/salida no utilizan valores predeterminados.
• Descripción: esta regla comprueba si las variables de entrada/salida utilizan valores predeterminados y se asegura de que estén bien configuradas para el flujo.
• Corrección sugerida: asigne valores predeterminados a todas las variables de entrada y salida del flujo.

Umbral de número de variables de entrada y salida

• Gravedad: advertencia
• Tipo: Mantenimiento
• Detalles del error: el total de variables de entrada/salida supera el límite de 25 variables.
• Descripción: esta regla comprueba si el número total de variables de entrada/salida del flujo supera un umbral especificado. El límite de variables es 25.
• Corrección sugerida: asegúrese de que el número de variables de entrada y salida en el flujo no supere las 25.

Acción vacía en caso de error de bloque

• Gravedad predeterminada: Advertencia
• Tipo: Diseño
• Detalles del error: la acción "En caso de error de bloque" está vacía y no maneja ningún error.
• Descripción: esta regla comprueba si las acciones "En error del bloque" del flujo están configuradas correctamente para controlar los errores, asegurándose de que los errores se produzcan y gestionen según lo esperado.
• Corrección sugerida: para gestionar posibles errores, configure las acciones En error del bloque en el flujo.

Cláusulas if anidadas

• Gravedad: advertencia
• Tipo: Mantenimiento
• Detalles del error: si las cláusulas anidadas superan los cinco niveles.
• Descripción: esta regla comprueba si hay instrucciones "if" con más de cinco niveles de anidado, con el fin de que el flujo siga siendo manejable y legible.
• Corrección sugerida: refactorice el flujo para reducir el anidamiento de las instrucciones if a no más de cinco niveles.

If incompleta

• Gravedad: advertencia
• Tipo: Diseño
• Detalles del error: se ha detectado una acción If incompleta, que no tiene contenido o solo contiene acciones en la rama Else.
• Descripción: esta regla verifica el flujo para detectar acciones condicionales que carecen de contenido o que solo contienen acciones en la rama "Else", lo que garantiza que se implementen las instrucciones condicionales de forma eficiente.
• Corrección sugerida: revise flujo y compruebe cada condición "If" para asegurarse de que incluye acciones relevantes en las ramas "If", "Else if" y "Else".

Bucle infinito

• Gravedad: advertencia
• Tipo: Diseño
• Detalles del error: se ha detectado un bucle infinito en el flujo, lo que puede provocar que se ejecute indefinidamente.
• Descripción: Esta regla comprueba si hay bucles infinitos en el flujo, lo que ayuda a identificar y evitar situaciones en las que se pueda ejecutar el flujo indefinidamente.
• Correción sugerida: Asegúrese de que cada bucle tenga una condición de terminación claramente definida y alcanzable. La condición puede basarse en un contador, un valor específico o la finalización de una tarea. Agregue comprobaciones o condiciones de seguridad para interrumpir el bucle si se ejecuta más tiempo del esperado. Por ejemplo, establezca un número máximo de iteraciones o incluya un tiempo de espera.

Uso incorrecto de acciones de espera

• Gravedad: advertencia
• Tipo: rendimiento
• Detalles del error: se ha detectado un uso incorrecto de las acciones de espera, con más de 10 acciones de espera que provocan posibles cuellos de botella.
• Descripción: esta regla comprueba si el flujo contiene un número excesivo de acciones de espera (más de 10) para ayudar a identificar y minimizar los posibles cuellos de botella causados por retrasos prolongados.
• Solución sugerida: revise el flujo para identificar todas las acciones de espera y comprobar si son esenciales para la lógica del flujo. Elimine las esperas innecesarias o combínelas siempre que sea posible.

Tiempo de espera enorme

• Gravedad: advertencia
• Tipo: rendimiento
• Detalles del error: se ha detectado un tiempo de espera muy largo que supera el límite de 600 segundos para las acciones de espera incluidas en el código de forma inamovible.
• Descripción: esta regla comprueba si las acciones de espera incluidas en el flujo de forma inamovible superan un período de tiempo especificado. El límite predeterminado establecido en 600 segundos.
• Solución sugerida: Revise el flujo para encontrar acciones de espera que superen el límite de 600 segundos. Compruebe si estos largos tiempos de espera son necesarios y ajuste su duración al menor tiempo necesario para que el flujo funcione correctamente. Si se requiere una espera larga, divídala en intervalos más cortos y agregue comprobaciones o condiciones entre ellos. Siempre que sea posible, reemplace las acciones de espera prolongada por desencadenadores controlados por eventos.

Acciones no alcanzadas

• Gravedad: advertencia
• Tipo: Mantenimiento
• Detalles del error: una o varias acciones del flujo son inalcanzables y no se ejecutarán bajo ninguna circunstancia.
• Descripción: esta regla comprueba si hay acciones en el flujo a las que no se puede acceder lógicamente. Las acciones inalcanzables pueden ser el resultado de ramas incorrectas, condiciones fuera de lugar o segmentos desconectados, y pueden indicar errores en la lógica o la estructura del flujo.
• Corrección sugerida: revise el flujo para buscar acciones que no estén conectadas a una ruta de ejecución. Asegúrese de que se pueda acceder a cada acción a través de una rama o bucle lógico válido. Elimine o mueva acciones inalcanzables para mantener el flujo limpio y eficiente.

Limitaciones conocidas

• Disponible solo para Entornos administrados.
• La personalización de las reglas se limita a habilitar o deshabilitar reglas y configurar la gravedad.

Problemas conocidos

• Eliminar acciones copiadas después de ver los detalles de una infracción de regla puede desencadenar errores no controlados.
• El uso de una variable de contraseña no sensible en las siguientes acciones hace que falle el análisis estático durante la evaluación de la regla.
  • Mostrar cuadro de diálogo de entrada
  • Mostrar el cuadro de diálogo de selección de carpeta
  • Mostrar formulario personalizado