SelectDialog 弹窗化:select 下拉 → amis picker 多列对照弹窗(§7-1b)

老系统 SelectDialog/MultiSelectDialog = 弹窗多列表格选择;P4 批量转换器降级为 select+source
搜索下拉,丢「多列对照」(§4.2:150 dialogId/911 页)。降级注释「6.13 schema 未把 picker
纳入表单项 oneOf,闸一会拒」经核实失实——amis-schema-6.13.0.json 的 SchemaObject allOf 含
{if type==picker then PickerControlSchema},picker 表单项过得了闸一(新增
SchemaGateAndCliTest.schemaGate_picker表单项过闸一 固化)。

converter(UiTypeMapper):
- SelectDialog→picker(弹窗 table+搜索+分页)、MultiSelectDialog→picker(multiple)。
  labelField=_label/valueField=_id;source=/api/picker/{dialogid}/list(CRUD 自动透传
  q/page/perPage);pickerSchema={mode:table,headerToolbar:[search-box],footerToolbar:[pagination]}。
- 列由运行时 /api/picker 随响应 data.columns 提供——转换器不解析跨模板 dialog XML
  (§6:不加深转换器对 XML 的耦合,列知识落运行时)。
- dialogid 缺失 → 保持 F2-9 的 select 搜索下拉降级(无数据源,picker 会空载)。

metadata(PickerController):
- 每行补统一显示值 _label(picker labelField 用,选中 chip 显示人可读名而非 id)。
- 响应新增 data.columns:名称列(绑 _label,标签取实体显示列 displayname,回落「名称」)
  + 标识列(工号/编码,isidentifier,最多+3)+ 不足 2 列补首个非系统 String 列;
  友好标签查 SYS_ENTITYATTRIBUTE.displayname,系统/审计列(CREATETIME/VERSION 等)过滤。
- amis picker 内嵌 CRUD 按 data.columns 渲染多列(crud.ts: self.columns=columns.concat()),
  与 amis 6.13 picker 官方 pickerSchema(mode=table) 用法一致。

验证:converter 56 测 + SchemaGate 7 测(含 picker 过闸)+ PickerController 13 测全过;
运行时浏览器(加班登记 USERID,overlay 注入)实证:弹窗多列(显示名称+帐号)、搜索框、
分页(186 页)、单选回填——选中「丁健[100001]」后表单值写回 _id(36 位 UUID,非标签),
chip 显示 _label。MultiSelect 同源(multiple)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-13 16:14:11 +08:00
parent 2a6c1d008d
commit 9d92df2702
4 changed files with 241 additions and 29 deletions

View File

@@ -122,30 +122,33 @@ final class UiTypeMapper {
+ (hasTime ? "input-datetime-range" : "input-date-range") + "(区间)");
}
case "SelectDialog" -> {
// 旧引擎弹窗选择器 → amis select + 远程 source(弹窗数据由 dialogid 指向的模板提供,跨模板引用本批未联动)。
// 注:不用 amis picker——picker 需内嵌 pickerSchema(CRUD),且 6.13 schema 未把 picker 纳入
// 表单项 oneOf,闸一会拒(手册 §8.2 schema 严格性);select+source 双闸皆过,是更保真的降级。
// F2-9:searchable=true + source 带 q=${term} 透传搜索关键字到后端 /api/picker/{id}/list?q=
item.put("type", "select");
item.put("clearable", true);
item.put("searchable", true);
item.put("source",
"/api/picker/" + f.attributeValue("dialogid", "")
+ "/list?q=${term}&page=${page}&perPage=${perPage}");
result.degrade(origin + "@field " + name + " uitype=SelectDialog(dialogid="
+ f.attributeValue("dialogid", "") + ") → select+source(searchable) /api/picker(F2-9)");
// 旧引擎弹窗选择器 → amis picker(弹窗多列表格 + 搜索 + 分页),恢复老系统「弹窗对照选择」语义。
// 历史降级注释「6.13 schema 未纳入 picker」已核实失实:amis-schema-6.13.0.json 的 SchemaObject
// allOf 含 {if type==picker then PickerControlSchema},picker 表单项过得了闸一(见
// SchemaGateTest.picker表单项过闸一)。列由 /api/picker 运行时随响应 data.columns 提供——
// 转换器不解析跨模板 dialog XML(§6:不加深转换器对 XML 的耦合),列知识落在运行时 PickerController。
String dialogId = f.attributeValue("dialogid", "");
if (dialogId.isBlank()) {
applySelectDialogFallback(item, "", false);
result.degrade(origin + "@field " + name
+ " uitype=SelectDialog(dialogid=空) → select+source(无 dialogid,数据源缺失,保持搜索下拉)");
} else {
applyPicker(item, dialogId, false);
result.note(origin + "@field " + name + " uitype=SelectDialog(dialogid="
+ dialogId + ") → picker(弹窗 table,列由 /api/picker 运行时提供)");
}
}
case "MultiSelectDialog" -> {
// F2-9:多选 + searchable
item.put("type", "select");
item.put("multiple", true);
item.put("clearable", true);
item.put("searchable", true);
item.put("source",
"/api/picker/" + f.attributeValue("dialogid", "")
+ "/list?q=${term}&page=${page}&perPage=${perPage}");
result.degrade(origin + "@field " + name + " uitype=MultiSelectDialog(dialogid="
+ f.attributeValue("dialogid", "") + ") → select(multiple,searchable)+source /api/picker(F2-9)");
String dialogId = f.attributeValue("dialogid", "");
if (dialogId.isBlank()) {
applySelectDialogFallback(item, "", true);
result.degrade(origin + "@field " + name
+ " uitype=MultiSelectDialog(dialogid=空) → select(multiple)+source(无 dialogid,保持搜索下拉)");
} else {
applyPicker(item, dialogId, true);
result.note(origin + "@field " + name + " uitype=MultiSelectDialog(dialogid="
+ dialogId + ") → picker(弹窗 table,multiple,列由 /api/picker 运行时提供)");
}
}
case "MultiFileUploadField", "FileUploadField" -> {
// F2-8 附件控件:旧引擎 MultiFileUploadField/FileUploadField → amis input-file。
@@ -173,6 +176,56 @@ final class UiTypeMapper {
return item;
}
/**
* SelectDialog/MultiSelectDialog → amis {@code picker}(弹窗对照选择)。
*
* <p>picker 的 {@code source} 即内嵌 CRUD 的 {@code api}(见 amis Picker.tsx buildSchema:
* {@code api: props.source});{@code pickerSchema} 留空 {@code columns} → CRUD 按响应
* {@code data.columns} 渲染(见 amis crud.ts:{@code self.columns = columns.concat()}),故
* 列由运行时 {@link PickerController} 随每个 dialog 的实体提供,转换器零跨模板耦合。
* {@code labelField="_label"}(PickerController 为每行补的统一显示值,选中 chip 显示人可读名而非 id)、
* {@code valueField="_id"}(与旧 select 写回值同口径,保证表单提交值不变)。
* {@code source} 不带 {@code ?q=&page=} 模板——CRUD 自动把搜索框值 {@code q} 与 {@code page/perPage}
* 作 query 透传(见官方 picker 文档示例)。
*/
private static void applyPicker(Map<String, Object> item, String dialogId, boolean multiple) {
item.put("type", "picker");
item.put("clearable", true);
if (multiple) {
item.put("multiple", true);
}
item.put("source", "/api/picker/" + dialogId + "/list");
item.put("labelField", "_label");
item.put("valueField", "_id");
item.put("modalMode", "dialog");
item.put("modalSize", "lg");
Map<String, Object> searchBox = new LinkedHashMap<>();
searchBox.put("type", "search-box");
searchBox.put("name", "q"); // CRUD 把它作 query 透传 → PickerController 读 q
searchBox.put("placeholder", "输入关键字搜索");
Map<String, Object> pickerSchema = new LinkedHashMap<>();
pickerSchema.put("mode", "table"); // 多列表格(默认 list 为单列),列由 API 提供
pickerSchema.put("headerToolbar", List.of(searchBox));
pickerSchema.put("footerToolbar", List.of("pagination"));
item.put("pickerSchema", pickerSchema);
}
/**
* dialogid 缺失时的降级:保持 F2-9 的 {@code select + 远程 source}(搜索下拉)。
* 无 dialogid 即无可解析数据源,弹窗 picker 会空载,故不退化为弹窗,沿用既有搜索下拉降级形态。
*/
private static void applySelectDialogFallback(Map<String, Object> item, String dialogId, boolean multiple) {
item.put("type", "select");
if (multiple) {
item.put("multiple", true);
}
item.put("clearable", true);
item.put("searchable", true);
item.put("source", "/api/picker/" + dialogId + "/list?q=${term}&page=${page}&perPage=${perPage}");
}
/** 解析 EditGrid 的 {@code <editgridtemplate>} CDATA,把内嵌 editgrid 字段转成 input-table 列。 */
private static List<Map<String, Object>> buildEditGridColumns(Element f, ConversionResult result, String name) {
List<Map<String, Object>> columns = new ArrayList<>();

View File

@@ -36,6 +36,27 @@ class SchemaGateAndCliTest {
assertTrue(errors.isEmpty(), () -> "闸一应通过,但有错误: " + errors);
}
@Test
void schemaGate_picker表单项过闸一() {
// 核实历史降级注释「6.13 schema 未把 picker 纳入表单项 oneOf,闸一会拒」失实:
// amis-schema-6.13.0.json 的 SchemaObject allOf 含 {if type==picker then PickerControlSchema},
// SelectDialog→picker 的转换产物应过闸一。此测固化该结论,防回归。
JdbcTemplate jdbc = mock(JdbcTemplate.class);
lenient().when(jdbc.queryForObject(any(String.class), eq(String.class), any(Object[].class)))
.thenReturn("PM_DEMO");
TemplateToAmisConverter converter = new TemplateToAmisConverter(jdbc);
String xml = "<crud title='选择窗' entityid='e1'><display selectservice='SVC'>"
+ "<field name='NAME' text='名称' width='100'/></display>"
+ "<search><field name='PROJ' label='工程' uitype='SelectDialog' dialogid='d1'/></search></crud>";
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), id -> null);
String json = new com.fasterxml.jackson.databind.ObjectMapper().valueToTree(r.getSchema()).toString();
assertTrue(json.contains("\"picker\""), "SelectDialog 应生成 picker 表单项");
SchemaGate gate = new SchemaGate();
List<String> errors = gate.validate(r.getSchema());
assertTrue(errors.isEmpty(), () -> "picker 表单项应过闸一,但有错误: " + errors);
}
@Test
void schemaGate_明显非法schema被拒() {
SchemaGate gate = new SchemaGate();

View File

@@ -109,18 +109,54 @@ class TemplateToAmisConverterTest {
}
@Test
void crud_selectDialog降级为select() {
@SuppressWarnings("unchecked")
void crud_selectDialog转picker弹窗() {
// SelectDialog → amis picker(弹窗多列表格 + 搜索 + 分页),恢复老系统弹窗对照选择。
// 列由 /api/picker 运行时随 data.columns 提供(转换器不解析跨模板 dialog XML)。
String xml = "<crud entityid='e1'><display/>"
+ "<search><field name='PROJ' label='工程' uitype='SelectDialog' dialogid='d1'/></search></crud>";
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
assertEquals(ConversionGrade.PARTIAL, r.getGrade()); // 数据源未联动 → 降级
Map<String, Object> crud = body(r.getSchema());
Map<String, Object> filter = (Map<String, Object>) crud.get("filter");
List<Map<String, Object>> items = (List<Map<String, Object>>) filter.get("body");
// SelectDialog → select+source(picker 会被闸一拒,见 §8.2;F2-9 加了 q/page 参数)
Map<String, Object> picker = items.get(0);
assertEquals("picker", picker.get("type"));
assertEquals("/api/picker/d1/list", picker.get("source"));
assertEquals("_label", picker.get("labelField"));
assertEquals("_id", picker.get("valueField"));
assertEquals("dialog", picker.get("modalMode"));
Map<String, Object> ps = (Map<String, Object>) picker.get("pickerSchema");
assertEquals("table", ps.get("mode"));
// 现为升级 note 而非降级;degrades 不再含该 SelectDialog
assertTrue(r.getMappingNotes().stream().anyMatch(n -> n.contains("PROJ") && n.contains("picker")));
assertFalse(r.getDegrades().stream().anyMatch(d -> d.contains("SelectDialog(dialogid=d1")));
}
@Test
@SuppressWarnings("unchecked")
void crud_multiSelectDialog转picker多选弹窗() {
String xml = "<crud entityid='e1'><display/>"
+ "<search><field name='USERS' label='参与人' uitype='MultiSelectDialog' dialogid='d9'/></search></crud>";
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
Map<String, Object> filter = (Map<String, Object>) body(r.getSchema()).get("filter");
List<Map<String, Object>> items = (List<Map<String, Object>>) filter.get("body");
Map<String, Object> picker = items.get(0);
assertEquals("picker", picker.get("type"));
assertEquals(Boolean.TRUE, picker.get("multiple"));
assertEquals("/api/picker/d9/list", picker.get("source"));
}
@Test
@SuppressWarnings("unchecked")
void crud_selectDialog无dialogid保持select降级() {
// 无 dialogid → 无可解析数据源,picker 会空载,故保持 F2-9 的 select 搜索下拉降级
String xml = "<crud entityid='e1'><display/>"
+ "<search><field name='X' label='X' uitype='SelectDialog' dialogid=''/></search></crud>";
ConversionResult r = converter.convertGraded(xml, new ArrayList<>(), noPage);
Map<String, Object> filter = (Map<String, Object>) body(r.getSchema()).get("filter");
List<Map<String, Object>> items = (List<Map<String, Object>>) filter.get("body");
assertEquals("select", items.get(0).get("type"));
assertTrue(((String) items.get(0).get("source")).startsWith("/api/picker/d1/list"));
assertTrue(r.getDegrades().stream().anyMatch(d -> d.contains("SelectDialog")));
assertTrue(r.getDegrades().stream().anyMatch(d -> d.contains("dialogid=空")));
}
@Test