Acerca del analizador de flujo de trabajo

El Analizador de flujo de trabajo es un analizador de códigos estático que garantiza que tu proyecto cumple estrictas normas de calidad y fiabilidad. Un analizador de códigos estático comprueba las incoherencias sin ejecutar el proyecto, a diferencia de los analizadores dinámicos, que intervienen durante la ejecución.

Workflow Analyzer uses a set of rules to check for various inconsistencies unrelated to project execution. The rules are based on Automation Best Practices and take into consideration variable and argument naming, empty sequences or workflows, package restrictions, and so on. The analyzer does not identify errors in execution or compilation.

Está disponible en la pestaña de cinta Diseño, en los botones Analizar archivo y Analizar proyecto. El primero realiza un análisis del archivo centrado en el panel Diseñador, mientras que el segundo analiza todos los archivos del proyecto de automatización.

Studio comes with a set of built-in rules, identifiable by the ST- prefix. The UIAutomation.Activities, Excel.Activities, and Mail.Activities also have their own rules, identifiable by the prefix.

También puedes crear reglas personalizadas. Para obtener más información, consulta Construir reglas para el Analizador de flujo de trabajo en la Guía del desarrollador.

Nota:

Las reglas integradas de Studio no pueden portarse a versiones de Studio más antiguas. Sin embargo, las reglas de paquetes de actividades compatibles se pueden usar en versiones de Studio más antiguas que incorporan el Analizador de flujo de trabajo.

Convención de denominación de reglas

Each rule has an ID, name, description, and recommendation. The ID contains the origin, category, and number. For example, Variables Naming Convention has the ST-NMG-001 ID:

• ST: revela que la regla está integrada en Studio.

• NMG - shows that the rule is part of the Naming Rules category. Rules part of Project Anatomy Rules category have the ANA abbreviation, those part of Design Best Practices the DBP, and so on.

• 001: es el número de la regla.

  

Ámbito

Cada regla tiene un ámbito de aplicación:

• Activity: The rules are enforced at activity level, checking variables, arguments, properties. Variables Naming Convention is one such rule.
• Workflow: Rules perform checks in a single project file, for example Unused Variables.
• Proyecto: se realizan comprobaciones a escala de proyecto.

Acción

Las reglas tienen una serie de acciones que se pueden establecer:

• Error: genera un error en el panel Lista de errores.
• Advertencia: genera una advertencia en el panel Lista de errores.
• Información: genera un mensaje en el panel Lista de errores.
• Detallado: crea archivos de registro grandes.

Check the Logging Levels page to learn more about logging with Studio.

Administrar reglas

El proyecto o el archivo se analizan sobre la base de un conjunto de reglas disponibles en la ventana Configuración del proyecto:

• En el panel Proyecto, haz clic en el icono y, a continuación, selecciona Analizador de flujo de trabajo.
• En la cinta, haz clic en el botón Analizar archivo, a continuación, selecciona Configuración del Analizador de flujo de trabajo del menú desplegable.

Las reglas se pueden filtrar por ámbito y acción. Desmarca la casilla situada junto a cada regla para definir una configuración específica para tu proyecto. De forma predeterminada, las reglas están ordenadas por código en la ventana, y las reglas habilitadas se muestran primero.

Restablecer al valor predeterminado

Después de realizar los cambios en los valores predeterminados de las reglas, ya sean valores Regex o de umbrales, los valores pueden volver al estado predeterminado haciendo clic derecho en la regla y seleccionando Restablecer valores predeterminados.

Validación

La validación del archivo o proyecto se realiza cada vez que se lanza el Analizador de flujo de trabajo. Las opciones de validación están disponibles en el botón de cinta Analizar archivo, Validar archivo y Validar proyecto.

Esta acción comprueba si las variables, los argumentos, las expresiones y las importaciones están bien configurados. La acción Validar archivo se puede lanzar utilizando el atajo F8, mientras que para la acción Validar proyecto se utiliza el atajo Mayús + F8. La validación se puede cancelar en cualquier momento.

Los archivos que contienen errores se marcan en el panel Proyecto con un punto rojo, y los errores se muestran en los paneles Lista de errores y Salida.

Al hacer doble clic en un elemento del panel Lista de errores, se abre el .xaml y se destacan los elementos que lanzaron el error, ya sea una actividad, un argumento o una variable.

El proyecto solo se podrá depurar, ejecutar o publicar si todos los archivos .xaml están validados. No se evalúan las condiciones de punto de interrupción.

Administrar errores

Al lanzarlo, el Analizador de flujo de trabajo utiliza el conjunto de reglas configurado para comprobar el proyecto o el archivo, y registra los errores hallados en el panel Lista de errores, de acuerdo con la acción de la regla.

El panel Lista de errores filtra elementos por Errores, Advertencias y Mensajes. El menú desplegable del ámbito resulta útil para filtrar errores por proyecto, archivo actual o un archivo específico en la automatización. Además, los elementos se pueden filtrar por identificador de la regla.

Haz clic en una advertencia o error hallado para mostrar la recomendación de las reglas y un enlace a la página de documentación para cada regla.

Además de las violaciones de las reglas, en el panel Lista de errores se muestran también los errores que se pueden producir en la ejecución del análisis del flujo de trabajo. Cuando el Analizador de flujo de trabajo o una de las reglas configuradas no se ejecuta, se registra un error con detalles sobre la causa del mismo en la descripción.

Soporte en línea de comandos

La interfaz de usuario de línea de comandos UiPath.Studio.CommandLine.exe contiene un conjunto de parámetros para comprobar los archivos o proyectos en función de determinadas reglas, incluso en configuraciones de procesos CI/CD.

UiPath.Studio.CommandLine.exe está disponible en la carpeta de instalación:

• Para la versión de Windows Installer (.msi) de Studio, la ruta predeterminada es C:\Program Files (x86)\UiPath\Studio\
• Para Studio instalado utilizando el instalador de la Community Edition (.exe), la ruta predeterminada es %LocalAppData%\UiPath\[Studio_version]\.

Configurar reglas

De forma predeterminada, todas las reglas del Analizador del flujo de trabajo están habilitadas al instalar Studio, a excepción de las siguientes:

• Valores predeterminados del argumento
• Propiedades de salida no definidas

Puedes configurar las reglas:

• En la ventana Configuración del analizador de flujo de trabajo, habilita o deshabilita reglas haciendo clic en la casilla de verificación situada junto a cada una de ellas.
• Desde el archivo RuleConfig.json, ruta %LocalAppData%\UiPath\Rules. Busca una regla específica, modifica sus parámetros, cambia el parámetro IsEnabled a false para deshabilitar la regla.

Las reglas se organizan de acuerdo a su identificador único, visible también en la ventana Configuración del Analizador de flujo de trabajo.

For example, in the image below only the Variables Naming Convention rule was enabled and received the ([A-Z]) Regex expression. This means that variable names must be uppercase. All the other rules were disabled in this example.

Analizar archivos y proyectos

Después de configurar las reglas, accede a la interfaz de usuario de línea de comandos UiPath.Studio.CommandLine.exe.

Están disponibles los siguientes comandos del Analizador de flujo de trabajo:

• analyze: analiza todo el proyecto. Requiere la ruta al archivo project.json.
• analyze-file: analiza un único archivo. Requiere la ruta al archivo .xaml.

Están disponibles los siguientes argumentos para los comandos del Analizador de flujo de trabajo:

Argumento	Descripción
-p, --project-path	Para analizar un archivo, proporciona la ruta al archivo .xaml. Para analizar el proyecto completo, especifica la ruta al archivo project.json.
--help	Ver los argumentos disponibles para cada comando.
--version	Comprobar la versión de UiPath.Studio.CommandLine.exe.

Por ejemplo, el comando UiPath.Studio.CommandLine.exe analyze-file -p "C:\BlankProcess\Main.xaml" solo analiza un archivo de un proyecto, Main.xaml. La salida del comando devuelve un diccionario codificado en JSON con la siguiente información para cada violación de una regla:

• FilePath: la ruta al archivo analizado.

• ErrorCode: el identificador de la regla.

• ActivityDisplayName: el nombre para mostrar de la actividad (null si no se aplica).

• Item: el nombre y el tipo del elemento (por ejemplo, actividad o variable) en el que se generó el mensaje de error.

• ErrorSeverity: el valor del parámetro DefaultAction, que es el mensaje de registro configurado para cada regla, ya sea Advertencia, Error, Información o Detallado.

• Description: la descripción de la regla.

• Recommendation y URL: los cambios recomendados para resolver el problema, junto con el enlace a la documentación en la que se recoge más información.

  

Para devolver al código de salida del comando, ejecuta echo %errorlevel% después de ejecutarlo. Si no hay mensajes con el error ErrorSeverity, se devuelve el código 0. De lo contrario, se devuelve 1.

Ten en cuenta que algunas de las entradas pueden no estar asociadas con una regla, sino que pueden ser errores generados por el Analizador de flujo de trabajo. Por ejemplo, si se detecta un archivo .xaml vacío, se muestra un error.

Los identificadores únicos globales (GUID) utilizados como prefijos para una entrada se generan en cada ejecución y se aplican solamente al resultado actual.

Aplicar el Analizador de flujo de trabajo antes de ejecutar o publicar

You can prevent the execution and/or publishing of projects that contain Workflow Analyzer errors by enabling the following options from Studio Backstage View > Settings > Design:

• Aplicar Analizador antes de ejecutar: cada vez que se inicia la ejecución/depuración de un archivo o proyecto, el Analizador de flujo de trabajo comprueba todas las reglas con la acción Error y la ejecución solo se permite si no se detecta ningún error.
• Aplicar Analizador antes de publicar: cada vez que se inicia el proceso de publicación, el Analizador comprueba todas las reglas habilitadas, con independencia de su acción, y la publicación solo se permite si no se viola ninguna regla con la acción Error.

Cuando se habilita la opción Aplicar Analizador antes de publicar, si se realiza la publicación (no se viola ninguna regla con la acción Error), los resultados del análisis del flujo de trabajo se incluyen en el paquete .nupkg publicado en el archivo project_analysis_results.json ubicado en \lib\net45\.analysis\. El archivo contiene la siguiente información sobre cada regla habilitada:

• RuleId: el identificador de la regla.
• RuleName: el nombre de la regla.
• Parameters: los parámetros personalizables de la regla, en su caso.
• ErrorsDescription: una lista de mensajes de error generada por la regla, en su caso.