# 审批操作指南 > 来源:前端 `FlowParser.vue`、后端 `TaskController.java` ## 审批流程 ``` 待办 → 签收 → 审批 → 通过/拒绝/退回 ``` ## FlowParser.vue 审批代码 ```typescript // 审批通过/拒绝 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 调用 ```python # 审批通过(推荐) 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 | 候选人列表 | 否 | ## 签收/退签 ```python # 签收 client.workflow.sign(operator_id) # 退签 client.workflow.cancel_sign(operator_id) # 开始办理 client.workflow.handle(operator_id) ``` ## 转审 ```python # 转给其他人审批 client.workflow.transfer(operator_id, { "handleOpinion": "转给部门经理", "transferUserId": "target_user_id", }) ``` ## 退回 ### 获取可退回节点 ```python # 获取可退回的节点列表 resp = client.workflow.get_back_node_list(operator_id) nodes = resp.data # [{nodeId, nodeName, ...}] ``` ### 执行退回 ```python # 退回 client.workflow.back(operator_id, { "handleOpinion": "信息不完整,退回补充", "targetNodeId": "target_node_id", }) ``` ### backType 退回类型 | backType | 名称 | 说明 | |----------|------|------| | 1 | 重新审批 | 退回后重新走原流程 | | 2 | 从当前节点审批 | 退回后跳过已审批节点 | | 3 | 自定义审批 | 用户选择 | ## 加签/减签 ```python # 加签(增加审批人) 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", }) ``` ## 协办 ```python # 协办(请他人协助处理) client.workflow.assist(operator_id, { "handleOpinion": "请协助核实金额", "candidateList": [{"userId": "assistant_user_id"}], }) # 协办保存 client.workflow.save_assist(operator_id, { "handleOpinion": "核实结果:金额正确", }) ``` ## 暂存审批 ```python # 暂存审批意见(不提交) client.workflow.save_audit(operator_id, { "handleOpinion": "正在核实中...", }) ``` ## 撤回审核 ```python # 撤回审核(审批人撤回自己的审批) client.workflow.audit_recall(operator_id, { "handleOpinion": "审批有误,撤回重新审核", }) ``` ## 候选人 ```python # 获取候选人列表 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 | 任务不存在 |