作为 Bot Creator（RPA 开发人员）或 Citizen Developer，您可以使用代码分析来检查和修复自动化文件（Task Bot 或 API Task）中的任何代码错误。 您可以基于已配置的代码分析策略和预定义规则开发自动化。

通过代码分析，您可以通过实施变量命名约定、注释覆盖和错误处理等编码最佳实践来提高自动化的可靠性。 构建符合预定义指南或规则的自动化有助于在自动化开发过程中识别可能的错误。 这将减少在实际正式环境中的自动化失败。 您可以在私有和公共工作区中运行代码分析并查看结果。

通过代码分析（可从 Bot editor 获取），您将获得下列好处：
  • 根据需要运行代码分析。
  • 获取符合规则的工具提示指导。
  • 与 Assistant 集成以进行会计和指导。

代码分析结果

要查看代码分析的结果，请转到自动化页面，并查看代码分析结果。 此列显示每个自动化文件（Task Bot 或 API Task）的代码分析结果的摘要状态。 提供以下每个状态的详细信息：
  • 不适用： 由于以下原因，您将看到不适用状态：
    • 代码分析不适用于该对象，因为该对象不是 Task Bot 或 API Task 文件。
    • 没有为 Task Bot 或 API Task 文件或文件夹分配任何策略。 当 Task Bot 或 API Task 文件或文件夹处于不适用状态时，不会显示运行代码分析选项的行级操作。 代码分析不会在状态为不适用的这些自动化上自动运行。
  • 未扫描： 尚未对 Task Bot 或 API Task 进行代码分析。
  • 严重： Task Bot 或 API Task 存在严重的违规问题。
  • 高严重性： Task Bot 或 API Task 至少发生一个高严重性违规。
  • 低严重性： Task Bot 或 API Task 至少发生一个低严重性违规，但没有高严重性违规。
  • 无违规： Task Bot 或 API Task 中没有代码分析违规。

下图显示了代码分析的示例结果：


代码分析结果列

注： 在以下场景中，代码分析结果列中的 Task Bots 或 API Tasks 状态设置为未扫描：
  • 自动化文件在私有工作区中经过编辑，但尚未保存。
  • 管理员最近启用了代码分析，或者自动化文件适用策略中的任何规则配置发生了更改，文件正在等待扫描。

正在审查 Bot editor 中的结果

当您创建一个自动化文件（Task Bot 或 API Task）或修改现有的自动化文件并将其保存在 Bot editor 中时，代码分析将在后台启动并且结果会显示在 Assistant 中。 代码分析标题显示自动化文件中的违规总数。 您可以展开代码分析选项，选择一个特定对象并查看以下属性：
  • 适用对象： 显示自动化文件、变量、操作和操作属性。
  • 规则代码： 唯一的 RULE_CODE ID。
  • 严重性： 高或低。
  • 规则文本： 描述用于指示要对代码执行的评估的性质。

下图显示了在 Assistant 中展示的代码分析示例：


Assistant 中的代码分析结果

代码分析结果按以下顺序显示：
属性 违反的规则
Bot
  • 强制性的标题注释
  • 注释覆盖率
  • 最大操作数
变量
  • 变量名称模式
  • 变量名称长度
  • 没有未使用的变量
行动
  • 没有硬编码延迟
  • 没有硬编码的文件路径
  • 没有硬编码的电子邮件地址
  • 没有空的 catch
  • 强制性捕获记录
  • 强制性捕获屏幕截图

代码分析标题显示自动化文件中具有违规错误的对象数量。 每个对象的严重程度可以是低或高。 显示违规时，先显示属性，再显示行号和严重程度。 首先显示所有高严重性错误。 导航到自动化文件中存在违规的相应行，纠正违规，并保存自动化。

必须保存自动化文件才能在 Assistant 中查看最新的代码分析结果。

Bot editor 中的代码分析违规和策略详情

专业人员和 Citizen Developers 可以在画布级别的操作中查看代码分析违规情况。 流和列表视图中提供了违规指示器，使专业人员和 Citizen Developers 能够快速查看并纠正其自动化中存在代码分析违规的任何操作。 如果开发人员能够轻松识别违规行为并在开发自动化时遵循最佳实践，代码质量会得到提升。

专业人员和 Citizen Developers 不再需要导航到策略页面来查看已应用的策略及其中包含的规则。 他们可以直接在 Bot editor 中的下拉菜单中查看当前的代码分析策略及其规则（通过 Bot editor 右上角的三个竖点访问）。 这有助于没有查看策略和管理策略权限的用户在 Bot editor 中编辑自动化时查看当前策略及其规则，而不仅仅是查看违规情况。

机器人编辑器中的代码分析策略选项

系统创建的变量

系统创建的变量，如输入或输出变量、软件包建议的变量或自动生成的变量（窗口变量），使用代码分析中的默认变量命名工单约定，或者如果代码分析规则中未定义格式，则使用 Pascal 工单。

审核日志

当通过保存自动化文件或在 Bot editor 中运行代码分析来启动代码分析时，信息将记录在审核日志中。 捕获以下详细信息：
  • Bot 名称
  • 用户信息
  • 启动代码分析的方法（保存选项或运行代码分析选项）
  • 代码分析运行所需的时间，包括代码分析过程捕获的代码行数等详细信息
  • 违规总数
  • 违规的详细信息