Files
dacli/src/commands/workflow/launch.ts
T

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
}