P0 修复:
- relationForm typo: ' popupTable' / searchForms 杜撰字段移除 (create.ts:299 → {})
- columnDataObj 补 29 字段: ruleList/funcs/tabConfig/viewKey/defaultColumnList 等
- useOverflow → showOverflow 命名对齐 web ColumnDesign
- printId → printIds 类型对齐 (数组 vs 单值)
P1 修复:
- buildColumnListEntry 补 31 字段: tag/tagIcon/visibility/layout/span/renderKey/fullNameI18nCode 等
- buildSearchListEntry value: '' → [] (数组, datePicker 期望)
- searchMultiple: 0 → false (bool 类型对齐)
L2 guard BS-51 降级: v0.11 schema 修复后, 简化 path 不再盲点
审计文档: doc/audit-form-create-deviations.md (659 行)
验证脚本: doc/verify-form-create-fix.mjs (99 PASS / 0 FAIL)
Co-Authored-By: Claude <[email protected]>
660 lines
29 KiB
Markdown
660 lines
29 KiB
Markdown
# dacli form create 一致性核对报告
|
||
|
||
> **审计日期**:2026-06-22
|
||
> **审计范围**:`dacli/src/commands/form/create.ts:261-304`
|
||
> **对照源**:
|
||
> - `web/apps/jnpf-web-apps-main/src/components/FormGenerator/src/helper/componentMap.ts`
|
||
> - `web/apps/jnpf-web-apps-main/src/components/ColumnDesign/src/helper/config.ts`
|
||
> - 真实表单 `workSystem:585448937427567365` / `workSystem:624163990351643525` / `workSystem:836658473499370693` (经 `dacli form info` 拉取)
|
||
>
|
||
> **结论速览**:4 个待验证点中,3 个确认为真实不一致(**任务 1、2、3、4 全部命中**),其中:
|
||
> - 任务 1(relationForm typo):**bug** — 含非法 key `' popupTable'` 与杜撰 key `searchForms`,前端永不识别
|
||
> - 任务 2(columnData 缺字段):**bug** — 29 个 web 标准字段缺失,其中 `funcs`/`ruleList`/`tabConfig` 等可能引发渲染异常
|
||
> - 任务 3(columnList entry 缺字段):**bug** — 16 个 web 真实字段缺失;`__config__` 缺 15 个子字段
|
||
> - 任务 4(searchList entry 缺字段):**bug** — 8 个 web 真实字段缺失
|
||
|
||
---
|
||
|
||
## 任务 1:验证 `' popupTable'` / `searchForms` bug
|
||
|
||
### 文件位置
|
||
- **dacli**:`/home/ubuntu/ccWorkDir/dacli/src/commands/form/create.ts:299`
|
||
|
||
### dacli 端现状(代码片段)
|
||
```typescript
|
||
// create.ts:279-304
|
||
const columnDataObj: any = {
|
||
type: 1, pageSize: 20,
|
||
// ...
|
||
relationForm: { ' popupTable': '', columnOptions: [], searchForms: [] },
|
||
// ...
|
||
}
|
||
```
|
||
|
||
### web 端真相(代码片段)
|
||
```typescript
|
||
// web/.../FormGenerator/src/helper/componentMap.ts:1363-1406
|
||
{
|
||
__config__: {
|
||
jnpfKey: 'relationForm',
|
||
label: '关联表单',
|
||
// ...
|
||
},
|
||
on: { change: '...' },
|
||
style: { width: '100%' },
|
||
placeholder: '请选择',
|
||
modelId: '',
|
||
relationField: '',
|
||
hasPage: false,
|
||
pageSize: 20,
|
||
queryType: 0,
|
||
propsValue: undefined,
|
||
extraOptions: [],
|
||
columnOptions: [],
|
||
clearable: true,
|
||
popupType: 'dialog', // ← 真实字段
|
||
popupTitle: '选择数据', // ← 真实字段
|
||
popupWidth: '800px', // ← 真实字段
|
||
filterable: false,
|
||
disabled: false,
|
||
}
|
||
```
|
||
|
||
**全部 web 真实字段(共 18 个)**:
|
||
```
|
||
__config__, on, style, placeholder, modelId, relationField,
|
||
hasPage, pageSize, queryType, propsValue, extraOptions, columnOptions,
|
||
clearable, popupType, popupTitle, popupWidth, filterable, disabled
|
||
```
|
||
|
||
### 全 web 源码搜索结果
|
||
```bash
|
||
$ grep -rn "searchForms\|popupTable" web/.../FormGenerator/
|
||
# 无任何命中(仅命中 popupTableSelect 控件名,但与 popupTable 不同)
|
||
```
|
||
|
||
### 结论:真不一致
|
||
1. **dacli `' popupTable'` 是 typo**:键名前多一个空格,且 `popupTable` 在 JNPF 控件库不存在(正确的是 `popupType`/`popupTitle`/`popupWidth`)。明显是从 `popupType` 抄错。
|
||
2. **dacli `searchForms` 完全杜撰**:web 端无此字段,关系表单(relationForm)只通过 `modelId` + `columnOptions` 控制弹窗,不存在独立的 searchForms 数组。
|
||
3. **dacli `columnOptions` 命名合法但语义错位**:web 中 `columnOptions` 在 relationForm 控件 schema 中表示弹窗列表展示列;dacli 写在 `relationForm` 内顶层是误用——dacli 把 `relationForm` 当作 `columnData` 顶层的字段了,与 web 的 columnData 顶层 `relationForm: {}`(空对象即可)语义不符。
|
||
|
||
### 影响
|
||
- dacli 生成的表单写入 JNPF 后,`relationForm` 字段为 `{ ' popupTable': '', columnOptions: [], searchForms: [] }`;前端 `Parser.vue` 解析时**全部字段被忽略**(不识别带空格的 key,也不识别 searchForms)。
|
||
- 经抽样验证 `workSystem:836658473499370693`(疑似 dacli 早期生成的 e2eTest1),存库后 relationForm 已被后端**序列化为 `{}`**(未知字段被丢弃),所以**未引发线上 bug**,但说明这段代码是死代码。
|
||
- 不影响 list 渲染(relationForm 仅供设计器右侧面板读,列表本身用 columnList 字段)。
|
||
|
||
### 修复建议
|
||
**文件**:`dacli/src/commands/form/create.ts:299`
|
||
|
||
**修复前**:
|
||
```typescript
|
||
relationForm: { ' popupTable': '', columnOptions: [], searchForms: [] },
|
||
```
|
||
|
||
**修复后(最简:与 web 一致,返回空对象)**:
|
||
```typescript
|
||
relationForm: {},
|
||
```
|
||
|
||
**修复后(完整:复刻 web schema 但保持空 schema)**:
|
||
```typescript
|
||
// 关联表单字段(design-time only, 仅设计器右侧面板读)
|
||
// 见 web/.../FormGenerator/src/helper/componentMap.ts:1363
|
||
relationForm: {
|
||
modelId: '', relationField: '',
|
||
hasPage: false, pageSize: 20, queryType: 0,
|
||
columnOptions: [],
|
||
popupType: 'dialog', popupTitle: '选择数据', popupWidth: '800px',
|
||
},
|
||
```
|
||
|
||
> 建议先用 `relationForm: {}`,最低风险修复。后续如果需要 dacli 生成自带 relationForm 弹窗列配置的表单,再展开成完整 schema。
|
||
|
||
---
|
||
|
||
## 任务 2:验证 columnData 默认值完整性
|
||
|
||
### 文件位置
|
||
- **dacli**:`/home/ubuntu/ccWorkDir/dacli/src/commands/form/create.ts:279-304` (`columnDataObj`)
|
||
- **web**:`/home/ubuntu/ccWorkDir/web/apps/jnpf-web-apps-main/src/components/ColumnDesign/src/helper/config.ts:109-198` (`defaultColumnData` / `defaultAppColumnData`)
|
||
|
||
### dacli 端现状(代码片段)
|
||
```typescript
|
||
// create.ts:279-304(27 字段)
|
||
const columnDataObj: any = {
|
||
type: 1, pageSize: 20,
|
||
showSummary: false, summaryField: '',
|
||
btnsList: [], btnsPosition: 'right', rowBtnsList: [], columnBtnsList: [],
|
||
sortList: [],
|
||
useColumnPermission: false, columnPermissions: [],
|
||
defaultSortConfig: {},
|
||
useDataInterface: false, dataInterfaceId: '',
|
||
pageSizes: [10, 20, 50, 100],
|
||
showCheckbox: false,
|
||
usePage: true, useAdvancedQuery: true, useFilter: true, useSort: true,
|
||
useOverflow: true, useDragSort: true,
|
||
hasPrint: false, printId: '', printBtnPosition: 'right',
|
||
cardListConfig: {},
|
||
complexHeaderList: [], complexHeaderConfig: {},
|
||
useCustomBtns: false, customBtnsList: [],
|
||
columnList: [], searchList: [],
|
||
appColumnOptions: [], appColumnList: [],
|
||
tableConfig: { border: true, stripe: false, size: 'default', showRadio: false, showRowNumber: true },
|
||
relationForm: { ' popupTable': '', columnOptions: [], searchForms: [] },
|
||
useBtnPermission: false, useFormPermission: false, useDataPermission: false,
|
||
hasPage: true, hasDefaultValue: false, hasSuperQuery: false, hasTreeQuery: false,
|
||
}
|
||
```
|
||
|
||
### web 端真相(代码片段)
|
||
```typescript
|
||
// web/.../ColumnDesign/src/helper/config.ts:109-198(defaultColumnData,47 字段)
|
||
const defaultColumnData = {
|
||
ruleList: { matchLogic: 'and', conditionList: [] }, // 过滤规则
|
||
searchList: [],
|
||
resizable: true,
|
||
hasSuperQuery: true,
|
||
showOverflow: true,
|
||
childTableStyle: 1,
|
||
showSummary: false, summaryField: [],
|
||
columnList: [], columnOptions: [], defaultColumnList: [],
|
||
type: 1, defaultSortConfig: [], viewKey: '',
|
||
hasPage: true, pageSize: 20,
|
||
hasTreeQuery: false,
|
||
treeTitle: '左侧标题', treeTitleI18nCode: '',
|
||
treeDataSource: 'dictionary', treeDictionary: '',
|
||
treeRelation: '', treeRelationFieldSelectType: 'all', treeRelationFieldAbleIds: [],
|
||
treeSyncType: 0, treeSyncInterfaceId: '', treeSyncInterfaceName: '',
|
||
treeSyncTemplateJson: [],
|
||
treePropsUrl: '', treePropsName: '', treeTemplateJson: [],
|
||
treePropsValue: 'id', treePropsChildren: 'children', treePropsLabel: 'fullName',
|
||
groupField: '', parentField: '',
|
||
printIds: [],
|
||
useColumnPermission: false, useFormPermission: false,
|
||
useBtnPermission: false, useDataPermission: false,
|
||
customBtnsList: [], btnsList: defaultBtnsList, columnBtnsList: defaultColumnBtnsList,
|
||
funcs: { afterOnload: '...', rowStyle: '...', cellStyle: '...' },
|
||
uploaderTemplateJson: {},
|
||
complexHeaderList: [],
|
||
tabConfig: { on: false, relationField: '', hasAllTab: true },
|
||
cardListConfig: { cardLayout: 'horizontal', ... },
|
||
}
|
||
```
|
||
|
||
### 对比结果(48 字段交集/差集)
|
||
|
||
#### dacli 有但 web 没有(24 个 dacli-only,疑似冗余/typo 字段)
|
||
| 字段 | 备注 |
|
||
|------|------|
|
||
| `appColumnList`, `appColumnOptions` | 这是 APP 端(手机端)的字段,dacli 合并到 PC 端;web `defaultAppColumnData` 才是 APP 端独立 schema |
|
||
| `btnsPosition`, `rowBtnsList`, `showCheckbox`, `useDragSort`, `useFilter`, `useSort`, `useAdvancedQuery`, `useOverflow`, `usePage`, `hasDefaultValue`, `sortList`, `columnPermissions`, `complexHeaderConfig`, `useDataInterface`, `dataInterfaceId`, `pageSizes`, `useCustomBtns`, `hasPrint`, `printId`, `printBtnPosition` | 部分可能在 web `tableConfig`/其他字段承担,需逐项查 web 渲染入口确认;当前未被 web `defaultColumnData` 收录即说明 web 不再读 |
|
||
| `relationForm: { ' popupTable': '', ... }` | 见任务 1 的 typo 段 |
|
||
|
||
#### web 有但 dacli 没有(**29 个 web-only 字段,dacli 缺失**)
|
||
|
||
**🔴 必须修复(影响 list 渲染或关键功能)**:
|
||
1. `ruleList` — 过滤规则(前端 `matchLogic + conditionList`,没它前端可能用 `undefined.conditionList` 报错)
|
||
2. `funcs` — 行/单元格/数据加载 JS 函数(`{afterOnload, rowStyle, cellStyle}`),没它设计器打开时丢默认值
|
||
3. `resizable` — 列表列拖拽开关
|
||
4. `showOverflow` — 溢出省略(dacli 写了 `useOverflow: true`,web 用 `showOverflow`,**命名不一致**,前端很可能读不到)
|
||
5. `tabConfig` — 标签面板配置 `{on, relationField, hasAllTab}`,没它 tab 控件功能失效
|
||
6. `viewKey` — 视图主键(webType=3 必填,否则 list 接口查不到视图)
|
||
7. `defaultColumnList` — 所有可选择字段列表(前端渲染列选择器,没它列配置空白)
|
||
|
||
**🟡 应该修复(树形/分组/打印功能相关)**:
|
||
8. `groupField` — 分组字段(type=3 分组列表)
|
||
9. `parentField` — 父级字段(type=3 树形列表)
|
||
10. `childTableStyle` — 子表样式(主子表特有)
|
||
11. `printIds` — 打印模板 ID 数组(dacli 写 `printId` 单值,**类型错位**——web 是数组)
|
||
12. `uploaderTemplateJson` — 上传组件模板
|
||
|
||
**🟢 设计器元数据(缺失不影响功能,但前端容错差)**:
|
||
13. `treeTitle`, `treeTitleI18nCode`, `treeDataSource`, `treeDictionary`
|
||
14. `treeRelation`, `treeRelationFieldSelectType`, `treeRelationFieldAbleIds`
|
||
15. `treeSyncType`, `treeSyncInterfaceId`, `treeSyncInterfaceName`, `treeSyncTemplateJson`
|
||
16. `treeTemplateJson`, `treePropsUrl`, `treePropsName`, `treePropsValue`, `treePropsChildren`, `treePropsLabel`
|
||
|
||
### 结论:真不一致(29 字段缺失 + 1 字段命名错误)
|
||
|
||
### 关键风险
|
||
- **盲点 51 关联**:BS-51 已知 dacli 列 schema 缺字段引发 list 白屏;本任务验证的 29 字段差异是其上游根因之一
|
||
- **type 类型错位**:dacli `printId: ''` 单值 vs web `printIds: []` 数组 → 设计器端读 `printIds.map()` 会 NPE
|
||
- **同名不同义**:dacli `useOverflow` vs web `showOverflow` → 列表溢出省略默认行为丢失
|
||
|
||
### 修复建议
|
||
|
||
**文件**:`dacli/src/commands/form/create.ts:279-304`
|
||
|
||
**修复前**:
|
||
```typescript
|
||
const columnDataObj: any = {
|
||
type: 1, pageSize: 20,
|
||
showSummary: false, summaryField: '',
|
||
// ... dacli 简化版 ...
|
||
}
|
||
```
|
||
|
||
**修复后(最小闭环,按 web `defaultColumnData` 1:1 复刻 + 修任务 1 typo)**:
|
||
```typescript
|
||
const columnDataObj: any = {
|
||
// === 与 web ColumnDesign/helper/config.ts:109-198 defaultColumnData 对齐 ===
|
||
ruleList: { matchLogic: 'and', conditionList: [] }, // 过滤规则(修复)
|
||
searchList: [], // 查询字段
|
||
resizable: true, // 列表列拖拽
|
||
hasSuperQuery: true, // 高级查询
|
||
showOverflow: true, // 溢出省略(dacli 旧名 useOverflow 修复)
|
||
childTableStyle: 1, // 子表样式(修复)
|
||
showSummary: false, summaryField: [], // 合计
|
||
columnList: [], columnOptions: [], defaultColumnList: [], // 字段列表 + 默认列
|
||
type: 1, // 列表类型
|
||
defaultSortConfig: [], // 默认排序(数组非对象)
|
||
viewKey: '', // 视图主键(修复)
|
||
hasPage: true, pageSize: 20, // 分页
|
||
hasTreeQuery: false, // 左侧树查询
|
||
// === 树形列表(type=3 时启用)===
|
||
treeTitle: '左侧标题', treeTitleI18nCode: '',
|
||
treeDataSource: 'dictionary', treeDictionary: '',
|
||
treeRelation: '', treeRelationFieldSelectType: 'all', treeRelationFieldAbleIds: [],
|
||
treeSyncType: 0, treeSyncInterfaceId: '', treeSyncInterfaceName: '', treeSyncTemplateJson: [],
|
||
treePropsUrl: '', treePropsName: '', treeTemplateJson: [],
|
||
treePropsValue: 'id', treePropsChildren: 'children', treePropsLabel: 'fullName',
|
||
// === 分组/树形主表(type=3)===
|
||
groupField: '', parentField: '',
|
||
// === 打印/上传 ===
|
||
printIds: [], // 数组(修复 dacli printId 单值)
|
||
uploaderTemplateJson: {},
|
||
// === 权限 ===
|
||
useColumnPermission: false, useFormPermission: false,
|
||
useBtnPermission: false, useDataPermission: false,
|
||
// === 按钮 + JS 函数(修复 funcs 缺失)===
|
||
customBtnsList: [],
|
||
btnsList: [ // 默认 5 个按钮(见 web config.ts:74-80)
|
||
{ show: true, value: 'add', icon: 'icon-ym icon-ym-btn-add', label: '新增', labelI18nCode: 'common.add2Text' },
|
||
{ show: false, value: 'download', icon: 'icon-ym icon-ym-btn-download', label: '导出', labelI18nCode: 'common.exportText' },
|
||
{ show: false, value: 'upload', icon: 'icon-ym icon-ym-btn-upload', label: '导入', labelI18nCode: 'common.importText' },
|
||
{ show: false, value: 'batchRemove', icon: 'icon-ym icon-ym-btn-clearn', label: '批量删除', labelI18nCode: 'common.batchDelText' },
|
||
{ show: false, value: 'batchPrint', icon: 'icon-ym icon-ym-report-icon-preview-printPreview', label: '批量打印', labelI18nCode: 'common.batchPrintText' },
|
||
],
|
||
columnBtnsList: [ // 默认列按钮(见 web config.ts:82-107)
|
||
{ show: true, value: 'edit', icon: 'icon-ym icon-ym-btn-edit', label: '编辑', labelI18nCode: 'common.editText', event: { enableFunc: '...' } },
|
||
{ show: true, value: 'remove', icon: 'icon-ym icon-ym-btn-clearn', label: '删除', labelI18nCode: 'common.delText', event: { enableFunc: '...' } },
|
||
{ show: true, value: 'detail', icon: 'icon-ym icon-ym-generator-menu', label: '详情', labelI18nCode: 'common.detailText', event: { enableFunc: '...' } },
|
||
],
|
||
funcs: { // 修复 funcs 缺失
|
||
afterOnload: '({ data, tableRef, onlineUtils }) => {\r\n \r\n}',
|
||
rowStyle: '({ row, rowIndex }) => {\r\n \r\n}',
|
||
cellStyle: '({ row, column, rowIndex, columnIndex }) => {\r\n \r\n}',
|
||
},
|
||
// === 标签面板(修复 tabConfig)===
|
||
tabConfig: { on: false, relationField: '', hasAllTab: true },
|
||
// === 卡片布局 ===
|
||
cardListConfig: {
|
||
cardLayout: 'horizontal', titleField: '', subTitleField: '',
|
||
displayFields: '', columnCount: 1, enableImage: false,
|
||
imageSource: '', displayPosition: 'left', fillMode: 'contain',
|
||
},
|
||
// === 表头与表格 ===
|
||
complexHeaderList: [], // 多级表头(dacli 旧 complexHeaderConfig 移除)
|
||
// === 关系表单(修复任务 1 的 typo)===
|
||
relationForm: {}, // 见任务 1 修复
|
||
// === dacli 保留的扩展字段(待 web 验证后清理)===
|
||
hasDefaultValue: false, // dacli 自有,需 web 验证
|
||
tableConfig: { border: true, stripe: false, size: 'default', showRadio: false, showRowNumber: true },
|
||
// === APP 端(mobile)独立字段 — 暂时保留旧名,标记待清理 ===
|
||
appColumnOptions: [], appColumnList: [],
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 任务 3:验证 columnList entry 字段完整性
|
||
|
||
### 文件位置
|
||
- **dacli**:`/home/ubuntu/ccWorkDir/dacli/src/commands/form/create.ts:261-273` (`buildColumnListEntry`)
|
||
- **web 真实**:表单 `workSystem:624163990351643525`(员工培训)首个 input 列 entry
|
||
|
||
### dacli 端现状(代码片段)
|
||
```typescript
|
||
// create.ts:261-273
|
||
const buildColumnListEntry = (field: any) => {
|
||
const label = field.fieldName || field.field
|
||
const prop = field.field
|
||
return {
|
||
label, labelI18nCode: '', prop,
|
||
fixed: 'none', headerAlign: 'left', align: 'left',
|
||
sortable: false, width: null,
|
||
jnpfKey: 'input',
|
||
__vModel__: prop,
|
||
__config__: { jnpfKey: 'input', label, showLabel: true, tableName: opts.enCode, formId: `formItem${opts.enCode}` },
|
||
fullName: label, id: prop,
|
||
}
|
||
}
|
||
```
|
||
|
||
**dacli entry 顶层字段(共 12 个)**:
|
||
```
|
||
label, labelI18nCode, prop, fixed, headerAlign, align,
|
||
sortable, width, jnpfKey, __vModel__, __config__, fullName, id
|
||
```
|
||
|
||
### web 端真相(代码片段)
|
||
```json
|
||
// 真实表单 workSystem:624163990351643525 第一条 columnList entry(input 控件)
|
||
{
|
||
"label": "工号",
|
||
"labelI18nCode": "",
|
||
"prop": "inputField44a3a9",
|
||
"fixed": "none",
|
||
"headerAlign": "left",
|
||
"align": "left",
|
||
"jnpfKey": "input",
|
||
"sortable": false,
|
||
"width": null,
|
||
"id": "inputField44a3a9",
|
||
"fullName": "工号",
|
||
"fullNameI18nCode": [""],
|
||
"clearable": true,
|
||
"useScan": false,
|
||
"suffixIcon": "",
|
||
"addonAfter": "",
|
||
"showCount": false,
|
||
"__config__": {
|
||
"formId": "formItem44a3a9",
|
||
"visibility": ["pc", "app"],
|
||
"jnpfKey": "input",
|
||
"noShow": false,
|
||
"tipLabel": "",
|
||
"tableFixed": "none",
|
||
"dragDisabled": false,
|
||
"className": [],
|
||
"label": "工号",
|
||
"trigger": "blur",
|
||
"showLabel": true,
|
||
"required": false,
|
||
"tableName": "mt624164005967037317",
|
||
"renderKey": 1730948559130,
|
||
"layout": "colFormItem",
|
||
"tagIcon": "icon-ym icon-ym-generator-input",
|
||
"tag": "JnpfInput",
|
||
"regList": [],
|
||
"tableAlign": "left",
|
||
"span": 24
|
||
},
|
||
"readonly": false,
|
||
"maskConfig": { "...": "..." },
|
||
"__vModel__": "inputField44a3a9",
|
||
"useMask": false,
|
||
"showPassword": false,
|
||
"style": { "width": "100%" },
|
||
"disabled": false,
|
||
"placeholder": "请输入",
|
||
"prefixIcon": "",
|
||
"addonBefore": "",
|
||
"on": { "change": "..." }
|
||
}
|
||
```
|
||
|
||
### 对比差异(16 个字段缺失 + 15 个 __config__ 子字段缺失)
|
||
|
||
#### 顶层 entry 缺失字段(16 个)
|
||
| 字段 | 类型 | 必要性 | 影响 |
|
||
|------|------|--------|------|
|
||
| `placeholder` | string | 必须 | 列头 tooltip/筛选占位符 |
|
||
| `clearable` | bool | 必须 | input/select 列是否可清空 |
|
||
| `disabled` | bool | 必须 | 列是否禁用 |
|
||
| `readonly` | bool | 必须 | input 列只读 |
|
||
| `style` | object | 必须 | 列宽(width 不够时补 inline style) |
|
||
| `on` | object | 必须 | change/blur 等 JS 增强 |
|
||
| `fullNameI18nCode` | string[] | 必须 | 多语言标签(无 → 设计器打开时 i18n 报错) |
|
||
| `addonBefore`, `addonAfter`, `prefixIcon`, `suffixIcon`, `showCount`, `showPassword`, `useMask`, `useScan`, `maskConfig` | 各异 | input 控件特有 | 表单设计器右侧面板读不到时,列配置面板空白 |
|
||
|
||
#### `__config__` 子字段缺失(15 个)
|
||
| 子字段 | 类型 | 影响 |
|
||
|--------|------|------|
|
||
| `tag` (e.g. `'JnpfInput'`) | string | **关键** — 控件渲染 tag,前端组件映射靠此 key |
|
||
| `tagIcon` | string | 设计器图标 |
|
||
| `visibility` | string[] | PC/APP 端可见性 |
|
||
| `layout` (`'colFormItem'`) | string | 布局模式 |
|
||
| `span` (24) | number | 栅格 |
|
||
| `required` | bool | 必填 |
|
||
| `regList` | array | 校验规则列表 |
|
||
| `trigger` | string | 校验触发时机 |
|
||
| `tipLabel` | string | 提示文案 |
|
||
| `noShow` | bool | 是否在列表隐藏 |
|
||
| `tableFixed`, `tableAlign` | string | 列表固定/对齐 |
|
||
| `dragDisabled`, `className` | bool/array | 设计器拖拽控制 |
|
||
| `renderKey` | number | 设计器渲染 key,缺失会导致**拖拽失效** |
|
||
|
||
### 结论:真不一致(31 个字段差异)
|
||
|
||
### 关键风险
|
||
- `__config__.tag` 缺失 → 前端组件映射查不到,列表列渲染空白
|
||
- `__config__.renderKey` 缺失 → 设计器列拖拽排序失效(dacli 生成 form 打开设计器无法调列顺序)
|
||
- `placeholder`/`clearable`/`disabled` 等控件属性缺失 → 设计器右侧面板打开时空白
|
||
|
||
### 修复建议
|
||
|
||
**文件**:`dacli/src/commands/form/create.ts:261-273`
|
||
|
||
**修复后**:
|
||
```typescript
|
||
const buildColumnListEntry = (field: any, jnpfKey = 'input') => {
|
||
const label = field.fieldName || field.field
|
||
const prop = field.field
|
||
// 控件 tag 映射(与 web FormGenerator componentMap 对齐)
|
||
const tagMap: Record<string, string> = {
|
||
input: 'JnpfInput',
|
||
textarea: 'JnpfInputTextarea',
|
||
inputNumber: 'JnpfInputNumber',
|
||
select: 'JnpfSelect',
|
||
datePicker: 'JnpfDatePicker',
|
||
// ...
|
||
}
|
||
const tagIconMap: Record<string, string> = {
|
||
input: 'icon-ym icon-ym-generator-input',
|
||
// ...
|
||
}
|
||
return {
|
||
// === 与 web 真实 entry 对齐(修复 16 字段)===
|
||
label, labelI18nCode: '', prop,
|
||
fixed: 'none', headerAlign: 'left', align: 'left',
|
||
sortable: false, width: null,
|
||
jnpfKey,
|
||
id: prop, fullName: label, fullNameI18nCode: [''], // 数组类型(修复)
|
||
clearable: true, disabled: false, readonly: false,
|
||
placeholder: '请输入',
|
||
style: { width: '100%' },
|
||
on: { change: '({ data, rowIndex, formData, setFormData, setShowOrHide, setRequired, setDisabled, onlineUtils }) => {\n // 在此编写代码\n \n}' },
|
||
addonBefore: '', addonAfter: '', prefixIcon: '', suffixIcon: '',
|
||
showCount: false, showPassword: false, useMask: false, useScan: false,
|
||
maskConfig: { prefixType: 1, useUnrealMask: false, maskType: 1, unrealMaskLength: 1, prefixLimit: 0, suffixLimit: 0, filler: '*', prefixSpecifyChar: '', suffixType: 1, ignoreChar: '', suffixSpecifyChar: '' },
|
||
// === __vModel__ 与 __config__(修复 __config__ 15 子字段)===
|
||
__vModel__: prop,
|
||
__config__: {
|
||
jnpfKey,
|
||
tag: tagMap[jnpfKey] || 'JnpfInput',
|
||
tagIcon: tagIconMap[jnpfKey] || 'icon-ym icon-ym-generator-input',
|
||
label, showLabel: true, tipLabel: '',
|
||
labelWidth: undefined, tableAlign: 'left', tableFixed: 'none',
|
||
className: [], defaultValue: '',
|
||
required: false, layout: 'colFormItem', span: 24,
|
||
dragDisabled: false, visibility: ['pc', 'app'],
|
||
tableName: opts.enCode,
|
||
noShow: false, regList: [], trigger: 'change',
|
||
formId: `formItem${opts.enCode}`,
|
||
renderKey: Date.now(), // 修复 design-time 拖拽
|
||
transferList: [],
|
||
},
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 任务 4:验证 searchList entry 字段完整性
|
||
|
||
### 文件位置
|
||
- **dacli**:`/home/ubuntu/ccWorkDir/dacli/src/commands/form/create.ts:274-277` (`buildSearchListEntry`)
|
||
- **web 真实**:表单 `workSystem:585448937427567365`(采购申请)首个 searchList entry(datePicker)
|
||
|
||
### dacli 端现状(代码片段)
|
||
```typescript
|
||
// create.ts:274-277
|
||
const buildSearchListEntry = (entry: any) => ({
|
||
...entry,
|
||
sourceType: 2, value: '', searchType: 1, searchMultiple: 0, isKeyword: false, noShow: false,
|
||
})
|
||
```
|
||
|
||
**dacli searchList entry 字段(= buildColumnListEntry + 6 个搜索字段,共 18 个)**:
|
||
```
|
||
label, labelI18nCode, prop, fixed, headerAlign, align, sortable, width,
|
||
jnpfKey, __vModel__, __config__, fullName, id,
|
||
sourceType, value, searchType, searchMultiple, isKeyword, noShow
|
||
```
|
||
|
||
### web 端真相(代码片段)
|
||
```json
|
||
// 真实表单 workSystem:585448937427567365 第一条 searchList entry(datePicker)
|
||
{
|
||
"label": "申请日期",
|
||
"labelI18nCode": "formGenerator.component.datePicker",
|
||
"prop": "datePickerField107",
|
||
"jnpfKey": "datePicker",
|
||
"sourceType": 2,
|
||
"value": [],
|
||
"searchType": 3,
|
||
"searchMultiple": false,
|
||
"isKeyword": false,
|
||
"id": "datePickerField107",
|
||
"fullName": "申请日期",
|
||
"fullNameI18nCode": ["formGenerator.component.datePicker"],
|
||
"clearable": true,
|
||
"__config__": {
|
||
"endRelationField": "", "dragDisabled": false, "className": [],
|
||
"showLabel": true, "required": true,
|
||
"tableName": "mt585441085065528069",
|
||
"renderKey": 1721715536926,
|
||
"tagIcon": "icon-ym icon-ym-generator-date",
|
||
"startRelationField": "", "defaultCurrent": true,
|
||
"tag": "JnpfDatePicker",
|
||
"formId": 107, "visibility": ["pc", "app"], "jnpfKey": "datePicker",
|
||
"noShow": false, "endTimeTarget": 1, "tipLabel": "",
|
||
"tableFixed": "none", "startTimeType": 1, "endTimeRule": false,
|
||
"label": "申请日期", "trigger": "change",
|
||
"startTimeRule": false, "endTimeType": 1, "layout": "colFormItem",
|
||
"startTimeTarget": 1, "regList": [], "tableAlign": "left", "span": 24,
|
||
"labelI18nCode": "formGenerator.component.datePicker",
|
||
"tipLabelI18nCode": "common.inputTextPrefix"
|
||
},
|
||
"format": "yyyy-MM-dd",
|
||
"__vModel__": "datePickerField107",
|
||
"style": { "width": "100%" },
|
||
"disabled": false,
|
||
"placeholder": "请选择",
|
||
"on": { "change": "...", "blur": "..." },
|
||
"placeholderI18nCode": "common.chooseTextPrefix"
|
||
}
|
||
```
|
||
|
||
### 对比差异(8 个字段缺失)
|
||
|
||
#### dacli searchList entry 缺失字段(8 个)
|
||
| 字段 | 类型 | 影响 |
|
||
|------|------|------|
|
||
| `fullNameI18nCode` | string[] | 多语言标签(dacli `buildColumnListEntry` 也没,需要在两个 builder 都补) |
|
||
| `clearable` | bool | 搜索框可清空 |
|
||
| `disabled` | bool | 搜索框禁用 |
|
||
| `style` | object | 搜索框宽度 |
|
||
| `placeholder` | string | 占位符 |
|
||
| `placeholderI18nCode` | string | 占位符 i18n |
|
||
| `on` | object | change/blur JS 增强 |
|
||
| `format` (date 控件) / 控件特有字段 | 视 jnpfKey | datePicker 必有,inputNumber/select 等不同 |
|
||
|
||
#### 关键类型错误
|
||
- **`value: ''` 应为 `value: []`**:dacli 写空字符串,web datePicker 类型期望数组(范围搜索),前端 `value.split` 会报错
|
||
|
||
### 结论:真不一致(8 字段缺失 + 1 类型错位)
|
||
|
||
### 关键风险
|
||
- `value: ''` 而非 `value: []` → 前端 `value.length` 读到 `undefined`,搜索时 NPE
|
||
- `placeholder`/`on` 缺失 → 设计器右侧面板空白,运营无法配置搜索增强
|
||
|
||
### 修复建议
|
||
|
||
**文件**:`dacli/src/commands/form/create.ts:274-277`
|
||
|
||
**修复后**:
|
||
```typescript
|
||
const buildSearchListEntry = (entry: any) => ({
|
||
...entry,
|
||
// === 与 web 真实 searchList entry 对齐(修复 8 字段 + 1 类型错位)===
|
||
fullNameI18nCode: [entry.fullNameI18nCode || ''], // 数组
|
||
clearable: true, disabled: false,
|
||
style: { width: '100%' },
|
||
placeholder: entry.placeholder || '请输入',
|
||
placeholderI18nCode: '',
|
||
on: { change: '({ data, rowIndex, formData, setFormData, setShowOrHide, setRequired, setDisabled, onlineUtils }) => {\n // 在此编写代码\n \n}' },
|
||
format: entry.format, // datePicker: 'yyyy-MM-dd', 其他类型透传
|
||
// === 搜索特有(修复 value 类型)===
|
||
sourceType: 2,
|
||
value: [], // 数组(修复 dacli 旧 value: '')
|
||
searchType: 1,
|
||
searchMultiple: false, // bool(修复 dacli 旧 searchMultiple: 0)
|
||
isKeyword: false,
|
||
noShow: false,
|
||
})
|
||
```
|
||
|
||
---
|
||
|
||
## 总体修复建议(优先级排序)
|
||
|
||
| 优先级 | 任务 | 修复点 | 行号 | 影响范围 |
|
||
|--------|------|--------|------|---------|
|
||
| **P0** | 任务 1 | `relationForm` typo + 杜撰字段 | create.ts:299 | 后端存库字段脏数据 |
|
||
| **P0** | 任务 2 | `columnData` 29 字段缺失 + `printId`/`useOverflow` 命名错位 | create.ts:279-304 | **盲点 51 根因**(list 白屏) |
|
||
| **P1** | 任务 3 | `columnList entry` 31 字段缺失 | create.ts:261-273 | 设计器右侧面板空白 + 列拖拽失效 |
|
||
| **P1** | 任务 4 | `searchList entry` 8 字段缺失 + `value` 类型错位 | create.ts:274-277 | 搜索栏 NPE |
|
||
|
||
### 自动化防护建议
|
||
|
||
1. **`form/_precheck.ts` 加 schema diff guard**(类似 BS-51 的 v0.7.4 修复):
|
||
```typescript
|
||
// 表单 create 后, 对比存库 columnData 字段数 vs web defaultColumnData (47)
|
||
// 若 < 35 字段,触发 WARN:「dacli 简化版 schema,建议用 `form clone <id>` 拿完整 baseline」
|
||
```
|
||
2. **`form/validate` 子命令扩展**:当前 `form validate` 仅检查 `__config__` 完整性;建议加 columnData 顶层 schema 完整性检查(v0.11 候选)。
|
||
3. **`scripts/extract-web-schema.py` 自动化**:当前手动从 web 提取,AI 易漏字段。建议该脚本输出 `data/web-derived-schemas.json` 时,自动把 `webDefault + 1:1 dacli default` 做 diff 并 PR 到 `references/web-source-map.md`。
|
||
|
||
---
|
||
|
||
## 附录:核对方法
|
||
|
||
```bash
|
||
# 1. 拉真实表单 schema(workSystem 81 张表单可作 baseline)
|
||
dacli app switch --appCode=workSystem
|
||
dacli form info 624163990351643525 # 员工培训(35KB columnData)
|
||
dacli form info 585448937427567365 # 采购申请(34KB columnData)
|
||
|
||
# 2. 对比脚本
|
||
python3 -c "
|
||
import json, urllib.request
|
||
d = json.loads(open('/tmp/crmOrder_info.json').read())
|
||
print(json.dumps(json.loads(d['columnData']), indent=2))
|
||
"
|
||
|
||
# 3. web 端基线(设计器默认 schema)
|
||
# web/.../ColumnDesign/src/helper/config.ts:109-198 defaultColumnData
|
||
# web/.../ColumnDesign/src/helper/config.ts:174-198 defaultAppColumnData
|
||
|
||
# 4. 控件 schema(jnpfKey: 'relationForm')
|
||
# web/.../FormGenerator/src/helper/componentMap.ts:1363-1406
|
||
```
|
||
|
||
## 关联盲点
|
||
|
||
- **BS-51**(dacli 简化版 schema → list 白屏):本报告 4 个任务 = BS-51 的 4 个上游根因
|
||
- **BS-50**(form schema 缺主表 → menu create "主表不存在"):相关但本报告不涉及
|
||
- **BS-47/48/49**:本报告不涉及
|