feat(converter): 业务动作按钮脚本联动真生效——迁 headerToolbar+id+选中行+复位

WS-B 最后一环:让新闻管理 8 个业务动作按钮(发布/显示/隐藏/置顶/文件归档/
取消置顶/提交审批/删除)的脚本联动(选中行→按 STATUS 点亮/置灰)在 UI 真生效。

根因(修前):type=delete+servicename 的业务按钮走 bulkActions 分支,bulkActions
按钮无 id → onselectedscript 脚本的 enabled/disabled 指令(componentId=按钮中文名)
定位不到 → 静默 no-op;且 amis 选中行自动点亮全部 bulkActions → 全亮失真。

改法(buildToolbar):业务/删除按钮全部改挂 headerToolbar,补 id=中文名(供脚本
componentId 精准启停),不再用 bulkActions 槽(删除 buildToolbar 的 bulkActions 形参
+ "bulkActions" 占位 token;convertCrud/treegrid 两调用点同步)。

四处 amis 6.13 实证(playwright 真实渲染+抓包,spike 2026-06-14)决定的关键细节:
1) 选中行表达式:${ids} 仅 bulkActions 路径注入、headerToolbar 取不到(POST 空);
   改 ${selectedItems|pick:<PK>|join:','} 在 headerToolbar 作用域可读。
2) baseline:业务按钮 disabled:true(贴老 Vaadin「先禁用、脚本据 STATUS 点亮」,见
   rewritten/ddb75614 seq1 仅 enableButton(...,true) 不复位);脚本 enabled 指令
   覆盖 baseline、无冲突。删除是「选中即可」语义 → disabledOn 随选中态。
3) 切行防残留:attachScriptOnEvent 在 selectedChange 链最前对所有 baseline 禁用业务
   按钮发 disabled 复位,再跑脚本(脚本只 enable 不 disable 对侧,不复位则 ISSHOW=1
   行点亮「隐藏」切到 ISSHOW=0 行仍亮)。
4) api 形态+data 键:字符串式 api("POST:...")同级 data 被 amis 当局部数据域、请求体
   只剩 {page:1} 丢选中行 → 改对象式 api 内嵌 data;且业务流(PUBLISH/ISSHOW…)input
   只声明 map、脚本读 map[<PK>],须把单选主键放 data[<PK>]=${selectedItems.0.<PK>}
   (放 ids 不识别 → status:0 但 result:null 空转),删除族(input 声明 <PK> required)
   仍带 ids 走 FlowController fanout,一份 schema 覆盖两族。

浏览器端到端实证(8093 live + 5173,admin):初始全业务按钮灰;选 STATUS=3/ISSEND=1/
ISSHOW=1 行→隐藏+置顶点亮、发布灰;切 ISSHOW=0 行→显示点亮、隐藏复位转灰;点亮的
「显示」点击→POST /api/flow/OA_NEWSMANAGE_ISSHOW 带正确选中行 id、200、DB 行 ISSHOW
0→1 真落库;console 0 ajax 报错。

测试:platform-converter 102 绿(TemplateToAmisConverterTest 新增「新闻业务动作按钮挂
headerToolbar 脚本可联动」「selectedChange 先复位再跑脚本」「无业务按钮不加复位」3 用例,
改写 delete/业务 delete/安全中和/index 偏移等既有用例至 headerToolbar+对象式 api 契约)。
全量重转 crud 956/956、[WS-B]对齐告警 0,SchemaImportCli upsert 659。

base=47d03b7

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-14 16:47:22 +08:00
parent 47d03b714b
commit 8df37e99f7
2 changed files with 343 additions and 123 deletions

View File

@@ -165,8 +165,7 @@ public class TemplateToAmisConverter {
List<Map<String, Object>> columns = display != null ? buildColumns(display, entityId, result) : new ArrayList<>();
Map<String, Object> filter = buildSearchFilter(crud.element("search"), result, entityId);
List<Map<String, Object>> bulkActions = new ArrayList<>();
List<Object> toolbar = buildToolbar(collectButtons(crud), table, entityId, bulkActions, result);
List<Object> toolbar = buildToolbar(collectButtons(crud), table, entityId, result);
// 主子表识别:display 段含 <subtemplate>/<detail> 指向子表,或 crud 含 ismaster 标记
boolean masterSub = crud.element("subtemplate") != null
@@ -186,11 +185,8 @@ public class TemplateToAmisConverter {
}
crudSchema.put("columns", columns);
crudSchema.put("headerToolbar", toolbar);
// F2-17:删除走 bulkActions(amis 标准批量操作槽,可靠提供 ${ids};headerToolbar
// 单选 radio 不填充 selectedItems 字段访问)。bulkActions 非空才设。
if (!bulkActions.isEmpty()) {
crudSchema.put("bulkActions", bulkActions);
}
// WS-B(最后一环):删除/业务动作按钮已全部改挂 headerToolbar(补 id 供脚本 enabled/disabled
// 联动 + ${selectedItems|pick:<PK>|join:','} 读选中行主键),不再用 bulkActions 槽。
crudSchema.put("primaryField", table + "_ID");
return page(title, crudSchema);
@@ -454,9 +450,10 @@ public class TemplateToAmisConverter {
}
private List<Object> buildToolbar(List<Element> buttons, String table, String entityId,
List<Map<String, Object>> bulkActions, ConversionResult result) {
ConversionResult result) {
// WS-B(最后一环):删除/业务动作按钮全部改挂 headerToolbar(补 id 供脚本联动 + selectedItems
// 表达式读选中行),不再用 bulkActions 槽(其按钮无 id 致脚本指令静默 no-op + 选中自动全亮)。
List<Object> toolbar = new ArrayList<>();
toolbar.add("bulkActions");
for (Element b : buttons) {
if ("false".equals(b.attributeValue("isshow"))) {
continue;
@@ -489,46 +486,49 @@ public class TemplateToAmisConverter {
.map(m -> m.attributeValue("servicename", ""))
.filter(s -> !s.isBlank())
.findFirst().orElse("");
// WS-B(最后一环):选中行主键表达式(headerToolbar 作用域可读,见 selectedIdsExpr)。
String pkCol = table + "_ID";
String idsExpr = selectedIdsExpr(pkCol);
if (isTrueDeleteButton(btnName)) {
// 真删除按钮:入 bulkActions(amis 批量操作槽,自动注入 ${ids}=选中行主键逗号串)。
// WS-B M2 note:bulkActions 槽内按钮不设 amis id,故 enableButton("删除",…) 的
// enabled/disabled 指令(componentId=按钮名)无法定位 bulkActions 删除按钮——但实测
// 删除按钮极少被 onselectedscript 联动启停(联动几乎都针对 headerToolbar 业务按钮),
// 暂不强制补 id(amis bulkActions 对自定义 id 的启停支持亦不稳)。
Map<String, Object> del = new LinkedHashMap<>();
del.put("type", "button");
del.put("label", btnName);
del.put("level", "danger");
del.put("actionType", "ajax");
del.put("confirmText", UiTypeMapper.firstNonBlank(b.attributeValue("showmsg"), "确认删除选中记录?"));
// 真删除按钮:改挂 headerToolbar(补 id 供脚本 enabled/disabled 定位),
// 点击仍 ajax POST 删除接口、引用选中行主键串。删除是「选中即可」语义
// (非按 STATUS 联动),故 baseline 用 disabledOn 跟随选中态(无选中→灰)。
btn.put("level", "danger");
btn.put("actionType", "ajax");
btn.put("disabledOn", "${!selectedItems || selectedItems.length === 0}");
btn.put("confirmText", UiTypeMapper.firstNonBlank(b.attributeValue("showmsg"), "确认删除选中记录?"));
// 优先走服务流,无 servicename 保底走实体删除接口
String delApi = delSvc.isBlank()
? "POST:/api/entity/" + table + "/delete"
: "POST:/api/flow/" + delSvc;
del.put("api", delApi);
del.put("data", new LinkedHashMap<>(Map.of("ids", "${ids}")));
bulkActions.add(del);
result.note("button[delete] " + btnName + " → bulkActions ajax " + delApi + "(ids=${ids})");
String delUrl = delSvc.isBlank()
? "/api/entity/" + table + "/delete"
: "/api/flow/" + delSvc;
btn.put("api", ajaxPostApi(delUrl, pkCol));
result.note("button[delete] " + btnName + " → headerToolbar ajax POST " + delUrl
+ "(id=" + btnName + ",ids=" + idsExpr + ",disabledOn=选中态)");
toolbar.add(btn);
} else if (!delSvc.isBlank()) {
// 业务型 type=delete 有服务流(提交审批/文件归档等):入 bulkActions。
// 业务型 type=delete 有服务流(发布/显示/隐藏/置顶/文件归档/取消置顶/提交审批等):
// 改挂 headerToolbar(补 id=中文名 供 onselectedscript 脚本 enabled/disabled 按
// componentId 精准联动启停),点击 ajax POST /api/flow/{svc} 引用选中行主键串。
//
// 关键作用域修复(amis 6.13 实证 CRUD.handleBulkAction):${ids}=选中行主键
// 逗号串仅在 bulkActions 路径由 amis 注入数据域;headerToolbar 按钮不经该路径,
// ${ids} 取不到 → POST body 空 → SUBMIT 报「该通知已被删除」。
// 故移入 bulkActions(与删除按钮同槽),data:{ids:${ids}} 才能读到选中行。
Map<String, Object> bulkBtn = new LinkedHashMap<>();
bulkBtn.put("type", "button");
bulkBtn.put("label", btnName);
// 作用域实证(amis 6.13 抓包,spike 2026-06-14):${ids} 仅 bulkActions 路径注入、
// headerToolbar 取不到;改用 ${selectedItems|pick:<PK>|join:','}(selectedIdsExpr)
// 在 headerToolbar 作用域可读,抓包返真实逗号串。bulkActions 按钮无 id 无法被脚本
// 定位(旧实现致脚本指令静默 no-op + 满屏自动点亮),故迁出 bulkActions。
//
// baseline:业务按钮默认 disabled(贴老 Vaadin「按钮先禁用、脚本据 STATUS 点亮」语义,
// 见 rewritten/ddb75614 seq1:status==3 仅 enableButton(...,true) 不复位)。脚本
// enabled 指令(statusStore.setDisable)覆盖 baseline——spike 实证 enabled 胜 baseline、
// 无冲突;取消选中时脚本 else 分支置灰。
btn.put("actionType", "ajax");
btn.put("disabled", true);
String confirmMsg = UiTypeMapper.firstNonBlank(b.attributeValue("showmsg"), "");
if (!confirmMsg.isBlank()) {
bulkBtn.put("confirmText", confirmMsg);
btn.put("confirmText", confirmMsg);
}
bulkBtn.put("actionType", "ajax");
bulkBtn.put("api", "POST:/api/flow/" + delSvc);
bulkBtn.put("data", new LinkedHashMap<>(Map.of("ids", "${ids}")));
bulkActions.add(bulkBtn);
result.note("button[delete/flow] " + btnName + " → bulkActions ajax POST /api/flow/" + delSvc + "(ids=${ids})");
continue;
btn.put("api", ajaxPostApi("/api/flow/" + delSvc, pkCol));
result.note("button[delete/flow] " + btnName + " → headerToolbar ajax POST /api/flow/" + delSvc
+ "(id=" + btnName + ",ids=" + idsExpr + ",baseline disabled,脚本据 STATUS 点亮)");
toolbar.add(btn);
} else {
// 无服务流 + 非删除名:安全禁用,等待后续服务流接入
btn.put("disabled", true);
@@ -1192,6 +1192,65 @@ public class TemplateToAmisConverter {
|| n.equals("删除记录") || n.equals("删除选中");
}
/**
* WS-B(最后一环):headerToolbar 业务动作按钮读取「选中行主键逗号串」的 amis 表达式。
*
* <p>实证(amis 6.13 真实渲染 + 抓包,spike 2026-06-14):
* <ul>
* <li>{@code ${ids}} 仅在 <b>bulkActions</b> 路径由 CRUD.handleBulkAction 注入数据域,
* headerToolbar 按钮取不到(POST 出 {@code ids:""});</li>
* <li>但 {@code ${selectedItems}} 数组本身在 headerToolbar 数据域<b>可见</b>(amis 官方
* crud 文档 selectable 示例同源),故用 {@code pick:<PK列>|join:','} 取主键串
* —— 抓包实证返真实逗号串(如 {@code 8cfccab2…,5fd57431…})。</li>
* </ul>
* 把业务按钮从 bulkActions 改挂 headerToolbar(补 id 供脚本 enabled/disabled 定位)后,
* 用此表达式让「点击 → POST /api/flow/{svc}」仍带选中行主键。
*
* @param pkCol 主键列名(= {@code table + "_ID"} = crud.primaryField)
*/
private static String selectedIdsExpr(String pkCol) {
return "${selectedItems|pick:" + pkCol + "|join:','}";
}
/** 选中行(单选)的主键表达式:{@code ${selectedItems[0].<PK>}}(业务流读 map[PK] 用)。 */
private static String selectedSingleIdExpr(String pkCol) {
return "${selectedItems.0." + pkCol + "}";
}
/**
* WS-B(最后一环):构造 amis ajax 按钮的 <b>对象式 api</b>(含 {@code method/url/data})。
*
* <p><b>① api 形态(对象式 vs 字符串式)</b>:实证(amis 6.13 抓包,radio 单选 crud,spike
* 2026-06-14):按钮用字符串式 api({@code "POST:/api/flow/X"})+ 同级 {@code data} 时,amis 把
* 同级 data 当按钮局部数据域、而非请求体 → POST 实际只带 crud 查询参数 {@code {page:1}},选中行
* 丢失。改用对象式 api 把 data 内嵌进 api → 抓包实证请求体正确携带选中行。
*
* <p><b>② data 键(兼容两族服务流契约)</b>:实证两类 sys_serviceflow input 契约:
* <ul>
* <li><b>删除族</b>(OA_*_DELETE):input 直接声明 {@code <field name="<PK>" required>}
* → FlowController 命中 {@code missingRequiredIdInput} 后按 {@code ids} 逗号串拆分逐 id 跑流;</li>
* <li><b>业务动作族</b>(PUBLISH/ISSHOW/HIDE/ISTOP/...):input 只声明 {@code map},脚本里
* {@code map.put("ISSHOW",1)} 后 {@code pojoCRUDService.update(map,...)} 按 {@code map[<PK>]}
* 定位行 → 须把选中行主键放在 <b>{@code map[<PK>]}</b>(放 {@code ids} 不识别 → status:0
* 但 result:null 空转,实证)。</li>
* </ul>
* 故 data 同时带 {@code ids}(逗号串,删除族 fanout 用)+ {@code <PK>}(单选主键,业务族 map[PK] 用),
* 一份 schema 覆盖两族;单选 radio 下二者指向同一行,多选时删除族走 ids fanout。
*
* @param url 请求路径(如 {@code /api/flow/OA_NEWSMANAGE_PUBLISH})
* @param pkCol 主键列名(= {@code table + "_ID"})
*/
private static Map<String, Object> ajaxPostApi(String url, String pkCol) {
Map<String, Object> data = new LinkedHashMap<>();
data.put("ids", selectedIdsExpr(pkCol)); // 删除族:FlowController 按逗号串拆分 fanout
data.put(pkCol, selectedSingleIdExpr(pkCol)); // 业务族:脚本 map[<PK>] 定位选中行
Map<String, Object> api = new LinkedHashMap<>();
api.put("method", "post");
api.put("url", url);
api.put("data", data);
return api;
}
// ──────────────────────────────────────────────────────────────────────
// tree(树 / 树+grid)
// ──────────────────────────────────────────────────────────────────────
@@ -1312,16 +1371,13 @@ public class TemplateToAmisConverter {
}
}
// 右表工具栏:复用普通列表的 collectButtons/buildToolbar(添加/修改/删除/查看 + EDITFORM
// 映射 + 删除走 bulkActions ${ids}),与 convertCrud 同源,treegrid 右表此前完全无按钮。
// 映射 + 删除/业务动作挂 headerToolbar 带选中行主键串),与 convertCrud 同源,
// treegrid 右表此前完全无按钮。
if (gridTableUpper != null && !gridTableUpper.isBlank()) {
List<Map<String, Object>> bulkActions = new ArrayList<>();
List<Object> toolbar = buildToolbar(collectButtons(gridRoot), gridTableUpper,
gridEntityId, bulkActions, result);
gridEntityId, result);
gridSchema.put("selectable", true);
gridSchema.put("headerToolbar", toolbar);
if (!bulkActions.isEmpty()) {
gridSchema.put("bulkActions", bulkActions);
}
gridSchema.put("primaryField", gridTableUpper + "_ID");
}
}
@@ -1894,7 +1950,15 @@ public class TemplateToAmisConverter {
Map<String, Object> onEvent = new LinkedHashMap<>();
if (!selectedActions.isEmpty()) {
onEvent.put(EVENT_SELECTED_CHANGE, Map.of("actions", selectedActions));
// WS-B(最后一环):每次行选中先「复位」——把所有 baseline 禁用的业务动作按钮 disabled,
// 再跑脚本据本行 STATUS enable 适用按钮。原因:迁移脚本(如 rewritten/ddb75614 seq1)对
// status==3 分支只 enableButton(...,true) 不复位对侧(贴老 Vaadin「选中即重置按钮态」生命周期),
// 不复位则切行残留上一行点亮态(如 ISSHOW=1 行点亮「隐藏」→切 ISSHOW=0 行「隐藏」仍亮)。
// 复位指令 = 对 headerToolbar 里 disabled:true 的业务按钮逐个 amis disabled(componentId=id)。
List<Object> resetActions = buildButtonResetActions(body);
List<Object> withReset = new ArrayList<>(resetActions);
withReset.addAll(selectedActions);
onEvent.put(EVENT_SELECTED_CHANGE, Map.of("actions", withReset));
}
if (!initedActions.isEmpty()) {
onEvent.put(EVENT_INITED, Map.of("actions", initedActions));
@@ -1905,6 +1969,38 @@ public class TemplateToAmisConverter {
return pageSchema;
}
/**
* WS-B(最后一环):构造行选中前的「按钮态复位」动作——对 headerToolbar 中 baseline {@code disabled:true}
* 的业务动作按钮逐个发 amis {@code disabled} 动作(componentId=按钮 id=中文名)。
*
* <p>挂在 selectedChange 脚本链最前,使每次选中从「全禁用」干净起点重算,由脚本据本行 STATUS
* enable 适用按钮,避免切行残留上一行的点亮态(迁移脚本只 enable 不 disable 对侧)。仅取 baseline
* 禁用的按钮(= 业务动作按钮);添加/修改/查看/删除(dialog 或 disabledOn 选中态)不在复位之列。
*/
@SuppressWarnings("unchecked")
private List<Object> buildButtonResetActions(Map<String, Object> body) {
List<Object> reset = new ArrayList<>();
Object tbObj = body.get("headerToolbar");
if (!(tbObj instanceof List)) {
return reset;
}
for (Object item : (List<Object>) tbObj) {
if (!(item instanceof Map)) {
continue;
}
Map<String, Object> btn = (Map<String, Object>) item;
Object id = btn.get("id");
// 仅复位 baseline disabled=true 的业务按钮(脚本据 STATUS 点亮的那批)
if (Boolean.TRUE.equals(btn.get("disabled")) && id instanceof String && !((String) id).isBlank()) {
Map<String, Object> dis = new LinkedHashMap<>();
dis.put("actionType", "disabled");
dis.put("componentId", id);
reset.add(dis);
}
}
return reset;
}
/** 单段脚本的动作链:ajax 调执行端点 → 自定义动作重放返回的指令数组(item 默认全量数据域 {@code ${&}})。 */
private List<Object> scriptActionChain(String templateId, int seq) {
return scriptActionChain(templateId, seq, "${&}");