spec.md 2.6 KB
ADDED Requirements
Requirement: 流程实例生命周期
YDClient_Process SHALL 覆盖流程发起、终止、撤回、跳转四个关键动作。每个方法 MUST 对应宜搭官方的一个流程实例 endpoint。
Scenario: 发起流程
- WHEN
startProcess(conf, processCode, formUuid, formDataJson, body_ext) - THEN 对应
POST /v1.0/yida/processes/instances/start - AND 返回
processInstanceId
Scenario: 终止流程
- WHEN
terminateProcess(conf, processInstanceId, body_ext) - AND
body_ext中支持operator/noExecuteExpression等
Scenario: 撤回流程
- WHEN
revokeProcess(conf, processInstanceId, body_ext) - THEN 发起人撤回已提交但未审批完成的流程
Requirement: 审批任务动作
YDClient_Process SHALL 覆盖同意 / 拒绝 / 转交 / 抄送 / 评论五类审批任务动作。每个方法 MUST 与宜搭官方 task 类 endpoint 1:1 对应。
Scenario: 同意任务
- WHEN
agreeTask(conf, processInstanceId, taskId, comment, body_ext) - THEN 对应
POST /v1.0/yida/processes/tasks/agree
Scenario: 拒绝任务
- WHEN
disagreeTask(conf, processInstanceId, taskId, comment, body_ext) - AND
body_ext支持nextOperatorUserIds（拒绝后指定下一个审批人，部分流程开启此功能）
Scenario: 转交任务
- WHEN
redirectTask(conf, processInstanceId, taskId, toUserId, comment, body_ext)
Scenario: 抄送
- WHEN
ccTask(conf, processInstanceId, taskId, toUserIds, comment, body_ext)
Scenario: 添加评论
- WHEN
commentTask(conf, processInstanceId, taskId, comment, body_ext)
Requirement: 流程与任务查询
YDClient_Process SHALL 提供流程详情、流程列表、任务列表三类查询能力。
Scenario: 查单个流程详情
- WHEN
getProcess(conf, processInstanceId, body_ext) - THEN 返回流程全量信息含已走过的所有节点
Scenario: 分页查流程
- WHEN
searchProcesses(conf, appType, formUuid, processCode, searchCriteria, body_ext) - THEN 支持按发起人 / 状态 / 时间范围过滤
Scenario: 查任务列表
- WHEN
searchTasks(conf, userId, statuses, body_ext) - THEN 返回某用户当前的待办 / 已办任务
Requirement: 节点跳转
YDClient_Process SHALL 提供流程节点跳转能力，允许运维干预流程路径。
Scenario: 跳转到指定节点
- WHEN
redirectProcess(conf, processInstanceId, targetActivityId, body_ext) - THEN 流程跳转到指定节点，支持前跳与后跳