studio

2020.10

false

不在支持范围内

Studio 用户指南

Last updated 2023年12月20日

关于工作流分析器

工作流分析器是一种静态代码分析器，可确保您的项目符合高质量和可靠性标准。静态代码分析器可在不实际执行项目的情况下检查不一致问题，这与在执行期间介入的动态分析器不同。

工作流分析器使用一组规则检查与项目执行无关的各种不一致问题。这些规则基于自动化最佳实践，并且会考虑变量和参数命名、空序列或工作流以及包限制等。该分析器无法识别执行或编译中的错误。

其位于设计功能区选项卡中，分别是分析文件和分析项目按钮。“分析文件”会对设计器面板中设为当前焦点的文件执行分析，而“分析项目”则对自动化项目中的所有文件执行分析。

Studio 带有一组内置规则，可通过前缀 ST- 识别。UIAutomation.Activities、Excel.Activities、和 Mail.Activities 也自带通过前缀标识的规则。

您还可以创建自定义规则。有关更多信息，请参阅开发者指南中的构建工作流分析器规则。

注意：无法将 Studio 内置规则移植到较旧的 Studio 版本。但是，兼容活动包中的规则可以在工作流分析器随附的较旧 Studio 版本中使用。

规则命名惯例

每个规则都包含 ID、名称、说明和建议。 ID 包含来源、类别和编号。例如， “变量命名惯例” 的 ID 为 ST-NMG-001 ：

ST - 表明该规则是 Studio 的内置规则。
NMG - 表示该规则属于“ 命名规则” 类别的一部分。属于“ 项目剖析规则” 类别的规则包含 ANA 缩写，属于“ 设计最佳实践 ”类别的规则包含 DBP缩写，依此类推。
001 - 规则编号。

范围

每个规则都有一个适用的作用域：

活动：在活动级别强制执行规则，并检查变量、参数、属性。变量命名惯例即属于此类规则。
工作流：规则在单个项目文件中执行检查，例如未使用的变量。
项目：在项目级别执行检查。

操作

规则包含许多可设置的操作：

错误：在错误列表面板中生成错误。
警告：在错误列表面板中生成警告。
信息：在错误列表面板中生成消息。
Verbose：创建大型日志文件。

请查看日志记录级别页面，详细了解 Studio 中的日志记录。

管理规则

按照“项目设置”窗口中的一组规则分析项目或文件：

在“项目”面板中，单击图标，然后选择“工作流分析器”。
在功能区中，单击“分析文件”按钮，然后从下拉列表中选择“工作流分析器设置”。

可以按作用域和操作筛选规则。取消选中每个规则旁边的复选框，即可定义特定于项目的配置。默认情况下，规则按窗口中的代码排列，系统将会首先显示已启用的规则。

重置为默认值

对规则的默认值（正则表达式或阈值）作出任何更改后，可以通过右键单击规则，然后选择“重置为默认值”来将值恢复为默认值。

验证

每当触发工作流分析器时，系统都会对文件或项目执行验证。验证选项位于分析文件功能区按钮中，分别是“验证文件”和“验证项目”。

此操作检查是否已正确配置变量、参数、表达式和导入。可使用 F8 快捷键触发验证文件操作，使用 Shift + F8 触发验证项目操作。可随时取消验证。

系统会在项目面板中以红点标记包含错误的文件，并在错误列表和输出面板中显示错误信息。

双击“错误列表”面板中的项目将打开 .xaml 并突出显示引发错误的元素，无论是活动、参数还是变量。

除非所有 .xaml 文件都经过验证，否则无法调试、执行或发布项目。不评估断点条件。

管理错误

经触发后，工作流分析器会使用配置的规则集检查项目或文件，并根据规则操作在错误列表面板中记录发现的错误。

在“错误列表”面板中，您可以按“错误”、“警告”和“消息”筛选项目。您可以使用“作用域”下拉菜单，按项目、当前文件或自动化中的特定文件筛选错误。此外，还可按规则 ID 筛选项目。

单击发现的警告或错误，以显示规则建议和每个规则的文档页面链接。

除了违反规则外，“错误列表”面板还显示在执行工作流分析时可能发生的错误。当“工作流分析器”或已配置的规则之一无法运行时，将记录错误，并在描述中详细说明错误原因。

命令行支持

UiPath.Studio.CommandLine.exe 命令行用户界面包含一组参数，用于根据特定规则检查文件或项目，即使在 CI/CD 管道配置中也是如此。

UiPath.Studio.CommandLine.exe 位于安装文件夹中：

对于 Windows 安装程序 (.msi) 版 Studio，默认路径是 C:\Program Files (x86)\UiPath\Studio\
对于使用社区版安装程序（.exe）安装的 Studio，默认路径为 %LocalAppData%\UiPath\[Studio_version]\。

配置规则

默认情况下，安装 Studio 时会启用所有工作流分析器规则，但以下情况除外：

您可以配置规则：

在“工作流分析器设置”窗口中，通过单击每个规则旁边的复选框来启用或禁用规则。
从 RuleConfig.json 文件（路径：%LocalAppData%\UiPath\Rules）中，查找特定规则、修改其参数并将 IsEnabled 参数更改为 false，从而禁用该规则。

系统会按规则的唯一 ID 对其进行整理，并且会在“工作流分析器设置”中显示这些规则。

例如，下图仅启用变量命名惯例规则，并接收 ([A-Z]) 正则表达式。这意味着变量名称必须使用大写字母。在此示例中，禁用了所有其他规则。

分析文件和项目

配置完规则后，请访问 UiPath.Studio.CommandLine.exe 命令行用户界面。

以下工作流分析器命令可用：

analyze - 分析整个项目。必须提供 project.json 文件的路径。
analyze-file - 分析单个文件。必须提供 .xaml 文件的路径。

以下参数可用于工作流分析器命令：

参数	描述
`-p, --project-path`	分析一个文件时，应提供 `.xaml` 的路径。分析整个项目时，应指定 `project.json` 文件的路径。
`--help`	查看可用于每个命令的参数。
`--version`	查看 `UiPath.Studio.CommandLine.exe` 的版本。

例如，命令 UiPath.Studio.CommandLine.exe analyze-file -p "C:\BlankProcess\Main.xaml" 仅分析项目中的一个文件，即 Main.xaml。该命令的输出返回一个 json 编码的字典，其中包含针对每个违反规则的以下信息：

FilePath：所分析文件的路径。
ErrorCode：规则 ID。
ActivityDisplayName：活动的显示名称（如果不适用，则为 null）。
Item - 生成错误消息的项目的名称和类型（例如，活动或变量）。
ErrorSeverity：DefaultAction 参数（为每个规则配置的日志消息）的值，即 Warning、Error、Info 或 Verbose。
Description：规则的说明。
Recommendation 和 URL：为解决问题提供的更改建议，以及包含更多信息的文档链接。

若要返回命令的退出代码，请在运行后执行 echo %errorlevel%。如果没有包含 ErrorSeverity 错误的消息，则将返回 0 代码。否则，将返回 1。

请注意，有些条目可能与规则无关，而是“工作流分析器”生成的错误。例如，在 .xaml 文件为空的情况下，系统会显示错误。

用作条目前缀的全局唯一标识符 (GUID) 在每次运行时生成，并且仅应用于当前结果。

在运行或发布之前强制使用工作流分析器

通过启用“Studio 后台视图”>“设置”>“设计”中的以下选项，可以防止执行和/或发布包含工作流分析器错误的项目：

“运行前强制使用分析器” - 每当启动运行/调试文件或项目时，工作流分析器都会使用 Error 操作检查所有规则，并且只有在未发现错误的情况下才允许执行。
“在发布前强制使用分析器” - 每当发布启动时，工作流分析器都会检查所有启用的规则，无论它们采取何种操作，并且仅当操作 Error 不违反任何规则时才允许发布。

启用“发布前强制使用分析器”时，如果发布成功（Error 操作没有违反规则），工作流分析结果将包含在文件 project_analysis_results.json（位于 \lib\net45\.analysis\）中已发布的 .nupkg 包中。该文件包含有关每个已启用规则的下列信息：