2.0 KiB
2.0 KiB
0006-workflow-create-startformid
日期: 2026-07-17 状态: Accepted 作者: claude-code
Context
dacli workflow create 创建工作流时, 必须绑定一个发起表单 (startFormId)。当 --ai 模式或手动模式未传 --startFormId 时, 工作流创建成功但前端访问时报 workFlowForm/undefined.vue 错误 — 发起表单路由未正确绑定。
BS-E3 首次记录: jxcj auditrecord 工作流创建时未指定 startFormId, 浏览器访问流程发起页面 404。
影响范围: AP-wc-1, 涉及所有 workflow create 调用。
Decision
dacli workflow create 强制必传 --startFormId=<formId>, 命令行 parseArgs 阶段校验。formId 必须是已发布表单的 ID (state=1)。
工作流创建前, 用户需:
dacli form list --state=1确认目标表单已发布- 记下 formId
dacli workflow create --startFormId=<formId> ...
CLAUDE.md § dacli 已知限制 提到 workflow 必传参数规则。
Alternatives Considered
- dacli 从 formId 自动推导 startFormId: workflow create 可能同时传入 --formId (流程绑定的表单), dacli 可以直接复用为 startFormId。但 workflow 可能绑定多个 form, 发起表单不一定是主表单, 自动推导不可靠。
- workflow create --ai 自动匹配: AI 模式下, 让 user 在描述中指明 "发起表单为 xxx", NCPF backend 解析填充。同样不可靠 (依赖 LLM 准确率)。
- 创建后再绑定: JNPF web 端支持事后修改发起表单, dacli 可以先创建 workflow 再调 API 绑定。但增加 API 调用数, 且部分场景下发起的 workflow 无法修改。
Consequences
正面
- 明确的参数要求, 消除 workflow 创建后无法发起的静默错误
- 命令行校验在 parseArgs 阶段即报错, 不等到 API 调用
负面
- 用户需额外查询 formId, 多一步操作
- CLI 不提供事后修复路径 (需跳转到 web 端操作)
Cross-refs
- ANTI_PATTERNS: AP-wc-1
- BS-E3: 原始问题报告
- CLAUDE.md § dacli 已知限制: workflow 必传参数