fix(converter): per-button 降级——脚本未引用的业务按钮不再永久灰(提交审批)

WS-B 给业务按钮 baseline disabled:true,靠 onselectedscript 脚本 enableButton("X")
点亮。但某些业务按钮从不被脚本引用(如新闻 ddb75614「提交审批」脚本只点亮发布/显示/
隐藏/置顶/取消置顶/文件归档,从无 enableButton(提交审批)) → 永久置灰、点不动。WS-B 的
demoteUnscriptedBusinessButtons 只兜底「整页无 onselected」的页,漏了「页有脚本但某按钮
未被脚本引用」。

修(per-button):
- TemplateToAmisConverter.parseEnableButtonTargets:从脚本文本抽 enableButton 目标按钮名集。
- attachScriptOnEvent 6 参重载 + demoteButtonsNotEnabledByScript:对有 onselected 的页,
  不在脚本 enableButton 目标集的 baseline 禁用业务按钮降级 disabledOn(选中即可点),在集合
  内的保持 disabled:true(脚本控)。降级在 buildButtonResetActions 之前,故 selectedChange
  复位链只含脚本控按钮,不复位已降级按钮。
- BatchConvertCli.enableButtonTargets/readScriptText:读 onselected 绑定的盘上 rewritten
  脚本正文解析目标集传入;5 参旧重载传 null=未知(不降级,保留整页脚本控口径,单测兼容)。

测试:TemplateToAmisConverterTest +6、BatchConvertCliTest +3(parseEnableButtonTargets、
per-button 降级、reset 仅含脚本控、未知集不降级、空集全降级、readScriptText、enableButtonTargets)。
全量重转对齐告警 0;浏览器实证:选中新闻行→提交审批点亮可点、POST /api/flow/OA_NEWSMANAGE_SUBMIT
返 status:0;发布/取消置顶仍按 STATUS 联动不退化。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-14 19:10:31 +08:00
parent 5d12613034
commit dc4c07ecf4
4 changed files with 352 additions and 2 deletions

View File

@@ -190,6 +190,64 @@ public final class BatchConvertCli {
return seqs;
}
/**
* 小修#1:解析某模板 onselected 绑定脚本里 {@code enableButton("X")} 的目标按钮名并集。
*
* <p>对每个 {@code onselectedscript} 绑定,经 {@code keyToSeq} 解析其 seq,仅当 seq 在盘上
* ({@code seqsOnDisk})时读 {@code rewritten/<id>/<seq>.*.groovy} 正文,用
* {@link TemplateToAmisConverter#parseEnableButtonTargets} 抽目标按钮名,跨绑定取并集。
* 无 rewriterDir / 无可读脚本 → 空集(attachScriptOnEvent 收空集 → 该页所有业务按钮全降级
* disabledOn,等价老系统「选中即可点」,安全且不退化)。
*/
static java.util.Set<String> enableButtonTargets(
Path rewriterDir, String templateId,
List<TemplateToAmisConverter.EventBinding> bindings,
Map<String, Integer> keyToSeq, java.util.Set<Integer> seqsOnDisk) {
java.util.Set<String> targets = new java.util.LinkedHashSet<>();
if (rewriterDir == null || bindings == null) {
return targets;
}
for (TemplateToAmisConverter.EventBinding b : bindings) {
if (!TemplateToAmisConverter.ATTR_ON_SELECTED.equals(b.eventType)) {
continue; // 仅 onselected 脚本控按钮启停;onload(只读联动)不参与按钮点亮判定
}
Integer seq = keyToSeq == null ? null : keyToSeq.get(b.scriptKey);
if (seq == null || (seqsOnDisk != null && !seqsOnDisk.contains(seq))) {
continue; // 缺 seq / 盘上无文件 → 该绑定不挂(fail-closed),亦不贡献目标
}
String text = readScriptText(rewriterDir, templateId, seq);
if (text != null) {
targets.addAll(TemplateToAmisConverter.parseEnableButtonTargets(text));
}
}
return targets;
}
/** 读 {@code rewritten/<templateId>/<seq>.*.groovy} 正文(与 existingSeqs 同目录约定);缺失/读失败返 null。 */
static String readScriptText(Path rewriterDir, String templateId, int seq) {
if (rewriterDir == null || templateId == null) {
return null;
}
Path dir = rewriterDir.resolve("rewritten").resolve(templateId);
if (!Files.isDirectory(dir)) {
dir = rewriterDir.resolve(templateId); // 兼容传入已是 rewritten 根
}
if (!Files.isDirectory(dir)) {
return null;
}
try (java.util.stream.Stream<Path> files = Files.list(dir)) {
Path match = files
.filter(p -> {
String n = p.getFileName().toString();
return n.startsWith(seq + ".") && n.endsWith(".groovy");
})
.findFirst().orElse(null);
return match == null ? null : Files.readString(match, StandardCharsets.UTF_8);
} catch (IOException e) {
return null;
}
}
static BatchSummary run(Connection conn, Path outDir) throws IOException, SQLException {
return run(conn, outDir, null);
}
@@ -256,8 +314,14 @@ public final class BatchConvertCli {
List<TemplateToAmisConverter.EventBinding> bindings = parseEventBindings(xml);
if (!bindings.isEmpty()) {
Map<String, Integer> keyToSeq = parseKeyToSeq(xml);
// 小修#1:解析 onselected 绑定脚本(盘上 rewritten/<id>/<seq>.*.groovy)正文里的
// enableButton 目标按钮名集合 —— 据此对「脚本永不引用」的业务按钮 per-button 降级
// disabledOn(如新闻「提交审批」从无 enableButton(提交审批) → 选中即可点,免永久灰)。
java.util.Set<String> scriptEnabledButtons =
enableButtonTargets(rewriterDir, id, bindings, keyToSeq, seqsOnDisk);
// C1-a:只在盘上确有 rewritten/<id>/<seq>.*.groovy 时才挂该绑定(fail-closed)。
converter.attachScriptOnEvent(result.getSchema(), id, bindings, keyToSeq, seqsOnDisk::contains);
converter.attachScriptOnEvent(result.getSchema(), id, bindings, keyToSeq,
seqsOnDisk::contains, scriptEnabledButtons);
Object body = result.getSchema().get("body");
if (body instanceof Map && ((Map<?, ?>) body).containsKey("onEvent")) {
onEventAttached = true;

View File

@@ -2019,10 +2019,39 @@ public class TemplateToAmisConverter {
*
* @param seqExists seq→是否存在对应落盘脚本文件的判定(BatchConvertCli 由 {@code rewriterDir} 注入)
*/
@SuppressWarnings("unchecked")
public Map<String, Object> attachScriptOnEvent(Map<String, Object> pageSchema, String templateId,
List<EventBinding> bindings, Map<String, Integer> keyToSeq,
Predicate<Integer> seqExists) {
// scriptEnabledButtons=null → 「未知脚本 enableButton 目标集」:保留 WS-B 既有整页口径
// (有 onselected 的业务按钮全部 disabled:true 脚本控)。converter 单测走此路径。
return attachScriptOnEvent(pageSchema, templateId, bindings, keyToSeq, seqExists, null);
}
/**
* {@link #attachScriptOnEvent(Map, String, List, Map, Predicate)} 的 per-button 降级感知重载(小修#1,C2 收尾)。
*
* <p><b>问题</b>:WS-B 给业务按钮的 baseline 是 {@code disabled:true},靠 onselectedscript 脚本的
* {@code enableButton("X")} 点亮。但<b>某些业务按钮从不被脚本引用</b>(如新闻 ddb75614 的「提交审批」——
* 脚本 seq1 只 enableButton 发布/显示/隐藏/文件归档/置顶/取消置顶,从无 enableButton(提交审批))→ 该按钮
* 永久置灰、点不动(老系统默认可点)。WS-B 的 {@link #demoteUnscriptedBusinessButtons} 只兜底「整页无
* onselected」的页,未覆盖「页有脚本但某按钮未被脚本引用」。
*
* <p><b>修</b>:对有 onselected 的页,按脚本 {@code enableButton} 目标集 {@code scriptEnabledButtons}
* <b>逐按钮</b>分流——
* <ul>
* <li><b>不在集合内</b>的业务按钮:脚本永不点亮它 → 降级 {@code disabledOn}(选中即可点,贴老系统);
* 且不进 selectedChange 复位链(已非 baseline disabled)。</li>
* <li><b>在集合内</b>的业务按钮:保持 {@code disabled:true} + 脚本控 + selectedChange 复位(reset)。</li>
* </ul>
* {@code scriptEnabledButtons==null}(未知,如单测/未传集合)→ 不做 per-button 降级,回退整页脚本控口径。
*
* @param scriptEnabledButtons onselected 绑定脚本里 {@code enableButton("X")} 的目标按钮名集合
* (BatchConvertCli 由盘上 rewritten 脚本文本解析注入);null=未知(不降级)
*/
@SuppressWarnings("unchecked")
public Map<String, Object> attachScriptOnEvent(Map<String, Object> pageSchema, String templateId,
List<EventBinding> bindings, Map<String, Integer> keyToSeq,
Predicate<Integer> seqExists, Set<String> scriptEnabledButtons) {
if (pageSchema == null || templateId == null || templateId.isBlank()
|| bindings == null || bindings.isEmpty() || keyToSeq == null) {
return pageSchema;
@@ -2053,6 +2082,11 @@ public class TemplateToAmisConverter {
Map<String, Object> onEvent = new LinkedHashMap<>();
if (!selectedActions.isEmpty()) {
// 小修#1:先按脚本 enableButton 目标集对「脚本永不引用」的业务按钮降级 disabledOn(选中即可点),
// 留下「脚本控」按钮仍 baseline disabled:true。必须在 buildButtonResetActions 之前——降级后
// 复位链只对剩余 disabled:true(脚本控)按钮发 disabled,不复位已改 disabledOn 的按钮。
demoteButtonsNotEnabledByScript(body, scriptEnabledButtons);
// WS-B(最后一环):每次行选中先「复位」——把所有 baseline 禁用的业务动作按钮 disabled,
// 再跑脚本据本行 STATUS enable 适用按钮。原因:迁移脚本(如 rewritten/ddb75614 seq1)对
// status==3 分支只 enableButton(...,true) 不复位对侧(贴老 Vaadin「选中即重置按钮态」生命周期),
@@ -2078,6 +2112,73 @@ public class TemplateToAmisConverter {
return pageSchema;
}
/**
* 小修#1:对有 onselected 脚本的页,把<b>脚本 enableButton 目标集未引用</b>的 baseline 禁用业务按钮
* 降级为 {@code disabledOn}(选中即可点)。在集合内的按钮(脚本据 STATUS 点亮)保持 {@code disabled:true}。
*
* <p>{@code scriptEnabledButtons==null}(未知,未传脚本文本解析结果)→ no-op:保留 WS-B 整页脚本控口径,
* 不动任何按钮(避免无依据降级;converter 单测走此路径)。
*
* @param body crud body(含 headerToolbar)
* @param scriptEnabledButtons 脚本 {@code enableButton("X")} 目标按钮名集合;null=未知(no-op)
*/
@SuppressWarnings("unchecked")
private void demoteButtonsNotEnabledByScript(Map<String, Object> body, Set<String> scriptEnabledButtons) {
if (scriptEnabledButtons == null) {
return; // 未知脚本目标集 → 不降级(保留整页脚本控口径)
}
Object tbObj = body.get("headerToolbar");
if (!(tbObj instanceof List)) {
return;
}
for (Object item : (List<Object>) tbObj) {
if (!(item instanceof Map)) {
continue;
}
Map<String, Object> btn = (Map<String, Object>) item;
if (!isBaselineDisabledBusinessButton(btn)) {
continue; // 仅处理 baseline disabled:true 的业务按钮(删除走 disabledOn、添加/修改 dialog 不在列)
}
Object id = btn.get("id");
String name = (id instanceof String) ? (String) id : null;
if (name != null && scriptEnabledButtons.contains(name)) {
continue; // 在脚本 enableButton 目标集内 → 脚本控,保持 disabled:true
}
// 脚本永不点亮该按钮(不在集合内)→ 选中即可点,免永久置灰(老系统默认可点)
btn.remove("disabled");
btn.put("disabledOn", DISABLED_ON_NO_SELECTION);
}
}
/**
* 小修#1:从脚本文本里提取所有 {@code enableButton("X")} / {@code enableButton('X')} 的目标按钮名集合。
*
* <p>容忍空白与单/双引号({@code enableButton ( "发布" , true )} 亦命中)。第二参(true/false 点亮/置灰)
* 不影响「该按钮被脚本引用」的判定——只要脚本对某按钮 {@code enableButton}(无论点亮还是置灰),它就是
* 「脚本控」按钮,保持 baseline disabled:true 由脚本管。返回的名集合用于 {@link #demoteButtonsNotEnabledByScript}。
*
* @param scriptText 改写后脚本正文(null/空 → 空集)
* @return enableButton 目标按钮名集合(去重,保插入序)
*/
public static Set<String> parseEnableButtonTargets(String scriptText) {
Set<String> targets = new LinkedHashSet<>();
if (scriptText == null || scriptText.isBlank()) {
return targets;
}
java.util.regex.Matcher m = ENABLE_BUTTON_TARGET.matcher(scriptText);
while (m.find()) {
String name = m.group(1) != null ? m.group(1) : m.group(2); // 双引号组 or 单引号组
if (name != null && !name.isBlank()) {
targets.add(name);
}
}
return targets;
}
/** {@code enableButton("名")} / {@code enableButton('名')} 第一参(按钮名)抽取,容忍空白。 */
private static final java.util.regex.Pattern ENABLE_BUTTON_TARGET = java.util.regex.Pattern.compile(
"enableButton\\s*\\(\\s*(?:\"([^\"]*)\"|'([^']*)')");
/**
* C2:把 headerToolbar 中<b>永久置灰</b>的业务动作按钮(baseline {@code disabled:true} 但无脚本启停)
* 降级为 {@code disabledOn:"${!selectedItems || selectedItems.length === 0}"}(选中即可用)。