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 依赖),修正后可重试。