diff --git a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PickerController.java b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PickerController.java
index b765689..9cec149 100644
--- a/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PickerController.java
+++ b/platform-metadata/src/main/java/com/eip4/platform/metadata/web/PickerController.java
@@ -158,6 +158,7 @@ public class PickerController {
* 解析 path 变量为实体表名(优先级见类注释):
*
* - view_template_id → 读其 XML 根 {@code @entityid} → 实体表名(转换器产物主路径);
+ * - 内建选择器(xml=NULL 孤儿模板)→ 按模板 name 路由到规范实体(用户→VIEW_SYS_USER);
* - SYS_REFERENCE_ID → {@link DataDicService#getReferenceEntityTableName} 反解;
* - 退化:直接当实体表名(由后续白名单校验是否登记)。
*
@@ -171,15 +172,57 @@ public class PickerController {
if (byTemplate != null && !byTemplate.isBlank()) {
return byTemplate.toUpperCase();
}
- // 2) SYS_REFERENCE_ID 反解(兼容旧引擎引用语义)
+ // 2) 内建选择器(xml=NULL 孤儿模板)→ 按模板 name 路由到规范实体(VIEW_SYS_USER 等)
+ String byBuiltin = resolveBuiltinSelector(entityOrRef);
+ if (byBuiltin != null && !byBuiltin.isBlank()) {
+ return byBuiltin.toUpperCase();
+ }
+ // 3) SYS_REFERENCE_ID 反解(兼容旧引擎引用语义)
String byRef = dataDicService.getReferenceEntityTableName(entityOrRef);
if (byRef != null && !byRef.isBlank()) {
return byRef.toUpperCase();
}
- // 3) 退化:直接当实体表名(以实体作数据源的场景)
+ // 4) 退化:直接当实体表名(以实体作数据源的场景)
return entityOrRef.toUpperCase();
}
+ /**
+ * 老引擎内建用户/组织/部门选择器的规范数据源实体表名。这些选择器在 {@code view_template}
+ * 里 {@code xml} 为 NULL(无数据驱动 xml,全库 27 个空模板中属此类),故
+ * {@link #resolveByViewTemplate} 必落空——它们的数据源不在 xml 里,而由模板 {@code name}
+ * 的语义决定(用户→{@code VIEW_SYS_USER})。
+ *
+ * 典型例:{@code 1b3bad0b-...}(通知表单「接收人」用的「用户选择框(…)」)xml 为 NULL,
+ * 三级解析全落空→退化当表名→白名单拒 400。此处按 name 前缀「用户选择框」/含「用户」识别,
+ * 路由到 {@code VIEW_SYS_USER},让 picker 返回带姓名的用户选项。
+ *
+ *
仅对 xml=NULL 的孤儿模板生效(有 xml 的模板已由主路径解析,不进此分支),不影响既有解析。
+ * 部门/机构/岗位类内建选择器暂未在存量 picker dialogid 中出现,预留 name 关键字位以便后续扩展。
+ */
+ private String resolveBuiltinSelector(String maybeTemplateId) {
+ String name;
+ try {
+ List names = jdbcTemplate.queryForList(
+ "SELECT name FROM VIEW_TEMPLATE WHERE VIEW_TEMPLATE_ID = ? AND xml IS NULL",
+ String.class, maybeTemplateId);
+ if (names.isEmpty()) {
+ return null;
+ }
+ name = names.get(0);
+ } catch (DataAccessException ex) {
+ return null;
+ }
+ if (name == null || name.isBlank()) {
+ return null;
+ }
+ // 用户选择器(内建)→ 规范用户实体。"用户选择框" 前缀是老引擎内建用户选择器的固定命名,
+ // 含"用户"亦兜底归此类。返回的表名仍须过 list() 里的白名单(VIEW_SYS_USER 已登记)。
+ if (name.startsWith("用户选择框") || name.contains("用户")) {
+ return "VIEW_SYS_USER";
+ }
+ return null;
+ }
+
/**
* 把 {@code dialogid}(= view_template_id)解析为弹窗数据源实体表名:
* 取该模板 XML 根元素的 {@code @entityid} 属性 → {@link DataDicService#getSYSEntity} 取 TABLENAME。
@@ -239,13 +282,30 @@ public class PickerController {
}
/**
- * 选用作 label 的「可读标识列」:优先实体声明的标识列(isidentifier),
- * 回退实体的显示列(getDisplayIndex),再回退首个非主键的 String 列;都没有则返回 null
- * (此时 label 回落为主键值)。
+ * 选用作 label 的「可读标识列」:优先实体声明的显示列({@code isentitydisplay=1},
+ * 经 {@link POJOInfo#getDisplayIndex}),回退实体的标识列({@code isidentifier=true}),
+ * 再回退首个非主键的 String 列;都没有则返回 null(此时 label 回落为主键值)。
+ *
+ * F2-9 修复(label=工号/UUID 退化):原顺序「标识列优先」会让 VIEW_SYS_USER 这类实体
+ * 选中 {@code ACCOUNT}(工号,isidentifier=1,列序在 DISPLAYNAME 之前)而非
+ * {@code DISPLAYNAME}(姓名,isentitydisplay=1)——picker 标签遂显示工号/UUID 而非人名。
+ * 实体显式声明的「显示列」就是给人看的可读标识(与旧引擎弹窗 {@code } 首列、
+ * selectservice 的展示语义一致),故应优先于通用标识列。
+ *
+ * 注:{@code getDisplayIndex()} 在实体无显示列时回落为 0(即主键列),故此处用
+ * {@code !equalsIgnoreCase(keyColumn)} 守卫——主键不可作 label,落空则继续走标识列/String 列。
*/
private String displayColumn(POJOInfo info, String keyColumn) {
int count = info.getColumnCount();
- // 1) 标识列(isidentifier=true)
+ // 1) 实体声明的显示列(isentitydisplay=1)——人可读标识优先(如 VIEW_SYS_USER.DISPLAYNAME=姓名)
+ int di = info.getDisplayIndex();
+ if (di >= 0 && di < count) {
+ String name = info.getColumnName(di);
+ if (name != null && !name.equalsIgnoreCase(keyColumn)) {
+ return name.toUpperCase();
+ }
+ }
+ // 2) 标识列(isidentifier=true)
for (int i = 0; i < count; i++) {
if (info.isIdentifier(i)) {
String name = info.getColumnName(i);
@@ -254,14 +314,6 @@ public class PickerController {
}
}
}
- // 2) 实体声明的显示列
- int di = info.getDisplayIndex();
- if (di >= 0 && di < count) {
- String name = info.getColumnName(di);
- if (name != null && !name.equalsIgnoreCase(keyColumn)) {
- return name.toUpperCase();
- }
- }
// 3) 首个非主键 String 列
for (int i = 0; i < count; i++) {
String name = info.getColumnName(i);
diff --git a/platform-metadata/src/test/java/com/eip4/platform/metadata/web/PickerControllerTest.java b/platform-metadata/src/test/java/com/eip4/platform/metadata/web/PickerControllerTest.java
index 75c825e..69d5de7 100644
--- a/platform-metadata/src/test/java/com/eip4/platform/metadata/web/PickerControllerTest.java
+++ b/platform-metadata/src/test/java/com/eip4/platform/metadata/web/PickerControllerTest.java
@@ -300,4 +300,93 @@ class PickerControllerTest {
verify(wl).requireLegalTable("PM_PROJECT"); // 解析出 PM_PROJECT 并过白名单
verify(engine).listSelect(any(), eq("PM_PROJECT"), any(Properties.class));
}
+
+ /**
+ * 模式 A(内建用户选择框孤儿,xml=NULL):dialogid 命中 VIEW_TEMPLATE 但 xml 为 NULL,
+ * 主路径 {@link PickerController#resolveByViewTemplate} 落空 →
+ * {@link PickerController#resolveBuiltinSelector} 按 name 前缀「用户选择框」路由到 VIEW_SYS_USER。
+ * 这是 {@code 1b3bad0b-...}(通知表单「接收人」)这类内建选择器的修复路径。
+ */
+ @Test
+ @DisplayName("10. 模式A:用户选择框孤儿(xml=NULL) → 按 name 路由到 VIEW_SYS_USER")
+ void resolvesBuiltinUserSelectorOrphanToViewSysUser() {
+ String dialogId = "1b3bad0b-a24b-4347-9466-db78f7432756";
+ POJOCRUDService engine = mock(POJOCRUDService.class);
+ DataDicService dic = mock(DataDicService.class);
+ IdentifierWhitelist wl = mock(IdentifierWhitelist.class);
+ JdbcTemplate jdbc = mock(JdbcTemplate.class);
+ // 主路径查询(xml IS NOT NULL)返回空 → resolveByViewTemplate 落空
+ when(jdbc.queryForList(org.mockito.ArgumentMatchers.contains("xml IS NOT NULL"),
+ eq(String.class), eq(dialogId))).thenReturn(List.of());
+ // 内建选择器查询(xml IS NULL)返回模板 name → resolveBuiltinSelector 命中
+ when(jdbc.queryForList(org.mockito.ArgumentMatchers.contains("xml IS NULL"),
+ eq(String.class), eq(dialogId)))
+ .thenReturn(List.of("用户选择框(公司部门/岗位类别/用户类别,正常/禁止登录-受权限控制)"));
+ Map result = engineResult(fakeRow("u1", "罗来伟"));
+ when(engine.listSelect(any(), eq("VIEW_SYS_USER"), any(Properties.class))).thenReturn(result);
+ seedPoInfoCache("VIEW_SYS_USER", fakeInfo());
+ PickerController c = new PickerController(engine, dic, wl, jdbc);
+
+ Map resp = c.list(dialogId, null, 1, 20, null, null, null, null);
+
+ assertEquals(0, resp.get("status"));
+ verify(wl).requireLegalTable("VIEW_SYS_USER"); // 路由到 VIEW_SYS_USER 并过白名单
+ verify(engine).listSelect(any(), eq("VIEW_SYS_USER"), any(Properties.class));
+ // 未走 ref 反解(孤儿分支在 ref 之前命中)
+ org.mockito.Mockito.verify(dic, org.mockito.Mockito.never()).getReferenceEntityTableName(dialogId);
+ }
+
+ /**
+ * 模式 B(label 退化为工号/UUID):实体的「标识列」(isidentifier,如 ACCOUNT=工号) 列序在
+ * 「显示列」(isentitydisplay,如 DISPLAYNAME=姓名) 之前。F2-9 修复后 label 取显示列(姓名)而非
+ * 标识列(工号)。覆盖 {@link PickerController#displayColumn} 的优先级修正(显示列优先于标识列)。
+ */
+ @Test
+ @DisplayName("11. 模式B:label 取实体显示列(DISPLAYNAME=姓名),而非靠前的标识列(ACCOUNT=工号)")
+ void labelPrefersEntityDisplayColumnOverIdentifier() {
+ POJOCRUDService engine = mock(POJOCRUDService.class);
+ DataDicService dic = mock(DataDicService.class);
+ IdentifierWhitelist wl = mock(IdentifierWhitelist.class);
+ when(dic.getReferenceEntityTableName(REF_ID)).thenReturn("VIEW_SYS_USER");
+ // 模拟 VIEW_SYS_USER 列布局:0=主键, 1=ACCOUNT(标识列,工号), 2=DISPLAYNAME(显示列,姓名)
+ POJOInfo userInfo = mock(POJOInfo.class);
+ when(userInfo.hasKeyColumn()).thenReturn(true);
+ when(userInfo.getKeyColumnName()).thenReturn("VIEW_SYS_USER_ID");
+ when(userInfo.getColumnCount()).thenReturn(3);
+ when(userInfo.getColumnName(0)).thenReturn("VIEW_SYS_USER_ID");
+ when(userInfo.getColumnName(1)).thenReturn("ACCOUNT");
+ when(userInfo.getColumnName(2)).thenReturn("DISPLAYNAME");
+ when(userInfo.isIdentifier(0)).thenReturn(true); // 主键也是标识列(被 keyColumn 守卫跳过)
+ when(userInfo.isIdentifier(1)).thenReturn(true); // ACCOUNT 标识列(原逻辑会错选这列)
+ when(userInfo.isIdentifier(2)).thenReturn(false);
+ when(userInfo.getDisplayIndex()).thenReturn(2); // DISPLAYNAME 是 isentitydisplay 列
+ org.mockito.Mockito.doReturn(String.class).when(userInfo).getColumnClass(org.mockito.ArgumentMatchers.anyInt());
+ seedPoInfoCache("VIEW_SYS_USER", userInfo);
+
+ // 引擎行:ACCOUNT=130218(工号), DISPLAYNAME=罗来伟[130218](姓名)
+ GeneralPOJO row = mock(GeneralPOJO.class);
+ when(row.get_ID()).thenReturn("u1");
+ when(row.get_ColumnCount()).thenReturn(3);
+ when(row.get_ColumnName(0)).thenReturn("VIEW_SYS_USER_ID");
+ when(row.get_ColumnName(1)).thenReturn("ACCOUNT");
+ when(row.get_ColumnName(2)).thenReturn("DISPLAYNAME");
+ when(row.get_Value(0)).thenReturn("u1");
+ when(row.get_Value(1)).thenReturn("130218");
+ when(row.get_Value(2)).thenReturn("罗来伟[130218]");
+ Map result = new HashMap<>();
+ result.put(POJOCRUDService.LIST_RESULT, List.of(row));
+ result.put(POJOCRUDService.PAGE_COUNT, 1L);
+ when(engine.listSelect(any(), eq("VIEW_SYS_USER"), any(Properties.class))).thenReturn(result);
+ PickerController c = new PickerController(engine, dic, wl, emptyTemplateJdbc());
+
+ Map resp = c.list(REF_ID, null, 1, 20, null, null, null, null);
+
+ @SuppressWarnings("unchecked")
+ Map data = (Map) resp.get("data");
+ @SuppressWarnings("unchecked")
+ List