210 lines
4.5 KiB
Markdown
210 lines
4.5 KiB
Markdown
# 审批操作指南
|
||
|
||
> 来源:前端 `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 | 任务不存在 |
|