9.项目健康检查
规则工程由规则、决策表、决策树、评分卡、规则流与规则包组成,文件之间通过 UUID 绑定、规则包名、子流程调用、覆盖规则等方式互相引用。一旦引用关系变复杂,容易出现「循环依赖」「引用了不存在的文件」「业务对象继承成环」等问题,表现为规则无法编译、部署后执行异常,或改动一处牵连多处。
项目健康检查(命令名称:分析项目依赖与循环引用)对当前工程做一次静态分析:把规则文件与目录构建成依赖图,检测循环依赖、悬空引用与循环继承,并把结果同时输出到报告面板、Problems 面板,必要时在部署前拦截。
1.主要能力:
| 能力 | 说明 |
|---|---|
| 依赖建图 | 解析规则流绑定、规则包包含、子流程调用、覆盖规则等引用,形成文件级依赖图 |
| 循环依赖检测 | 在依赖图中查找环,按环节数从少到多排列,便于优先处理直接互相调用的文件 |
| 悬空引用检测 | 检查引用目标是否存在;规则包引用还会提示目录是否缺少 .rulepackage |
| 业务对象继承检查 | 基于 BOM 构建类继承图,检测循环继承;未在 BOM 中声明的父类仅作信息展示 |
| 问题定位 | 结果写入 Problems 面板(来源为「依赖分析」),悬空引用精确到行列,依赖链可跨文件跳转 |
| 报告面板 | 右侧面板汇总统计、循环、依赖树、悬空引用、继承与规则应用,可点击打开文件 |
| 报告导出 | 支持导出依赖分析报告与项目 Problems 为 Excel,便于评审与归档 |
| 部署前校验 | 部署或编译打包前校验目标文件的相关依赖,发现问题时弹窗确认 |
2.与其他质量手段的分工:
- 语法与语义诊断:由编译器在保存、BOM 加载后逐文件执行,关注单个文件是否可编译;
- 项目健康检查:关注文件之间的引用关系是否正确、是否成环,不做语法判断;引用解析失败时会跳过,由语法诊断负责报错,避免重复提示;
- 批量测试:关注规则执行结果是否符合预期,见 8.批量测试。
3.使用前提:
- 需要在 VSCode 中打开 UDM 规则工程(存在项目根目录与项目属性文件),且文件清单已完成扫描;
- 业务对象继承检查依赖 BOM 解析结果,BOM 尚未加载完成时该项为空,BOM 加载完成后会自动重新分析。
4.更多功能用法请查阅以下章节:
- 9.1 检查内容与问题类型
- 9.2 执行分析
- 9.3 报告面板
- 9.4 问题定位与导出
- 9.5 部署与编译前校验
- 9.6 配置项与限制