Comprobador de flujo

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

Defina y administre reglas mediante el comprobador de soluciones en el Centro de administración de Power Platform y la configuración del comprobador de flujo en el portal de Power Automate.

Los administradores y los usuarios con los permisos adecuados pueden:

• Habilitar o deshabilitar reglas.
• Configure los niveles de gravedad (error, advertencia, información).
• Configure valores personalizados para reglas que admitan parámetros, como umbrales y límites (solo Power Automate portal).
• Aplique reglas a entornos o grupos de entornos específicos (solo entornos administrados, centro de administración de Power Platform).

La configuración del comprobador de flujo se aplica en el nivel de entorno y afecta a todos los flujos de escritorio dentro del entorno seleccionado.

Las opciones de cumplimiento del comprobador de soluciones que configure en el Centro de administración de Power Platform tienen prioridad sobre las opciones de configuración del comprobador de flujo en el portal de Power Automate. No se pueden modificar las reglas que están limitadas por la aplicación obligatoria del comprobador de soluciones en el portal de Power Automate.

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.

Configuración en el portal de Power Automate

Para configurar reglas de comprobador de flujo para un entorno:

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

2. Seleccione Comprobador de flujo.

3. En el panel configuración del comprobador de flujo , configure las reglas deseadas. Para cada regla, puede hacer lo siguiente:

   • Habilite o deshabilite la regla.
   • Seleccione un nivel de gravedad.
   • Especifique un valor personalizado para las reglas que admiten parámetros.

4. Haga clic en Guardar.

Los cambios de configuración se aplican en el nivel de entorno y afectan a todos los flujos de escritorio del entorno seleccionado. En el caso de los flujos de escritorio que ya están abiertos en el diseñador, vuelva a abrir el flujo para que los cambios de configuración surtan efecto.

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. A la derecha del diseñador, verá un botón específico del Comprobador de flujo. 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 en el 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. Los errores del verificador de flujo muestran un indicador integrado y una ventana emergente con más detalles. Las advertencias también aparecen en línea en el espacio de trabajo del diseñador, al igual que 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.

Recursión 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.

Se ha superado la longitud de la variable

• 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: Las cláusulas If anidadas superan los cinco niveles.
• Descripción: Esta regla comprueba si hay sentencias «if» anidadas con más de cinco niveles, para garantizar 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.

Incompleta si

• 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 detecta acciones If que carecen de contenido o que solo contienen acciones en la rama Else, para garantizar que las instrucciones condicionales se implementen correctamente.
• 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 excesivo, que supera el límite de 600 segundos para las acciones de espera codificadas de forma fija.
• Descripción: Esta regla comprueba si las acciones de espera codificadas de forma rígida en el flujo superan un tiempo especificado, con el límite 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.

No es necesario subflujo

• Gravedad: advertencia
• Tipo: Mantenimiento
• Detalles del error: la regla detectó un subflujo que no contiene acciones, solo acciones deshabilitadas o que incluye demasiadas acciones para justificar su separación. Estos subflujos podrían no contribuir significativamente a la ejecución del flujo y pueden reducir la claridad.
• Descripción: esta regla comprueba si hay subflujos vacíos o demasiado mínimos, normalmente que contienen menos de 5 acciones. Aunque los subflujos son útiles para la modularidad y reutilización, aquellos que carecen de contenido o abstracción significativos pueden indicar un desarrollo incompleto, una fragmentación innecesaria o una configuración incorrecta. Estos patrones pueden provocar confusión y dificultar el mantenimiento.
• Corrección sugerida: revise el subflujo identificado para determinar si sirve para un propósito claro y valioso. Si no es así, considere la posibilidad de quitarla o combinarla en un bloque lógico relacionado. Si el subflujo está pensado para usarse en el futuro, añada una acción provisional para aclarar su función y evitar interpretaciones erróneas.

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