9.4 问题定位与导出

9.4.1 Problems 面板

分析结果会同步写入 Problems 面板,与语法诊断并列显示:

属性 取值
来源 udmp.dependency(导出时显示为「依赖分析」;语法诊断显示为「语法与语义」)
代码 dependency-cycle / dependency-dangling / bom-cycle
级别 错误
消息 【循环依赖】检测到循环依赖:A → B → A、【悬空引用】引用的规则包【x】不存在…、【循环继承】检测到循环继承:…

定位方式:

  • 问题挂在引用所在的文件上;悬空引用会定位到具体行列(按引用文本在文件中的位置),双击即可跳转;
  • 循环依赖与循环继承附带「依赖链」关联位置,可在问题详情中跳转到链上的其它文件;
  • 问题随自动分析实时刷新;修复后保存文件即可看到对应问题消失。

提示:只有能定位到具体文件的循环继承才会进入 Problems 与问题清单;无法定位的继承链仍会在报告面板的「业务对象继承」区块中展示。

9.4.2 导出项目 Problems

入口:

  • 报告面板右上角【导出 Problems】;
  • 命令 udmp.exportProblems(未注册到命令面板,供面板按钮或脚本调用)。

导出内容:

  • 默认文件名 项目问题清单_yyyyMMdd_HHmmss.xlsx,默认保存到工程根目录,可另存到其他位置;
  • 收集当前工作区 Problems 面板中的全部问题,包括语法诊断与依赖诊断,按文件、行、列排序;
  • 工作表「问题清单」:序号、级别、来源、代码、文件、行、列、问题描述、关联位置(关联位置会把依赖链拼成「说明(文件:行)」);
  • 工作表「统计」:问题总数与项目根目录、按级别统计、按来源统计、问题最多的文件(前 20);
  • 级别列按错误 / 警告 / 信息 / 提示着色,表头冻结并带筛选;
  • 当前工程没有任何问题时提示「当前项目没有 Problems,无需导出」;
  • 导出成功后提示问题条数与错误 / 警告数量,可直接点击【打开文件】查看。

9.4.3 导出依赖分析报告

入口:

  • 报告面板右上角【导出报告】;
  • 命令 udmp.exportAnalysisReport(未注册到命令面板,供面板按钮或脚本调用)。

导出内容:

  • 默认文件名 依赖分析报告_yyyyMMdd_HHmmss.xlsx,默认保存到工程根目录;
  • 工作表「概览」:生成时间、项目根目录、分析文件数、依赖关系数、循环依赖数、问题总数、错误数、警告数、决策流规则应用数、业务对象类数;降级时附降级提示;并说明本报告不含依赖树明细;
  • 工作表「问题清单」:序号、级别、类型、问题描述、来源文件、目标文件、行、列、依赖链;
  • 工作表「循环依赖」:序号、环节数、包含规则包、环链;
  • 工作表「悬空引用」:来源文件、缺失目标、引用类型;
  • 工作表「业务对象继承」:循环继承、外部父类(业务对象、父类、所在文件)两段;
  • 工作表「规则应用」:规则流文件、节点、应用编码、版本、行;
  • 导出成功后提示文件数、问题数、循环数,可直接点击【打开文件】查看。

说明:报告不导出依赖树(文件节点与依赖边)明细,需要逐文件查看引用关系时请在报告面板中使用「依赖树」区块。

9.4.4 命令一览

命令 名称 是否在命令面板
udmp.analyzeDependencies 分析项目依赖与循环引用 是
udmp.analyzeDependenciesJson 分析项目依赖与循环引用(JSON) 是
udmp.exportProblems 导出项目 Problems 否(面板按钮 / 脚本调用)
udmp.exportAnalysisReport 导出依赖分析报告 否(面板按钮 / 脚本调用)

导出与分析结果同时写入输出面板的「操作」通道,导出失败时会给出错误提示(例如目标文件被占用、未安装 exceljs 依赖),修正后可重试。

results matching ""

    No results matching ""