fix(converter): WS-B B4 两 Critical——删除恢复 fanout(ids-only)+无脚本页业务按钮 disabledOn 解除永久灰

修 B4(8df37e9) code-review 两个 Critical:

C1 多选删除只删第一行(dual-key 抑制 fanout):
  B4 真删除按钮 data 同送 ids(逗号串)+PK(首行),但删除族流 <input> 声明
  <PK> required → FlowInputCoercer.missingRequiredIdInput 因 map.containsKey(PK)
  返 null → FlowController fanout 分支(291-318)被跳过 → 只对 selectedItems.0
  执行一次(确认文案却说删全部)。改:按分支拆 data——
    · 真删除按钮(ajaxPostDeleteApi):data 只送 {ids},恢复 fanout 批量删除;
    · 业务动作按钮(ajaxPostBusinessApi):data 只送 {<PK>}(业务流读 map[PK])。
  PK 表达式改 bracket 记法 ${selectedItems[0].<PK>}(与既有 ${selectedItems[0]}
  一致,非 dot-zero);纠正 B4 javadoc(写 bracket 实际 emit dot)。

C2 无脚本页业务按钮永久置灰(55 模板,含「提交审批」):
  buildToolbar 给业务按钮无条件 baseline disabled:true,靠 onselectedscript
  脚本点亮;但 DB 实测 55 个 crud 模板有 disabled:true 业务按钮却无 onEvent
  → 永久灰、点不动。新增 demoteUnscriptedBusinessButtons:仅当页面无
  onEvent.selectedChange(无脚本控启停)时,把带 /api/flow/ 的 baseline disabled
  业务按钮降级为 disabledOn:"${!selectedItems...}"(选中即可用,贴老 bulkActions
  选中态语义);有脚本控则 no-op(保持 disabled:true 由脚本点亮)。调用点:
  attachScriptOnEvent 内(仅 onload 无 onselected 时)+ BatchConvertCli 对
  bindings.isEmpty() 的无绑定页兜底(attachScriptOnEvent 不被调用)。

测试(TDD):
  · TemplateToAmisConverterTest +5:删除 data 只含 ids、业务 data 只含 PK(bracket)、
    有脚本页保持 disabled:true、仅 onload 降级 disabledOn、无脚本页 demote 降级、
    有脚本控 demote no-op;改写 2 个 B4 既有用例至 C1 拆分契约。converter 107 绿。
  · FlowControllerTest +1(17d):body 只送 ids="a,b,c"(不含 PK) → 删除族(PK required)
    fanout 执行 3 次,锁住「ids-only→fanout」。metadata 60 绿(未改 metadata 生产代码)。

重转+入库(eip4dev):crud 956/956、[WS-B]对齐告警 0,SchemaImportCli upsert 782。
DB 复核:C2 victims 55→0。

浏览器端到端实证(8093 live + 5173,admin/111111):
  · C1 fanout:POST /api/flow/OA_NEWSMANAGE_DELETE {ids:"3 主键"} → count:3、
    3 行真删除(DB count 3→0),证明 fanout 恢复(API 实证,避免破坏真实数据)。
  · C2:8093 实服 schema 中 PM_REWARDSANDPUNISHMENTS「提交审批」按钮已为
    disabledOn(非 disabled:true)、data=PK-only;删除按钮 data=ids-only。
  · 新闻不退化:ddb75614 选中可见行→隐藏/置顶/删除点亮、发布灰(B4 行为保持)。
  · console 0 ajax 报错。

边角现状:少数「页面有 onselectedscript 但某业务按钮未被脚本 enableButton 引用」
仍可能永久灰——属脚本覆盖问题,本次未处理(demote 仅作用于 no-script 页,
有 selectedChange 页保守 no-op,避免覆盖脚本控语义)。

base=8df37e9

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-14 17:25:28 +08:00
parent 8df37e99f7
commit 1108fbd961
4 changed files with 329 additions and 35 deletions

View File

@@ -266,6 +266,12 @@ public final class BatchConvertCli {
}
}
// C2:无 onselectedscript(脚本控启停)的 crud 页——含完全无绑定的页(attachScriptOnEvent
// 不会被调用)——把 headerToolbar 里 baseline disabled:true 的业务按钮降级为 disabledOn
// (选中即可用),否则永久置灰、点不动(DB 实测 55 模板,含「提交审批」)。idempotent:
// 已挂 selectedChange(脚本控)的页 no-op。放在校验前,让降级后的 schema 入闸/落盘。
converter.demoteUnscriptedBusinessButtons(result.getSchema());
List<String> errors = gate.validate(result.getSchema());
gate1 = errors.isEmpty();
if (!gate1) {

View File

@@ -501,9 +501,10 @@ public class TemplateToAmisConverter {
String delUrl = delSvc.isBlank()
? "/api/entity/" + table + "/delete"
: "/api/flow/" + delSvc;
btn.put("api", ajaxPostApi(delUrl, pkCol));
// C1:删除 data 只送 ids(恢复 fanout 批量删除),绝不送 PK(送 PK 抑制 fanout→只删首行)。
btn.put("api", ajaxPostDeleteApi(delUrl, pkCol));
result.note("button[delete] " + btnName + " → headerToolbar ajax POST " + delUrl
+ "(id=" + btnName + ",ids=" + idsExpr + ",disabledOn=选中态)");
+ "(id=" + btnName + ",ids-only=" + idsExpr + " 走 fanout,disabledOn=选中态)");
toolbar.add(btn);
} else if (!delSvc.isBlank()) {
// 业务型 type=delete 有服务流(发布/显示/隐藏/置顶/文件归档/取消置顶/提交审批等):
@@ -525,9 +526,11 @@ public class TemplateToAmisConverter {
if (!confirmMsg.isBlank()) {
btn.put("confirmText", confirmMsg);
}
btn.put("api", ajaxPostApi("/api/flow/" + delSvc, pkCol));
// C1:业务 data 只送 PK(bracket 单选主键),不送 ids(业务流读 map[PK],送 ids 不识别)。
btn.put("api", ajaxPostBusinessApi("/api/flow/" + delSvc, pkCol));
result.note("button[delete/flow] " + btnName + " → headerToolbar ajax POST /api/flow/" + delSvc
+ "(id=" + btnName + ",ids=" + idsExpr + ",baseline disabled,脚本据 STATUS 点亮)");
+ "(id=" + btnName + ",PK-only=" + selectedSingleIdExpr(pkCol)
+ ",baseline disabled,脚本据 STATUS 点亮)");
toolbar.add(btn);
} else {
// 无服务流 + 非删除名:安全禁用,等待后续服务流接入
@@ -1212,38 +1215,28 @@ public class TemplateToAmisConverter {
return "${selectedItems|pick:" + pkCol + "|join:','}";
}
/** 选中行(单选)的主键表达式:{@code ${selectedItems[0].<PK>}}(业务流读 map[PK] 用)。 */
/**
* 选中行(单选)的主键表达式:{@code ${selectedItems[0].<PK>}}(业务流读 map[PK] 用)。
*
* <p>用 <b>bracket 记法</b> {@code selectedItems[0]}(与本类既有 {@code ${selectedItems[0]}}
* 一致,见 dialog data 注入),非 dot-zero {@code selectedItems.0}——后者在 amis 数据域取值不稳。
*/
private static String selectedSingleIdExpr(String pkCol) {
return "${selectedItems.0." + 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
* <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"})
* @param url 请求路径(如 {@code /api/flow/OA_NEWSMANAGE_PUBLISH})
* @param data 请求体表达式键值(按调用族不同:删除族只送 ids、业务族只送 PK,见下两个构造器)
*/
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>] 定位选中行
private static Map<String, Object> ajaxPostApi(String url, Map<String, Object> data) {
Map<String, Object> api = new LinkedHashMap<>();
api.put("method", "post");
api.put("url", url);
@@ -1251,6 +1244,43 @@ public class TemplateToAmisConverter {
return api;
}
/**
* C1:<b>真删除按钮</b>的对象式 api——data <b>只送 {@code ids}</b>(选中行主键逗号串),<b>绝不送 PK</b>。
*
* <p>删除族 sys_serviceflow {@code <input>} 直接声明 {@code <field name="<PK>" required>}。
* FlowController 仅当 map <b>不含</b>该 PK 键时({@code missingRequiredIdInput} 返非空)才走
* {@code ids} 逗号串拆分的 <b>fanout 批量删除</b>(FlowController.java:291-318)。
* 若 data 同时塞了 PK(B4 旧实现),{@code map.containsKey(field)} 为真
* → {@code missingRequiredIdInput} 返 null → fanout 分支被跳过 → <b>多选只删第一行</b>(C1 回归)。
* 故删除按钮 data 必须只含 ids。
*
* @param url 删除接口路径(服务流 {@code /api/flow/<svc>} 或实体 {@code /api/entity/<table>/delete})
* @param pkCol 主键列名(= {@code table + "_ID"} = crud.primaryField),用于 ids 表达式 pick 列
*/
private static Map<String, Object> ajaxPostDeleteApi(String url, String pkCol) {
Map<String, Object> data = new LinkedHashMap<>();
data.put("ids", selectedIdsExpr(pkCol)); // 删除族:FlowController 按逗号串拆分 fanout(不可加 PK)
return ajaxPostApi(url, data);
}
/**
* C1:<b>业务动作按钮</b>(发布/显示/隐藏/置顶/文件归档/取消置顶/提交审批等带 servicename 的非删除)的
* 对象式 api——data <b>只送 {@code <PK>}</b>(单选主键,bracket 记法),<b>不送 {@code ids}</b>。
*
* <p>业务动作族 {@code <input>} 只声明 {@code map},脚本里 {@code map.put("ISSHOW",1)} 后
* {@code pojoCRUDService.update(map,...)} 按 {@code map[<PK>]} 定位行。把选中行主键放在 {@code map[<PK>]}
* (实证:放 {@code ids} 业务流不识别 → status:0 但 result:null 空转)。不送 ids 还避免与删除族混淆
* (业务流不是删除族,不应触发 ids fanout 语义)。
*
* @param url 服务流路径(如 {@code /api/flow/OA_NEWSMANAGE_PUBLISH})
* @param pkCol 主键列名(= {@code table + "_ID"})
*/
private static Map<String, Object> ajaxPostBusinessApi(String url, String pkCol) {
Map<String, Object> data = new LinkedHashMap<>();
data.put(pkCol, selectedSingleIdExpr(pkCol)); // 业务族:脚本 map[<PK>] 定位选中行(bracket 单选)
return ajaxPostApi(url, data);
}
// ──────────────────────────────────────────────────────────────────────
// tree(树 / 树+grid)
// ──────────────────────────────────────────────────────────────────────
@@ -1966,9 +1996,92 @@ public class TemplateToAmisConverter {
if (!onEvent.isEmpty()) {
body.put("onEvent", onEvent);
}
// C2:本页若无 onselectedscript(脚本控启停)——例如只挂 onloadscript——则 headerToolbar 里
// baseline disabled:true 的业务按钮没有任何「点亮」指令 → 永久置灰。把它们降级为 disabledOn
// (选中即可用,贴老 bulkActions 选中态语义)。有 onselected 时保持 disabled:true + 脚本控 + reset。
if (selectedActions.isEmpty()) {
demoteUnscriptedBusinessButtons(pageSchema);
}
return pageSchema;
}
/**
* C2:把 headerToolbar 中<b>永久置灰</b>的业务动作按钮(baseline {@code disabled:true} 但无脚本启停)
* 降级为 {@code disabledOn:"${!selectedItems || selectedItems.length === 0}"}(选中即可用)。
*
* <p>背景:{@code buildToolbar} 给业务按钮的 baseline 是 {@code disabled:true},依赖 onselectedscript
* 脚本的 enabled 指令点亮。但 DB 实测 <b>55 个 crud 模板</b>有 disabled:true 业务按钮却<b>无 onEvent</b>
* (如 PM_WEEKPLAN/HR_PROJECTREVIEW 的「提交审批」)→ 永久灰、点不动。
*
* <p>本方法是无脚本页的兜底:仅当页面<b>无 {@code onEvent.selectedChange}</b>(= 无脚本控启停)时,
* 把 headerToolbar 里 {@code disabled:true} 且为业务动作(带 {@code /api/flow/} api、非 danger 删除)的
* 按钮改成 {@code disabledOn} 跟随选中态。有 selectedChange(脚本控)时 <b>no-op</b>(保持 disabled:true)。
*
* <p>调用点:①{@link #attachScriptOnEvent} 内(页面只挂 onload、无 onselected 时);
* ②{@code BatchConvertCli} 对 {@code bindings.isEmpty()} 的无绑定页兜底(attachScriptOnEvent 不被调用)。
*
* @param pageSchema 顶层 page schema(body=crud)
* @return 同一引用(便于链式)
*/
@SuppressWarnings("unchecked")
public Map<String, Object> demoteUnscriptedBusinessButtons(Map<String, Object> pageSchema) {
if (pageSchema == null) {
return pageSchema;
}
Object bodyObj = pageSchema.get("body");
if (!(bodyObj instanceof Map)) {
return pageSchema;
}
Map<String, Object> body = (Map<String, Object>) bodyObj;
// 有脚本控启停(selectedChange)→ no-op:业务按钮由脚本据 STATUS 点亮,保持 disabled:true。
Object onEvent = body.get("onEvent");
if (onEvent instanceof Map && ((Map<String, Object>) onEvent).containsKey(EVENT_SELECTED_CHANGE)) {
return pageSchema;
}
Object tbObj = body.get("headerToolbar");
if (!(tbObj instanceof List)) {
return pageSchema;
}
for (Object item : (List<Object>) tbObj) {
if (!(item instanceof Map)) {
continue;
}
Map<String, Object> btn = (Map<String, Object>) item;
if (isBaselineDisabledBusinessButton(btn)) {
// 永久灰 → 选中即可用:去掉 baseline disabled,挂 disabledOn 跟随选中态。
btn.remove("disabled");
btn.put("disabledOn", DISABLED_ON_NO_SELECTION);
}
}
return pageSchema;
}
/** disabledOn 表达式:无选中行则禁用(贴老 bulkActions 选中态语义)。 */
static final String DISABLED_ON_NO_SELECTION = "${!selectedItems || selectedItems.length === 0}";
/**
* 判定某 headerToolbar 按钮是否为「baseline 永久禁用的业务动作按钮」:
* {@code disabled==true} + 带 {@code /api/flow/} 对象式 api + 非 danger(删除用 disabledOn 非 baseline disabled)。
*/
@SuppressWarnings("unchecked")
private static boolean isBaselineDisabledBusinessButton(Map<String, Object> btn) {
if (!Boolean.TRUE.equals(btn.get("disabled"))) {
return false;
}
if ("danger".equals(btn.get("level"))) {
return false; // 真删除按钮(danger)走 disabledOn,不会是 baseline disabled,稳妥再排除
}
Object api = btn.get("api");
String url = null;
if (api instanceof Map) {
Object u = ((Map<String, Object>) api).get("url");
url = (u instanceof String) ? (String) u : null;
} else if (api instanceof String) {
url = (String) api;
}
return url != null && url.contains("/api/flow/");
}
/**
* WS-B(最后一环):构造行选中前的「按钮态复位」动作——对 headerToolbar 中 baseline {@code disabled:true}
* 的业务动作按钮逐个发 amis {@code disabled} 动作(componentId=按钮 id=中文名)。