# 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` 解析 `` 根元素无 `entityid`(树模板根是 ``,非 ``) | `PickerController.java`:遇 `` 根时,优先取 `isroot="true"` 的 ``,回退取第一个 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`:遇 `` 根元素时,取 `isroot="true"` 的 ``(优先)或第一个 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:[...]}]` 嵌套格式,供 amis `select-tree` source 消费 - 实测五建集团(`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 更新 ```json { "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解析 |