列表引用列 id→显示名:补提交 converter 绑定 + resolver 通用化实现(收尾 662828c)

662828c 仅提交了通用化测试(UserColumnResolverTest),其消息所述的 resolver 实现
与 converter 绑定改动当时漏入暂存区,致 HEAD 处于"新测试 vs 旧实现"不一致态:
committed resolver 仍是"只认 SYS_USER"的 211 行旧版,通用化测试本应红。本次补齐。

resolver(UserColumnResolver,211→341 行):
- 从"只认 SYS_USER + 覆盖写"推广为"任意引用实体"。按 referenceid→SYS_REFERENCE→
  目标实体解析目标表/键/显示列(isentitydisplay→isidentifier→物理名称列兜底→主键);
  SYS_USER 重定向 VIEW_SYS_USER.DISPLAYNAME。
- 产出 row[col+'_DISPLAY__']=显示名,**保留原始 col=id 不动**(编辑弹窗 data=
  selectedItems[0],覆盖原始列会把名当 select 值写回 id 列致数据损坏)。
- 物理列守卫:元数据声明的显示列可能是虚拟列(如 SYS_DEPART.FULLNAME 由 COLUMNSQL
  算出,物理表无此列,直接 SELECT 报错)→ 兜底物理 NAME/FULLNAME/TITLE。
- 修正 3 处 NUL 字节污损(prior edit 把空格写成 \0,含 cacheKey 分隔符字面量 '\0'),
  git 因之将该文件判为 binary;现复原为空格,文件回到 UTF-8 文本。

converter(applyColumnRenderType + buildColumns):
- default 分支识别真引用列(referenceid 是 36 位 UUID,与引擎 GeneralPO.
  get_DisplayValue 的 dt.length()==36 同口径)→ 列表列绑 <COL>_DISPLAY__。
- 源 <COL>_DISPLAY__ 字段保留绑定,不再剥成原始列(那会显示 id)。
- 新增 2 测试:引用列绑定到 displayField、源 _DISPLAY__ 列保留不剥离。
- 分级清单.csv 随新转换器重批(mapping_notes 计数因每引用列多一条绑定 note 上浮)。

验证:resolver 9 测 + converter 54 测全过;运行时 OA_OFFICE_COLLARAPPLY_SEARCH 实证
APPLYNAME=系统管理员[admin]、DEPART_ID=法务合约部(虚拟列兜底)、STORE_ID=lll办公用品0412,
原始 id 全保留(APPLYNAME=ADMIN/DEPART_ID=402881.../STORE_ID=162c2061...)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-13 15:48:27 +08:00
parent 662828c8ac
commit 2a6c1d008d
4 changed files with 1135 additions and 956 deletions

View File

@@ -188,9 +188,10 @@ public class TemplateToAmisConverter {
String name = f.attributeValue("name", "");
Map<String, Object> col = new LinkedHashMap<>();
if (name.endsWith("_DISPLAY__")) {
String raw = name.substring(0, name.length() - "_DISPLAY__".length());
col.put("name", raw);
result.note("display@field " + name + " → 原始列 " + raw + "(翻译列,REST 层待补显示值)");
// 老模板已显式声明显示列:保留 _DISPLAY__ 绑定,REST 读层(UserColumnResolver)填充显示名。
// 不再剥成原始列(那会显示 id)。label 取原始列名去后缀。
col.put("name", name);
result.note("display@field " + name + " → 保留显示列绑定(REST 层 UserColumnResolver 填显示名)");
} else {
col.put("name", name);
}
@@ -302,7 +303,17 @@ public class TemplateToAmisConverter {
col.put("map", boolMap);
result.note("F2-16 display@field " + name + " referenceid=BOOLEAN → type=mapping(否/是)");
}
default -> { /* NVARCHAR/CHAR/INTEGER 等普通类型,不注入特殊渲染 */ }
default -> {
// 真引用列:referenceid 是 36 位 UUID(经 SYS_REFERENCE 指向另一实体),与引擎
// GeneralPO.get_DisplayValue 的 dt.length()==36 判定同口径。列表列绑到 <COL>_DISPLAY__,
// 由 REST 读层 UserColumnResolver 填目标实体显示名;原始 id 列保留供编辑表单 select。
// 其余(NVARCHAR/CHAR/INTEGER/DECIMAL 等类型字面)不注入特殊渲染。
if (refId.length() == 36 && refId.indexOf('-') >= 0 && !name.endsWith("_DISPLAY__")) {
col.put("name", name + "_DISPLAY__");
result.note("display@field " + name + " referenceid=引用(" + refId
+ ") → 列绑 " + name + "_DISPLAY__(REST 层 UserColumnResolver 填显示名)");
}
}
}
}

View File

@@ -650,6 +650,44 @@ class TemplateToAmisConverterTest {
assertTrue(r.getMappingNotes().stream().anyMatch(n -> n.contains("F2-16") && n.contains("STATUS")));
}
@Test
@SuppressWarnings("unchecked")
void 引用列绑定到displayField字段() throws Exception {
// 真引用列(referenceid=36 位 UUID)→ 列表列绑 <COL>_DISPLAY__,由 REST 层 UserColumnResolver 填显示名;
// 类型字面(NVARCHAR 等)的普通列不动。与引擎 GeneralPO.get_DisplayValue 的 dt.length()==36 同口径。
String refUuid = "12345678-1234-1234-1234-123456789abc";
String[][] attrRows = {
{"DEPART_ID", refUuid, null}, // 真引用列
{"TITLE", "NVARCHAR", null}, // 普通类型字面
};
TemplateToAmisConverter c = converterWithMeta(attrRows, new String[0][]);
String xml = "<crud entityid='e1'><display>"
+ "<field name='DEPART_ID' text='申请部门'/>"
+ "<field name='TITLE' text='标题'/>"
+ "</display></crud>";
ConversionResult r = c.convertGraded(xml, new ArrayList<>(), noPage);
List<Map<String, Object>> cols = (List<Map<String, Object>>) body(r.getSchema()).get("columns");
assertEquals("DEPART_ID_DISPLAY__", cols.get(0).get("name"), "引用列应绑到 _DISPLAY__ 显示字段");
assertEquals("申请部门", cols.get(0).get("label"), "label 不变");
assertEquals("TITLE", cols.get(1).get("name"), "普通类型列不动");
assertTrue(r.getMappingNotes().stream().anyMatch(n -> n.contains("DEPART_ID_DISPLAY__")));
}
@Test
@SuppressWarnings("unchecked")
void 源DISPLAY后缀列保留绑定不剥离() throws Exception {
// 老模板已显式声明 <COL>_DISPLAY__ 显示列 → 保留绑定(不再剥成原始列致显示 id)
TemplateToAmisConverter c = converterWithMeta(new String[0][], new String[0][]);
String xml = "<crud entityid='e1'><display>"
+ "<field name='USER_ID_DISPLAY__' text='拟稿人'/>"
+ "</display></crud>";
ConversionResult r = c.convertGraded(xml, new ArrayList<>(), noPage);
List<Map<String, Object>> cols = (List<Map<String, Object>>) body(r.getSchema()).get("columns");
assertEquals("USER_ID_DISPLAY__", cols.get(0).get("name"), "源 _DISPLAY__ 列应保留绑定");
assertEquals("拟稿人", cols.get(0).get("label"));
}
@Test
@SuppressWarnings("unchecked")
void f2_16_布尔列注入mapping否是() throws Exception {