report 337/337 闸一全通,总量1516/1489(98.2%)与基线持平,onEvent 380个。 eip4dev+eip4m0各更新901条sys_page_schema。30样本验证30/30通过, 3个分组报表XML→schema人工核对结论写入报告。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
9.4 KiB
F3-1 报表渲染体验验证与修缮报告
任务范围
- 修转换器 report 族查询区:业务列过滤规则 + 单测
- 重批 337 个 type200 模板入库
- 30 样本语义验证
- 3 个含分组/合计的报表 XML→schema 人工核对
- 新增 report.spec.ts(5 个代表性断言)+ 全套 e2e 终验
一、查询区修复说明(F3-1)
问题
report 族转换器 convertReport() 调用 buildSearchFilter() 时未过滤主键列,
导致 114 个 type200 报表的查询区暴露 designName="主键" 的字段(如 PM_PUB_SAFETYEDUCATION_ID、HR_WELFAREPAY_ID 等),
用户在查询区看到「主键」下拉选择器,无业务意义且影响体验。
修改
文件:platform-converter/src/main/java/com/eip4/platform/converter/TemplateToAmisConverter.java
buildSearchFilter() 新增重载,增加 skipKeyFields 参数:
boolean skipKeyFields = true → report 路径启用,crud/form 路径保持 false(不影响已有逻辑)
主键判断规则(OR 任一成立即跳过):
designName="主键"或label="主键"—— 老引擎设计器明确标注主键- 字段名以
_ID结尾且长度 ≥ 10 —— 典型 UUID 外键列(如HR_WELFAREPAY_ID), 长度门槛排除业务缩写(ORGID=5、DEPART_ID=9,均不触发)
新增跳过后行为:
- 所有字段均被过滤 →
filter=null(不渲染空查询区) - 部分字段被过滤 → 只保留业务字段
- crud/form 路径不受影响(skipKeyFields=false)
新增单测(TemplateToAmisConverterTest.java,5 个):
| 用例 | 断言 |
|---|---|
f3_1_report查询区过滤designName主键 |
designName=主键 → 跳过,台账记录 F3-1 |
f3_1_report查询区过滤长_ID结尾字段 |
GB_PROJECTINFO_ID(长16) → 跳过 |
f3_1_report查询区保留短ORGID类字段 |
ORGID(长5) → 保留 |
f3_1_report查询区全是主键时filter为null |
全主键 → filter=null |
f3_1_crud查询区不过滤主键字段 |
crud 路径主键不过滤 |
另修复既有测试 crud_selectDialog降级为select 的断言(assertEquals→startsWith,F2-9 加了查询参数后未同步)。
二、批量重批结果
总量: 1516
闸一(schema)通过: 1489 (98.2%) ← 与基线持平
onEvent 脚本钩子挂载: 380 个模板
分级: PARTIAL=1230 SUCCESS=259 FAILED=27
各根元素:
report: 337/337/100.0% ← 全部闸一通过
crud: 956/956/100.0%
form: 70/70/100.0%
group: 20/20/100.0%
tree: 106/106/100.0%
入库:eip4dev.eip3.sys_page_schema + eip4m0.public.sys_page_schema 各更新 901 条。
三、30 样本语义验证结果
全部通过(30/30)。按断言维度:
| # | 报表名称 | 状态 | 列数 | 查询字段数 | 合计列 | 备注 |
|---|---|---|---|---|---|---|
| 1 | 项目安全费用投入明细 | PASS | 6 | 6 | APPLYMONEY | issummer=true 正确转 summaryFields |
| 2 | (分)公司质量指标报表 | PASS | 48 | 0 | — | 宽报表,主键唯一查询列已被过滤 |
| 3 | 项目部质量目标报表 | PASS | 40 | 0 | — | 同上 |
| 4 | 开票申请表单(非项目-工业设备用) | PASS | 38 | 0 | — | |
| 5 | 内部奖罚打印表单 | PASS | 37 | 0 | — | |
| 6 | 项目开票申请表单 | PASS | 31 | 0 | — | |
| 7 | 工种到位情况统计表 | PASS | 29 | 2 | — | START/END 日期 |
| 8 | 物资合同评审表-明辉定制 | PASS | 28 | 0 | — | |
| 9 | 项目外经证开具申请打印表单 | PASS | 25 | 0 | — | |
| 10 | 物资采购合同报表 | PASS | 21 | 3 | — | PROJECTID/CONTRACTID/PROJECTNAME |
| 11 | 派车单 | PASS | 18 | 0 | — | |
| 12 | (设计项目)项目报销申请打印 | PASS | 18 | 0 | — | |
| 13 | 施工日志报表 | PASS | 16 | 2 | — | DIARYDATE1/DIARYDATE2 |
| 14 | 预算材料清单 | PASS | 15 | 1 | — | PROJECTID |
| 15 | 任务二维码 | PASS | 14 | 5 | — | |
| 16 | 社保明细表-五建定制 | PASS | 14 | 3 | — | PROJECTID/YEAR/MONTH |
| 17 | 项目分包信息统计表 | PASS | 14 | 3 | — | BEGINDATE/ENDDATE/REGISTER |
| 18 | 项目社保统计表-五建定制 | PASS | 14 | 3 | — | YEAR/MONTH/PROJECTID |
| 19 | 安全日志打印 | PASS | 13 | 2 | — | DIARYDATE1/DIARYDATE2 |
| 20 | 打印进项税抵扣调整 | PASS | 13 | 0 | — | |
| 21 | 收发存明细 | PASS | 13 | 7 | — | STORE_ID/GOODS_NAME/... |
| 22 | 绩效报表 | PASS | 13 | 5 | — | |
| 23 | 面试考评报表 | PASS | 13 | 2 | — | RECRUITPLAN/SEARCHEVALAVG |
| 24 | 项目劳务合同明细表 | PASS | 13 | 0 | — | |
| 25 | 企业证书复印件/电子档使用登记报表 | PASS | 10 | 4 | — | EC_NAME/USETYPE/DEPART_ID/REGISTERDATE |
| 26 | 公司危险源报表 | PASS | 10 | 1 | — | DANGERID |
| 27 | 公司污染源报表 | PASS | 10 | 1 | — | POLLUTIONID |
| 28 | 分公司在建项目收付款汇总表 | PASS | 10 | 2 | — | ORGID/USERID |
| 29 | 分公司竣工项目收付款汇总表 | PASS | 10 | 2 | — | ORGID/USERID |
| 30 | 在建项目收付款信息表 | PASS | 10 | 1 | — | PROJECTID |
排除说明:抽样均取有 selectservice 且 col_count ≥ 3 的报表,底表缺失(500 错误)的 74 个排除在外(属 #29 数据问题)。
四、3 个分组/合计报表 XML→schema 转换人工核对
核对对象选取标准
含 issummer="true"(合计行)或多列宽报表含分类汇总查询语义。
核对1:项目安全费用投入明细(3eedc061)
XML display 段关键配置:
APPLYMONEY: ismoney="true" issummer="true" → 金额合计列
APPLYDATE: (无 ismoney/issummer)
PM_SAFETYFEEAPPLY_ID: iskeycolumn="true" hidden="true"
期望 schema:
columns中 APPLYMONEY →type:number, precision:2(ismoney=true 命中)summaryFields: ["APPLYMONEY"](issummer=true 命中)PM_SAFETYFEEAPPLY_ID→toggled:false(display hidden=true 命中)
实际 schema(API 验证):
- APPLYMONEY:
type:number, precision:2✓ summaryFields: ["APPLYMONEY"]✓- PM_SAFETYFEEAPPLY_ID:
toggled:false✓ - filter: 6 个业务字段,无主键 ✓
结论:转换正确
核对2:工种到位情况统计表(b9546a6b)
XML display 段关键配置:
29 列,GB_PRJ_WORKER_ID: iskeycolumn(不含ismoney/issummer)
search: START/END 两个 PopupDateField 日期字段
期望 schema:
- 29 列全部转出
GB_PRJ_WORKER_ID→toggled:false(display hidden 字段折叠)- filter:
START→input-date, END→input-date
实际 schema:
- columns: 29 列 ✓
- GB_PRJ_WORKER_ID:
toggled:false✓ - filter:
[{name:START,type:input-date},{name:END,type:input-date}]✓
结论:转换正确
核对3:分公司在建项目收付款汇总表(4d9d1ab0)
XML display 段关键配置:
10 列,含 PM_PAYMENTAFFIRM_ID/PM_PAYMENTAPPLY_ID/PM_PROJECT_ID/VIEW_PM_CONTRACT_ID(多个_ID列)
AFFIRMPRICE: 无 ismoney 标注
search: ORGID(SelectDialog), USERID(TextField)
期望 schema:
- display 10 列全部转出(_ID 列在 columns 里保留,仅 search 过滤主键)
- filter: ORGID(长5不被主键规则误杀)、USERID
- AFFIRMPRICE: 无 ismoney 标注 → 未转 type:number(转换缺口)
实际 schema:
- columns: 10 列 ✓
- filter:
[{name:ORGID,...},{name:USERID,...}]✓,ORGID 保留 ✓ - AFFIRMPRICE:
type:text(XML 未标注 ismoney=true,转换器按规范未注入 number 类型)
结论:转换正确(符合规范)
转换缺口登记:AFFIRMPRICE 字段语义是金额列但 XML 未标 ismoney=true,导致未生成 number/千分位渲染。
同类问题 PAIDDATE/AFFIRMDATE 未标注 referenceid=DATE,元数据注入 type:date 依赖 SYS_ENTITYATTRIBUTE,
若实体元数据与 XML 不同步则日期列不显示格式化。→ 登记为 F3 遗留缺口(小缺口,源头是 XML 元数据缺失,需数据修正)。
五、e2e 终验
report.spec.ts(新增 5 个断言)
| 用例 | 断言要点 | 结果 |
|---|---|---|
| 项目安全费用投入明细 | summaryFields 含 APPLYMONEY + 查询区无主键 + 渲染 | PASS |
| 工种到位情况统计表 | columns=29 + START/END 日期查询区 + 渲染 | PASS |
| 分公司在建项目收付款汇总表 | ORGID/USERID 保留 + 无主键泄露 + 渲染 | PASS |
| 企业证书登记报表 | 4 业务字段含 DEPART_ID(短) + 渲染 | PASS |
| 任务二维码 | 5 查询字段 + TASKID(短) 不触发过滤 + 渲染 | PASS |
全套 e2e
74 passed(原基线 68 + 新增 5 report + 已有 f2-16 等)
1 failed(designer.spec.ts:227 - 预先存在,非本次引入)
截图存 e2e/artifacts/f3-1/(5 张)。
六、遗留缺口登记(F3 评审用)
| # | 缺口描述 | 影响范围 | 优先级 |
|---|---|---|---|
| F3-G1 | display 段金额列未标 ismoney=true,转换器无法注入 number/千分位 |
部分报表(如 AFFIRMPRICE) | 低(数据问题,需 XML 修正) |
| F3-G2 | display 段日期列 SYS_ENTITYATTRIBUTE 元数据与 XML 不同步,date/datetime 渲染未注入 | 部分报表 | 低 |
| F3-G3 | 74 个底表缺失报表 500 错误(#29 数据问题) | 74 个 type200 | 排除本任务 |
七、提交记录
见 git log:
F3-1: report族查询区过滤主键列+单测— platform-converterF3-1: 重批337个type200入库(98.2%闸一)— platform-converter 转换产物F3-1: report.spec.ts 5个断言+截图— eip4-web