5.6 KiB
5.6 KiB
F2-9 选择窗完整化报告
现状实测结论
能用的
| 功能 | 状态 | 证据 |
|---|---|---|
select + source /api/picker/{dialogid}/list 基础加载 |
能用 | /api/picker/4982d448.../list 返回 450 条,status=0 |
multiple: true 多选字段已生成 |
能用 | INSUREDS(参保退保)字段已有 "multiple":true |
/api/org/depart-tree/{orgId} 部门树平铺数据 |
能用 | 五建集团 orgId 返回 31 个部门 |
不能用的(已修复)
| 问题 | 根因 | 修复 |
|---|---|---|
| [A] 138b7ca7 picker 返回"非法实体" | PickerController.resolveByViewTemplate 解析 <tree> 根元素无 entityid(树模板根是 <tree>,非 <crud entityid="...">) |
PickerController.java:遇 <tree> 根时,优先取 isroot="true" 的 <node entityid>,回退取第一个 node |
| [B] 搜索关键字不透传 | source URL 无 ?q=${term} 参数,amis select 无 searchable:true |
UiTypeMapper.java:SelectDialog/MultiSelectDialog 新增 searchable:true + source 追加 ?q=${term}&page=${page}&perPage=${perPage} |
| [D] 部门选择框无树形控件 | 138b7ca7 的 schema 是 input-tree + /api/flow/SYS_ORG_SEARCH(平铺),不是树形选择控件 |
新增 /api/org/depart-tree/{orgId}/amis-tree 端点({label,value,children} 嵌套格式);138b7ca7 schema 更新为 select-tree + source=/api/org/depart-tree/${orgId}/amis-tree |
遗留限制(不影响验收)
- label 显示 UUID([C]):HR_EMPLOYEE 的
isentitydisplay=USERID(UUID),picker label 显示 UUID 而非姓名。需后端元数据层增加显示列配置,本期不改动数据层。 - 搜索功能:
q参数传递已修复;但 GeneralPO 引擎的 LIKE 裸拼需要 labelColumn 命中,HR_EMPLOYEE 的 labelColumn=USERID(UUID),搜索中文姓名返回 0 条(此为 HR_EMPLOYEE 实体元数据问题,不是选择窗体验问题)。
多选字段盘点
| 维度 | 数量 |
|---|---|
元数据中 referenceid='LIST' 字段总量 |
446 个 |
| 涉及实体数 | 280 个 |
当前转换产物含 multiple:true 的 schema |
157 个 |
| 多选字段最多的实体 | HR_EMPLOYEE(10个)、VIEW_HR_EMPLOYEE(9个)、PM_CONTRACTUALREVIEW(9个) |
转换器按 uitype=MultiSelectDialog 生成 multiple:true,已覆盖存量多选字段。referenceid='LIST' 为中间表口径(非 SelectDialog 类型),需额外盘点是否有对应表单字段,暂不在本期范围内。
已完成工作
eip4-platform(commit: 25d5d1c)
platform-converter/src/main/java/com/eip4/platform/converter/UiTypeMapper.java
SelectDialog:新增searchable:true,source 追加?q=${term}&page=${page}&perPage=${perPage}MultiSelectDialog:同上,同时保留multiple:true
platform-metadata/src/main/java/com/eip4/platform/metadata/web/PickerController.java
resolveByViewTemplate:遇<tree>根元素时,取isroot="true"的<node entityid>(优先)或第一个 node 的 entityid- 修复后
/api/picker/138b7ca7.../list正确返回 SYS_ORG 数据(25 条,status=0)
platform-metadata/src/main/java/com/eip4/platform/metadata/web/OrgController.java
- 新增
GET /api/org/depart-tree/{orgId}/amis-tree - 返回
[{label, value, children:[...]}]嵌套格式,供 amisselect-treesource 消费 - 实测五建集团(
402881343826dc6f0138275606b50001)返回 27 个根节点,有子树层级
eip4-web(commit: c8d3209)
src/auth/token.ts
UserProfile添加org?: string字段
src/api/auth.ts
parseJwtOrg(token):从 JWT payload 解析org字段(base64url decode)toProfile:写入org字段到 profile
src/components/AmisRenderer.tsx
- 读取
getProfile().org,注入{ orgId }到 amis props 数据域 - 供 select-tree source 中
${orgId}动态引用
重批 + schema 导入
BatchConvertCli重批 1516 个模板(98.2% 闸一通过,380 onEvent 钩子全保留)page-schema-loader更新 1136 条 schema(含${term}参数)- DB 验证:1026 个 schema 已含
?q=${term}&page=${page}&perPage=${perPage}
138b7ca7 schema 更新
{
"type": "page",
"title": "部门选择框",
"body": {
"name": "DEPART",
"label": "部门",
"type": "select-tree",
"clearable": true,
"searchable": true,
"source": "/api/org/depart-tree/${orgId}/amis-tree",
"valueField": "value",
"labelField": "label",
"cascade": true
}
}
e2e 验证结果
新增测试(e2e/picker.spec.ts)
| 场景 | 模板 | 结果 | 证据 |
|---|---|---|---|
| E2E-F2-9-1 列表选择:加载→选中→回填 | 017d6c4c(人事变动-离职) | 通过 | 选项数 20,回填值非空 |
| E2E-F2-9-2 树形选择:部门选择框 | 138b7ca7 | 通过(截图存档) | select-tree 渲染,截图证明页面加载 |
| E2E-F2-9-3 多选:multiple 字段 | 017d6c4c(参保退保) | 通过 | 选项数 20,回填值"固有业务" |
| E2E-F2-9-4 onEvent 联动 | 093627bf(发文拟稿归档) | 通过 | 找到预发送人员字段,表单渲染正常 |
全量 e2e:44 passed + 4 新增 passed(共 48 通过),1 failed(toggle-state 404 为预存 F2-10 环境问题,与 F2-9 无关)。
截图存 e2e/artifacts/f2-9/(15 张)。
提交哈希
| 仓库 | 哈希 | 说明 |
|---|---|---|
| eip4-platform | 25d5d1c |
UiTypeMapper搜索、PickerController树形修复、OrgController amis-tree端点 |
| eip4-web | c8d3209 |
picker.spec.ts e2e测试、AmisRenderer orgId注入、auth JWT org解析 |