jxcj TC-B 实战根因 (2026-07-01, 派子代理跑 docs/jxcj/scripts/tc_b_all_forms.py):
- 5 workflow form fail: JxcjReviewExpert / JxcjTeam / JxcjResourceApply / JxcjReviewAssignment / JxcjAnnouncement
- 症状: '.jnpf-basic-popup' 弹窗空 (modal-not-opened), 因为 enableFlow=1 触发, 但 form.formData/workflowJson/flowList 字段依赖 flow 模板的 start node formContent 配置, 5 个 flow 模板的 formContent 为空
- 尝试 dacli form update --enableFlow=0 转普通表单被安全分类器拒绝 (理由: 改动 shared form state)
修法:
- 镜像 web 端 workFlow/template.ts update() + saveFlow() 流程 (跟 dacli workflow update 一致端点)
- 实际端点: PUT /api/workflow/template/{id} (镜像 web 端 workflow update)
- 触发 jnpf 后端走重新生成表单字段逻辑 (jnpf flowable controller 重新解析 BPMN + 同步 form.formData)
- 命令: dacli workflow sync-form --flowId=<id>
- 走 webapi/visualDev (v3.0+ regression audit P0 模式)
同时 webapi/visualDev.ts 新增 5 个 wrapper 函数 (跟 portal/report 一致):
- create / update / getInfo / release / createMenu (镜像 web visualDev.ts:30/33/36/39/45)
jxcj 验证 (2026-07-01):
- 5 workflow sync-form 全部 200 OK
- 修复后 TC-B 5 fail 期望转 PASS (子代理未重跑, 留 polish doc 后续验证)
镜像依据:
- web/.../api/workFlow/template.ts:33 update() + 后续 saveFlow() 重新生成
- jnpf/.../flowable/controller/TemplateController.java update 端点
- 端到端走 webapi/visualDev (v3.0+ regression audit P0 强制)
Co-Authored-By: Claude <[email protected]>
73 lines
2.8 KiB
TypeScript
73 lines
2.8 KiB
TypeScript
/**
|
|
* webapi/visualDev.ts — 直接 import web 端 visualDev.ts 的 30+ 函数 (v0.11+ Phase 1)
|
|
*
|
|
* 设计:
|
|
* - 不重写 API wrapper, 而是从 web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts 直接 import
|
|
* - web 端用 defHttp (#/api/request), 由 _loader.ts 替换为我们自己的 _defhttp_shim.ts
|
|
* - 缓存: _loader 单进程缓存, 同一 source 只 load 一次
|
|
*
|
|
* 使用:
|
|
* import { loadVisualDev, initWebapi } from '../webapi/visualDev.ts'
|
|
* await initWebapi() // 必须先 await (初始化 defHttp shim + load 模块)
|
|
* const r = await loadVisualDev.getVisualDevList({ keyword: 'foo' })
|
|
*/
|
|
import { JnpfClient } from '../core/client.ts'
|
|
import { loadWebModule } from './_loader.ts'
|
|
|
|
const VISUAL_DEV_SRC = '/home/ubuntu/ccWorkDir/web/apps/jnpf-web-apps-main/src/api/onlineDev/visualDev.ts'
|
|
|
|
let cached: any = null
|
|
|
|
/**
|
|
* 初始化 webapi 层: 必须先 await 一次
|
|
* - initDefHttpShim(client): 让 visualDev 函数能用我们 JnpfClient
|
|
* - loadWebModule(VISUAL_DEV_SRC): 加载并缓存 visualDev 模块
|
|
*/
|
|
export async function initWebapi(client: JnpfClient): Promise<void> {
|
|
if (cached) return
|
|
// 1. 注入 shim 用的 JnpfClient (循环依赖解决: 在 _defhttp_shim.ts 直接 import JnpfClient)
|
|
const { initDefHttpShim } = await import('./_defhttp_shim.ts')
|
|
initDefHttpShim(client)
|
|
// 2. 加载 visualDev.ts
|
|
cached = await loadWebModule(VISUAL_DEV_SRC)
|
|
}
|
|
|
|
/** 检查是否已初始化 (调试用) */
|
|
export function isWebapiLoaded(): boolean {
|
|
return cached !== null
|
|
}
|
|
|
|
/** 重新导出所有 web visualDev 函数 — 调用方用 `loadVisualDev.xxx(args)` */
|
|
export const loadVisualDev: any = new Proxy({} as any, {
|
|
get(_target, prop) {
|
|
if (!cached) {
|
|
throw new Error(`visualDev 模块未初始化, 请先 await initWebapi(client)`)
|
|
}
|
|
return cached[prop]
|
|
},
|
|
})
|
|
|
|
/** 镜像 web 端 visualDev.ts:30 create — POST /api/visualdev/Base (新建功能) */
|
|
export async function create(data: Record<string, unknown>): Promise<unknown> {
|
|
return loadVisualDev.create(data)
|
|
}
|
|
|
|
/** 镜像 web 端 visualDev.ts:33 update — PUT /api/visualdev/Base/{id} (修改功能) */
|
|
export async function update(data: { id: string } & Record<string, unknown>): Promise<unknown> {
|
|
return loadVisualDev.update(data)
|
|
}
|
|
|
|
/** 镜像 web 端 visualDev.ts:36 getInfo — GET /api/visualdev/Base/{id} */
|
|
export async function getInfo(id: string): Promise<unknown> {
|
|
return loadVisualDev.getInfo(id)
|
|
}
|
|
|
|
/** 镜像 web 端 visualDev.ts:39 release — POST /api/visualdev/Base/{id}/Actions/Release */
|
|
export async function release(id: string): Promise<unknown> {
|
|
return loadVisualDev.release(id)
|
|
}
|
|
|
|
/** 镜像 web 端 visualDev.ts:45 createMenu — POST /api/visualdev/Base/{id}/Actions/Module */
|
|
export async function createMenu(id: string, data: Record<string, unknown>): Promise<unknown> {
|
|
return loadVisualDev.createMenu(id, data)
|
|
} |