# P4 批量转换报告(模板转换器扩展 + 全量批量转换 + 双闸分级) > 日期:2026-06-11 | 作者:platform-converter 工作线 > 数据源:客户库 192.168.20.68:5435/postgres?currentSchema=eip3(ceshi/ceshi,**只读**) > 工程:eip4-platform/platform-converter(JDK17) > 前序:PoC 种子 `TemplateToAmisConverter`(display/search/button 三段,3 模板 0 错误已验证) > 依据:docs/迁移手册.md §8(amis schema 宽松语义预处理、双闸必要性、dom4j getText)、 > ../docs/决策与盘点/EIP3报表迁移方案.md(A 类报表=`` 段口径) --- ## 一、一句话结论 全量 **1,516** 个 view_template 批量转换:**闸一(官方 schema 校验)通过率 98.2%(1489/1516)**; 闸二(headless 渲染冒烟,每类型抽 ≥5)**25/25 全通过**。 未过闸一的 27 个全部是 **xml 为空的孤儿模板**(库内数据问题,非转换器缺陷),转换器对其旁路标记不崩。 通过率数字 98.2% 即检查点②(首功能点切流)的输入。 --- ## 二、总量与各类型分布 模板按 XML 根元素分派转换(根元素与 view_template.type 一一对应): | 根元素 | 类型语义 | 总量 | 闸一通过 | 通过率 | SUCCESS | PARTIAL | FAILED | |--------|---------|-----:|--------:|------:|--------:|--------:|-------:| | crud | GRID 列表页 | 956 | 956 | 100.0% | 259 | 697 | 0 | | report | A 类表格式报表 | 337 | 337 | 100.0% | 0 | 337 | 0 | | tree | 树 / 树+grid | 106 | 106 | 100.0% | 0 | 106 | 0 | | form | EDITFORM 表单页 | 70 | 70 | 100.0% | 0 | 70 | 0 | | group | 分组容器 | 20 | 20 | 100.0% | 0 | 20 | 0 | | (空 xml) | 孤儿模板 | 27 | 0 | 0.0% | 0 | 0 | 27 | | **合计** | | **1516** | **1489** | **98.2%** | **259** | **1230** | **27** | > 分级口径: > - **SUCCESS**:全字段命中映射规则,无降级标注,闸一通过。 > - **PARTIAL**:转出有效 amis schema 且闸一通过,但有字段/特性走降级旁路(标注在映射台账)。 > - **FAILED**:无法转出(xml 为空 / 解析失败 / 根元素不支持),不入产物只入失败清单。 > > report/tree/form/group 全部落 PARTIAL 是设计内:report 普遍含 JOR 套打版式(C 类不迁移)、 > tree 普遍含节点级按钮、form 普遍含 SelectDialog/自定义 HTML 版式、group 全为跨模板壳—— > 这些都是「能渲染、待后端/人工补」的降级,不是错误。 --- ## 三、双闸结果 ### 闸一:官方 schema 校验(amis-schema-6.13.0.json,draft-07) - 通过 **1489/1516 = 98.2%**。 - 复用迁移手册 §8.1 的**宽松语义预处理**(递归剥除 `$ref` 节点的兄弟 `additionalProperties:false`), 实现抽到 `platform-converter/SchemaGate`,与 `AmisSchemaController` 共享同一份口径(消除 metadata 侧重复实现)。 - 失败 27 个全部因 xml 为空,无 schema 可校验。 ### 闸二:headless 渲染冒烟(playwright + 本地 amis SDK 6.13.0) 口径:对每个模板类型从**闸一通过**的 schema 中抽 **≥5** 个,用本地 amis SDK(`../eip4-poc/.../sdk-local/`)+ 无头 chromium 逐个 `amis.embed` 渲染,判定 ① 无未捕获 JS 错误 ② 根组件渲染出 DOM(#root 有子节点)。 数据接口全部桩成空响应(冒烟只验「能渲染根组件」,不验数据)。**全量渲染不要求——本闸是抽样冒烟。** | 类型 | 抽样 | 通过 | 失败 | |------|----:|----:|----:| | crud | 5 | 5 | 0 | | report | 5 | 5 | 0 | | tree | 5 | 5 | 0 | | form | 5 | 5 | 0 | | group | 5 | 5 | 0 | | **合计** | **25** | **25** | **0** | > 闸二坑(已修,记入手册):大 schema 经 URL query 注入触发 **HTTP 431 (Request Header Fields Too Large)**, > 误判为「根组件未渲染」。改为 schema 经独立 `/schema?id=` 端点拉取后,form 抽样从 4/5 → 5/5。 产物:`转换产物/闸二结果.json`(含逐样本判定)。 --- ## 四、失败模式 Top10(按模板计,去重原因) | # | 模板数 | 归类 | 模式 | |---|------:|------|------| | 1 | 937 | 转换器缺陷(待补能力) | search 字段 uitype=SelectDialog → select+source 占位(弹窗数据源 /api/picker 待后端实现) | | 2 | 329 | C 类设计内不迁移 | report 含 reportfile(JOR 套打版式)→ 仅转表格视图,套打另案 univer/Web 打印 | | 3 | 138 | 转换器缺陷(待补能力) | search 字段 uitype=MultiSelectDialog → select(multiple)+source 占位 | | 4 | 69 | 模板版式 | form 含 HTML `` 自定义表格版式 → amis 默认纵向布局替代,版式需人工核对 | | 5 | 61 | 转换器缺陷(待补能力) | tree 节点含 buttons(增删改保存)→ input-tree 不原生支持节点级按钮,需自定义工具栏 | | 6 | 50 | 转换器缺陷(待补能力) | editform 字段 uitype=SelectDialog → select+source 占位 | | 7 | 41 | 转换器缺陷(待补能力) | editform 字段 uitype=MultiFileUploadField → 暂映射 input-text(映射表待补该控件) | | 8 | 27 | **模板数据问题** | xml 为空(孤儿模板,FAILED) | | 9 | 26 | 主子表已支持 | editform 字段 uitype=EditGrid → input-table 子表(保存联动 updateSubTable 待后端) | | 10 | 20 | 跨模板引用 | group 分组容器仅转 tabs 壳,各 tab 子模板需跨模板联动加载 | **三桶归类(按模板计)**: | 桶 | 模板数 | 说明 | |----|------:|------| | 转换器缺陷(待补能力) | 1228 | 绝大多数是 SelectDialog→数据源未联动、JOR 套打、跨模板引用等「schema 有效、待后端/人工补」项,**非渲染缺陷** | | 模板数据问题 | 28 | xml 为空(27)+ 个别解析问题,库内存量数据缺陷 | | 孤儿模板(entityid 非法) | 5 | entityid 在 SYS_ENTITY 无对应实体(迁移手册 §7.4),转换器旁路标记不崩 | > 关键判读:「转换器缺陷」桶 1228 个里,**937+138+50=1125 个其实是同一件事**——SelectDialog/MultiSelectDialog > 弹窗数据源 `/api/picker/{dialogid}/list` 尚未由后端实现。schema 本身有效且渲染通过,属「待联动」而非「转不出」。 > 真正需要补转换器映射规则的只有 MultiFileUploadField(41)等少数控件。 --- ## 五、转换器扩展明细(PoC 种子 → P4) 在 PoC 已验证的 crud 三段(display/search/button)上扩出五类根元素分派: | 段 | 旧形态 | amis 映射 | 备注 | |----|--------|----------|------| | **crud** | `` | crud columns | 强化 null-safe、金额列(ismoney)→number+千分位、对齐、top-level+display 双挂 button | | **EDITFORM** | `
` + view_page 的 `` | form + body items | 字段经 pageid 解析 view_page 取得;method→form actions | | **主子表** | form 内 `uitype=EditGrid/FormEditGrid` | **input-table** + 子列 | 子列解析 `` CDATA 内 `` | | **树** | `` / `` | input-tree / flex(tree+crud) | type=3 声明式 / type=4 引用式两路 | | **picker(选择窗)** | `uitype=SelectDialog/MultiSelectDialog` | **select + 远程 source** | 不用 amis picker——picker 需内嵌 pickerSchema 且 6.13 schema 未纳入表单项 oneOf,闸一会拒(§8.2);select+source 双闸皆过,更保真 | | **``(A 类)** | `` | crud + 合计行/金额列 | issummer=true→summaryFields、ismoney→number;selectservice→`/api/flow/{id}`;JOR reportfile/图表降级标注(B/C 类另案) | | **group** | `