docs(codegen): 记录 form 结构差异导致 ${...} 占位符 bug

workSystem form 实测 (xdxx 797473600809468485, yhjs 797460178185224773):
- web UI 设计器创建, `__config__` 字段完整 (含 fieldAlias)
- codegen 输出无 `${...}` 字面占位符
- 单模块编译 0 errors (6 .class)
- 全 3 模块编译 0 errors (10 .class)
- 加 --auto-alias 同样 0 errors

vs jxcj_team (老版 dacli form):
- 5+ 个 `${...}` 字面占位符
- 需要 fixUnresolvedVelocityVars() 后处理兜底
- 单模块编译 0 errors (有 dacli 后处理)
- 全 3 模块编译 43 errors (ServiceImpl getafterVModel 等方法引用未定义)

结论: jxcj_team 的 ${html.fieldAlias} bug 是 form 字段结构差异造成,
不是 --auto-alias 造成. 根本修复: 一次性 PATCH 老 form 字段 (已完成).
兜底: fixUnresolvedVelocityVars() 后处理 (已实施).
This commit is contained in:
ssw committed 2026-06-23 12:57:48 +08:00
1 parent 3e024ac111
commit 8f4d238fc8
1 file changed
+4
@@ -369,6 +369,10 @@ dacli form codegen <formId> \
**已知问题(与本命令正交,不在 v0.10+ 范围)**:
- CodePreview 在某些 form 上抛 `System abnormality (400)`,后端 `PublicMacro/FormMarco.vm:1226` 对空字符串调 `substring(0,1)` 抛 `StringIndexOutOfBoundsException`。**根因**:form `formData.fields[].__config__.trigger = ''`(应为 `'blur'`/`'change'`)。**dacli 新建 form 已正确设 trigger**(`FieldBuilder.ts:215-223` 按 jnpfKey 设默认;`create.ts:347` 兜底设 `'change'`),但历史 form(如 jxcj_team 5 个字段)可能有此问题。**一次性 PATCH**:GET form → 解析 formData → 给空 trigger 字段按 jnpfKey 设值(input/textarea='blur',其他='change')→ PUT form → POST `/Actions/Release` 重发。
- 生成的 `.java` 文件含字面 `${xxx}` 占位符(JNPF Velocity 模板未替换),javac 编译失败。**根因**:老版 dacli `form create` 生成的 form `__config__` 字段不完整(如缺 `fieldAlias`),导致 JNPF Form.java.vm / Pagination.java.vm 模板输出字面 Velocity 变量。**dacli 端兜底**:`fixUnresolvedVelocityVars()` 后处理 `${...}` 占位符 → 用 `@JsonProperty` snake→camelCase 或 capitalize 末段 `.method()` 名。**实测**:
- workSystem xdxx / yhjs (web UI 设计器创建): `${}` 数量=0, 编译 0 errors
- workSystem xdxx + `--auto-alias`: 同样 0 errors (alias 不是原因)
- jxcj_team (老版 dacli form): `${}` 数量=5+, dacli 后处理后编译 0 errors
- `--auto-menu` 未实现(TODO:调 `dacli menu create --type=3 --urlAddress=model/{enCode}` 挂菜单)。
---