# 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 任一成立即跳过): 1. `designName="主键"` 或 `label="主键"` —— 老引擎设计器明确标注主键 2. 字段名以 `_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-converter - `F3-1: 重批337个type200入库(98.2%闸一)` — platform-converter 转换产物 - `F3-1: report.spec.ts 5个断言+截图` — eip4-web