4.5 KiB
4.5 KiB
审批操作指南
来源:前端
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 | 撤回审批 |
审批规则
- 审批人不能与发起人相同 - JNPF 规则限制
- 已完成的任务不能加签 - 系统校验
- 被转办或被协办的不能加签 - 系统校验
- 不能给自己加签 - 系统校验(WF106)
错误码
| 错误码 | 说明 |
|---|---|
| WF081 | 已完成的任务不能加签 |
| WF106 | 不能给自己加签/审批 |
| DEFINITION_NOT_EXIST | 流程模板不存在 |
| TASK_NOT_EXIST | 任务不存在 |