73 lines
2.9 KiB
TypeScript
73 lines
2.9 KiB
TypeScript
/**
|
|
* commands/workflow/launch.ts — 发起流程
|
|
*
|
|
* API: POST /api/workflow/task
|
|
*
|
|
* Body: { flowId, formId, formData, status, ... }
|
|
* - formData: object (审批数据, JNPF FlowModel schema)
|
|
* - data: 旧字段名, 错, BS-53 (2026-06-28 fksq 复现)
|
|
*
|
|
* 注意: 需绑工作流的 form (form.enableFlow=1) 才能发起
|
|
*/
|
|
import { Command } from 'commander'
|
|
import { JnpfClient } from '../../core/client.ts'
|
|
import { installHelpHook } from '../../core/help.ts'
|
|
import { log, printJson } from '../../core/log.ts'
|
|
import { setupOutputFilter } from './_output.ts'
|
|
|
|
interface Opts {
|
|
flowId: string
|
|
formId: string
|
|
data: string
|
|
json?: boolean
|
|
}
|
|
|
|
export function buildWorkflowLaunchCommand(): Command {
|
|
const cmd = new Command('launch')
|
|
.description('发起流程 (绑定 formId + flowId, data 为表单数据 JSON)')
|
|
.requiredOption('--flowId <id>', '流程模板 id')
|
|
.requiredOption('--formId <id>', '绑定的表单 id')
|
|
.requiredOption('--data <json>', '表单数据 JSON 字符串 (解析后塞进 formData 字段)')
|
|
.option('--verbose', '完整输出 (含 step machine、API 调用等过程日志)', false)
|
|
.option('--json', '原始 JSON 输出', false)
|
|
.action(async (opts: Opts) => {
|
|
setupOutputFilter(opts)
|
|
const c = await JnpfClient.fromToken()
|
|
// BS-53 (2026-06-28 fksq 复现): JNPF FlowModel 字段是 formData (object), 不是 data (string)
|
|
// 旧版 launch.ts 错用 data: opts.data (string), JNPF 后端解析时把字符串当 formData, 业务字段空
|
|
// 修复: opts.data 是 JSON 字符串, 解析为 object 后塞进 formData
|
|
let formDataObj: Record<string, unknown> = {}
|
|
try {
|
|
formDataObj = JSON.parse(opts.data)
|
|
} catch (e) {
|
|
log.error(`--data 不是合法 JSON: ${(e as Error).message}`)
|
|
process.exit(1)
|
|
}
|
|
const body = {
|
|
flowId: opts.flowId,
|
|
formId: opts.formId,
|
|
formData: formDataObj,
|
|
status: 0,
|
|
approverUserId: '',
|
|
}
|
|
log.info(`POST /workflow/task flowId=${opts.flowId} formId=${opts.formId}`)
|
|
const r = await c.postJson<{ id?: string; taskId?: string }>('/workflow/task', body)
|
|
if (r.code !== 200) {
|
|
log.error(`launch 失败 (code=${r.code}): ${r.msg}`)
|
|
if (opts.json) printJson(r)
|
|
process.exit(1)
|
|
}
|
|
log.ok(`发起成功: taskId=${r.data?.id || r.data?.taskId || '(unknown)'}`)
|
|
if (opts.json) printJson(r.data)
|
|
})
|
|
|
|
installHelpHook(cmd, {
|
|
purpose: '发起一个流程实例. 需 form.enableFlow=1.',
|
|
required: { '--flowId': '流程模板 id', '--formId': '绑定 form id', '--data': '表单数据 JSON' },
|
|
example: `dacli workflow launch --flowId=<flowId> --formId=<formId> --data='{"f_name":"张三"}'`,
|
|
source: { api: 'POST /api/workflow/task' },
|
|
notes: ['发起前确认 form.enableFlow=1 + flowId 已绑', '--data 是 JSON 字符串, 自动解析为 formData object'],
|
|
})
|
|
return cmd
|
|
}
|