Files
eip4-platform/docs/P1/F2-3脚本运行时报告.md
zhengwr 43fdfd1830 F2-3:运行时动词闭包子指令机制 + staging 晋级(FULL_AUTO 507/HARD 74)
ScriptFacade:addFieldButton 扩第3参闭包(onClick 子指令数组)+ showConfirm
新动词,服务端急切求值闭包,子指令收进子缓冲,输出嵌套指令 JSON。
前端 scriptCommands.ts/registerReplayAction.ts:处理 addButton onClick/
confirmDialog onOk 嵌套重放,onClickActions/onOkActions 透传给 amis。
ScriptFacadeTest 补 7 个正反例(24/24 全绿)。
staging 晋级:FULL_AUTO 507(+10)/HARD 74(-12)/自动化率 82.7%,
双库各更新 801 条,e2e 30/30 全绿。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 22:24:08 +08:00

6.8 KiB
Raw Blame History

F2-3 脚本运行时报告

生成时间:2026-06-11 作者:P4 脚本迁移线


一、F2-1b 默认导入补全

问题根因

视图脚本执行路径(ScriptExecuteController → com.dsasp.server.dataDic.binding.ScriptingEnginesManager)使用裸 GroovyScriptEngineFactory,缺少服务端默认导入注入,导致:

  • GetServicesFunction.loadPOJO(...) 报「No such property: GetServicesFunction」
  • new DateTime[2] 报「unable to resolve class DateTime」

服务流路径(com.dsasp.server.core.service.script.ScriptingEnginesManager)已正确使用 SecureGroovyScriptEngineFactory(含 DEFAULTIMPORTSLIST 8 条 + org.joda.time 星号导入)。

修法

com.dsasp.server.dataDic.binding.ScriptingEnginesManager 换用 SecureGroovyScriptEngineFactory。最小改动:删除 GroovyScriptEngineFactory 引入,添加 SecureGroovyScriptEngineFactory 引入,ArchUnit 保真层纪律不受影响。

默认导入串对照(SecureGroovyScriptEngineFactory.DEFAULTIMPORTSLIST)

类 来源 用途
com.dsasp.server.common.dataDic.bean.GeneralPOJO platform-legacy-core 数据实体
com.dsasp.server.common.dataDic.bean.CustomSearchConditional platform-legacy-core 查询条件
com.dsasp.server.common.dataDic.service.POJOCRUDService platform-legacy-core CRUD 服务
com.dsasp.server.common.util.StringUtil platform-legacy-core 字符串工具
com.dsasp.server.common.function.GetServicesFunction platform-legacy-core 服务调用函数库
com.dsasp.server.common.function.GetDefaultValueFunction platform-legacy-core 默认值函数库
com.dsasp.server.common.function.GetValueFunction platform-legacy-core 字段取值函数库
com.dsasp.client.viewframework.template.util.Console platform-legacy-core 脚本调试日志

星号导入:org.joda.time(DateTime/DateTimeFormatter 等,joda-time 2.12.7 已在 legacy-core pom)


二、F2-3 嵌套指令协议

规格

改写器(tools/s3_rewriter F2-3 规则族)产出两个新动词形态,服务端 ScriptFacade 急切求值闭包,收集子指令入子缓冲,输出含嵌套数组的指令 JSON。

addFieldButton 四参形态

脚本:

addFieldButton("FIELD", "文案", {
    // 闭包体动词
    setFieldVisible("X", true)
    showToast("完成")
}, 1)

服务端输出:

{
  "actionType": "addButton",
  "componentId": "FIELD",
  "args": {
    "label": "文案",
    "index": 1,
    "onClick": [
      { "actionType": "show", "componentId": "X" },
      { "actionType": "toast", "args": { "msgType": "info", "msg": "完成" } }
    ]
  }
}

showConfirm 形态

脚本:

showConfirm("确认操作?", {
    setFieldEnabled("BTN", false)
})

服务端输出:

{
  "actionType": "confirmDialog",
  "args": {
    "msg": "确认操作?",
    "onOk": [
      { "actionType": "disabled", "componentId": "BTN" }
    ]
  }
}

前端重放协议(registerReplayAction.ts)

  • addButton + onClick 数组:翻译子指令为 amis 动作数组,挂 args.onClickActions,透传给 amis addButton 动作;amis 侧按钮点击后 runActions 重放。
  • confirmDialog + onOk 数组:翻译子指令为 amis 动作数组,挂 args.onOkActions,透传给 amis confirmDialog 动作;用户确认后 runActions 重放。
  • 无嵌套数组的 addButton 走常规路径(向后兼容旧三参形态)。

三、staging 晋级前后分布

标签 晋级前(基线) 晋级后(staging) 变化
FULL_AUTO 497 507 +10
PARTIAL 30 32 +2
HARD 86 74 -12
NO_S3 815 815 0
自动化率 81.1% 82.7% +1.6pp
人工作业单 116 106 -10
templates_with_scripts 721 721 0

双库核数(load_page_schema.py):

  • eip4dev.eip3:更新 801 条,幂等跳过 688 条
  • eip4m0.public:更新 801 条,幂等跳过 688 条

BatchConvertCli:总量 1516,闸一通过 1489(98.2%),onEvent 钩子挂载 380 个模板


四、4 样本验证结果

样本 templateId seq 脚本标签 结果 分类
getConfigValue+page绑定 021e3ba7-e03a-412a-9f0e-c20ef440a885 2 NO_S3 page MissingProperty 预期:page 是 Vaadin 视图对象,服务端不绑定
GetServicesFunction.loadPOJO 0670aaf9-a045-450d-9ebc-06f3ac36ca19 1 NO_S3 PM_BIDRELATIONSHIP_ID MissingProperty 预期:类名已解析,缺行数据 item 字段(无 ID 注入)
new DateTime[2] 087739c4-3dee-4bac-b031-772497addc6b 1 NO_S3 passed: True F2-1b 修复验证通过
GetValueFunction 1cc15e59-460e-4949-8a2f-41ea39bad097 1 FULL_AUTO passed: True F2-1b 修复验证通过

补充类名解析验证(/api/script/execute 直接测试):

验证项 结果
GetServicesFunction.class.simpleName → "GetServicesFunction" passed: True
GetValueFunction.class.simpleName → "GetValueFunction" passed: True
new DateTime[2]; arr.length → 2 passed: True

五、单测覆盖

Java(ScriptFacadeTest,platform-metadata)

新增 7 个 F2-3 测试用例(总计 24,全绿):

用例 验证点
addFieldButton_withClosure_emitsOnClickSubCommands 闭包内动词产生 onClick 子指令数组(2 条)
addFieldButton_emptyClosure_emitsEmptyOnClick 空闭包产生空 onClick 数组(非 null)
addFieldButton_nullHandler_noOnClick null handler 不含 onClick 字段(向后兼容)
showConfirm_withClosure_emitsOnOkSubCommands 闭包内动词产生 onOk 子指令数组(2 条)
showConfirm_emptyClosure_emitsEmptyOnOk 空闭包产生空 onOk 数组
showConfirm_nullHandler_noOnOk null handler 不含 onOk 字段
addFieldButton_nestedClosure_closureBodyExceptionStillReturnsPartialSubCommands 闭包内异常前已产生的子指令仍收集(容错)

TypeScript(vitest,eip4-web)

新增 7 个单测用例(总计 23,全绿):

scriptCommands.test.ts(+4):

  • addButton 无 onClick 时透传 args
  • addButton 含 onClick 子指令数组时原样透传 onClick
  • confirmDialog 含 onOk 子指令数组时原样透传 onOk
  • confirmDialog 空 onOk 不含 onOk 字段

registerReplayAction.test.ts(+3):

  • addButton 含 onClick 时翻译并挂 onClickActions
  • confirmDialog 含 onOk 时翻译并挂 onOkActions
  • addButton 空 onClick 时不挂 onClickActions(直接派发)

六、e2e 验证

晋级后 npx playwright test:30/30 全绿(eip4-web)

8093 状态:RUNNING(PID 55015,Java 17,/tmp/eip4-8093.log)