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

210 lines
4.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 审批操作指南
> 来源:前端 `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 | 任务不存在 |