Files
aibridge/docs/workflow/04-approval-operation-guide.md
T
2026-05-18 09:28:15 +08:00

4.5 KiB
Raw Blame History

审批操作指南

来源:前端 FlowParser.vue、后端 TaskController.java

审批流程

待办 → 签收 → 审批 → 通过/拒绝/退回

FlowParser.vue 审批代码

// 审批通过/拒绝
function handleApproval() {
  const query = {
    ...state.approvalData,
    ...state.formData,
    ...state.freeFlowConfig,
  };
  if (state.eventType === 'audit') query.handleStatus = 1;
  if (state.eventType === 'reject') query.handleStatus = 0;

  const approvalMethod =
    state.eventType === 'freeApprover' ? freeApprover :
    state.eventType === 'back' ? back : audit;

  approvalMethod(state.config.operatorId, query).then((res) => handleError(res));
}

审批操作

API 调用

# 审批通过(推荐)
client.workflow.approve(operator_id, "同意")

# 审批拒绝(推荐)
client.workflow.reject(operator_id, "不同意")

# 通用审批
client.workflow.audit(operator_id, {
    "status": 1,             # 1=同意, 2=拒绝
    "handleOpinion": "同意",
    "sign": "",
    "fileList": [],
    "candidateList": [],
})

audit 参数

参数 说明 必填
status 审批状态 是
handleOpinion 审批意见 否
sign 签章 否
fileList 附件列表 否
candidateList 候选人列表 否

签收/退签

# 签收
client.workflow.sign(operator_id)

# 退签
client.workflow.cancel_sign(operator_id)

# 开始办理
client.workflow.handle(operator_id)

转审

# 转给其他人审批
client.workflow.transfer(operator_id, {
    "handleOpinion": "转给部门经理",
    "transferUserId": "target_user_id",
})

退回

获取可退回节点

# 获取可退回的节点列表
resp = client.workflow.get_back_node_list(operator_id)
nodes = resp.data  # [{nodeId, nodeName, ...}]

执行退回

# 退回
client.workflow.back(operator_id, {
    "handleOpinion": "信息不完整,退回补充",
    "targetNodeId": "target_node_id",
})

backType 退回类型

backType 名称 说明
1 重新审批 退回后重新走原流程
2 从当前节点审批 退回后跳过已审批节点
3 自定义审批 用户选择

加签/减签

# 加签(增加审批人)
client.workflow.free_approver(operator_id, {
    "handleOpinion": "请法务会签",
    "candidateList": [
        {"userId": "user_id_1"},
        {"userId": "user_id_2"},
    ],
})

# 减签(移除审批人)
client.workflow.reduce_approver(operator_id, {
    "handleOpinion": "取消法务会签",
    "operatorId": "operator_to_remove",
})

协办

# 协办(请他人协助处理)
client.workflow.assist(operator_id, {
    "handleOpinion": "请协助核实金额",
    "candidateList": [{"userId": "assistant_user_id"}],
})

# 协办保存
client.workflow.save_assist(operator_id, {
    "handleOpinion": "核实结果:金额正确",
})

暂存审批

# 暂存审批意见(不提交)
client.workflow.save_audit(operator_id, {
    "handleOpinion": "正在核实中...",
})

撤回审核

# 撤回审核(审批人撤回自己的审批)
client.workflow.audit_recall(operator_id, {
    "handleOpinion": "审批有误,撤回重新审核",
})

候选人

# 获取候选人列表
resp = client.workflow.get_candidate_user({
    "operatorId": operator_id,
    "keyword": "",
})

# 判断是否有候选人
resp = client.workflow.get_candidates(operator_id, {})

按钮与操作的映射

按钮 方法 说明
提交 submit 发起流程
签收 sign 签收任务
同意 audit(status=1) 审批通过
拒绝 audit(status=2) 审批拒绝
退回 back 退回
加签 free_approver 增加审批人
减签 reduce_approver 移除审批人
转审 transfer 转给其他人
协办 assist 请人协助
暂存 save_audit 暂存意见
撤回 audit_recall 撤回审批

审批规则

  1. 审批人不能与发起人相同 - JNPF 规则限制
  2. 已完成的任务不能加签 - 系统校验
  3. 被转办或被协办的不能加签 - 系统校验
  4. 不能给自己加签 - 系统校验(WF106)

错误码

错误码 说明
WF081 已完成的任务不能加签
WF106 不能给自己加签/审批
DEFINITION_NOT_EXIST 流程模板不存在
TASK_NOT_EXIST 任务不存在