# 快速处理说明
事务中心提供了快速办理功能,业务系统可以自定义操作列表,匹配对应的操作地址;操作按钮会按照按钮权限最终显示在事务中心列表中;
为满足审核人具备足够信息,支撑其进行快速办理,额外提供待办的信息摘要;以下为摘要字段要求:
["请假天数|3天","请假类型|事假","时间|2021/06/10 - 2021/06/15"], // String[] 摘要(业务办理关键字段),完整字段标题和内容由|分隔,最终根据填写顺序依次展示;发起人看到的一直是事务摘要 **最大键值对数量为 5**
1
# 批量审批
特别注明: 所有批量操作都由事务中心循环调用处理接口,不是调用批量接口;
具备自定义操作按钮(actions 数组字段)的接口都是可以设置批量审批的;
actions 字段有如下扩充字段进行使用;提供批量审批必要信息。
actions:[ // 自定义操作按钮
{
name: "", // 按钮名称
url: "", // 请求地址
allowMerge: 1, // 是否允许批量,默认0; 允许批量的按钮,在点击批量操作时,展示出来,任务下没有可批量按钮,该任务不可进行批量操作
type: "",// 类型, HANDLE办理、BREAK_UP终止、REVOKE撤回、HANG_UP挂起、ACTIVE激活、CIRCULARIZE传阅、TRANSFER转办、PROMOTER发起人操作、HANDLEDR待办人操作、DEAL待办人操作、ALL所有人操作;对应的类型有对应的发送消息机制、以及后续的事务处理机制。可以参考下方操作接口
optType: "0", // 操作类型:1:page页面 0:api接口(表示快速处理)
method: "post", // 请求方式 ,optType为api 必填,get 、 post 、 put
nextNodeKey: "", // 导致节点变动的操作,需要传下一个节点关键词,点击按钮时,需要将该参数传过去
}
]
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
点击按钮,接口回调,会根据不同类型请求,携带参数 如下参数:
参数 | 说明 |
---|---|
nextNodeKey | 下一个节点关键词 |
opinions | 审批意见 |
accountName | 办理人学工号 |
time | 办理时间(yyyy-MM-dd HH:mm:ss) |
x-id-token | 当前人token信息(请求头中) |
uuid | 随机uuid(请求头中) |
POST/PUT (get 不推荐使用)
会将 审批意见,当前审核人学工号,当前审批时间 放body 中传参,handleToken , uuid 设置到请求头
curl -X POST "https://transaction.dev2.supwisdom.com/ttc/api/ttc/user/getBatchQuery"
-H "accept: application/json"
-H "Content-Type: application/json"
-H "x-id-token: xxxxx"
-H "uuid: xxxxx"
-d "{ \"nextNodeKey\": \"xxxx\",\"accountName\": \"xxxx\",\"opinions\": \"xxxxx\",\"time\": \"xxxx\"}"
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
body 中参数会进行对称加密;
# 按钮权限说明
按钮对应操作权限设定如下:
待办
HANDLE办理、HANG_UP挂起、ACTIVE激活、CIRCULARIZE传阅、TRANSFER转办、DEAL待办人操作、ALL所有人操作
已办
HANDLEDR已办人操作 ALL所有人操作;
发起
REVOKE撤回 BREAK_UP终止 PROMOTER发起人操作 ALL所有人操作;
1
2
3
4
5
6
2
3
4
5
6
# 事务回调机制(1.2.3版本及以上)
事务中心的两种回调机制
- 我的待办页面待办停留超过N小时(可配置),点击详情跳转第三方办理页面时触发回调机制
- 事务中心定时每天23:00:00触发回调机制
回调接口需要注意
- 回调机制2中需要批量处理任务,考虑接口满足批量的查询功能(机制2为夜晚自动触发,不需要考虑接口响应慢等性能问题)
- 回调接口需要判断任务的状态,如果不是进行中,需要返回当前状态必须的以下信息
回调接口入参 taskIds List(String) 任务ids 回调接口期望响应值如下 数据与入参的taskIds对应
{
"code":0,
"message":"调用成功",
"data":[
{
"taskId":"TT2022001",//任务ID
"taskStatus": "FINISH", //任务状态IN_PROGRESS进行中,FINISH正常办理,TERMINATED终止,TURN转办,SUSPENDED挂起,RECALL撤回
"taskData":{//当任务不是在进行中时 需要提供任务信息
"handleTime": "yy-MM-dd hh:mm:ss",//必填 处理时间
"endTime": "yy-MM-dd hh:mm:ss",//任务状态挂起时必填 结束时间
"handleOpinions": "办理意见", //非必填 处理意见
"handler": "smartadmin", // 必填 处理人学工号
"turnHandler": "smartadmin", // 任务状态TURN转办时必填 被转办人
"status": "next", // 任务状态为正常办理时必填 next表示任务办理完成同时创建下个任务、none表示当前任务不做任务操作,只增加办理情况(适用于会签且不是最后一签,如果是最后一签,且有下一个节点使用next 或者是并行节点,且不是并行最后一个节点,都可以传none)、 end表示当前为最终节点,事务办结了
"next":[// 有下一个任务时必填
{
"actions": [ //自定义操作列表
{
"method": "post", //请求方式 ,optType为api 必填,get 、 post 、 put
"name": "催办", //名称
"optType": 0, // 1:page页面 0:api接口
"type": "REVOKE", //类型, HANDLE办理、BREAK_UP终止、REVOKE撤回、HANG_UP挂起、ACTIVE激活、CIRCULARIZE传阅、TRANSFER转办、PROMOTER发起人操作、HANDLEDR待办人操作、DEAL待办人操作、ALL所有人操作
"url": "http://www.baidu.com"
}
],
"appId": "GzqhyfpMLSEexyO78bDgO-UWlK6PwOyAE", //应用id;必填
"canDelegate": 0, //是否允许代理, 1允许 0不允许,默认0
"handlingGroup":"111",//处理人用户组id,工号、用户组 二选一
"handlers": "smartadmin", //处理人 学/工号,多个账号英文逗号分隔,工号、用户组 二选一;办理人、候选人都放这个字段
"initiator": "", //发起人 学/工号
"mHandleUrl": "http://www.baidu.com", //app处理地址
"mViewUrl": "http://www.baidu.com", //app查阅地址
"handleUrl": "http://www.baidu.com", //pc处理地址
"viewUrl": "http://www.baidu.com", //pc查阅地址
"nodeId": "NO20220002", //必填 节点id;同一节点 nodeId需要一致
"nodeName": "节点2-转办挂起激活待办", //节点名称,必填,同一节点 nodeName需要一致
"serialNumber": "LSH2022051508", //流水号
"taskId": "20220705001111112", //任务ID
"taskName": "待办20220705001111112", //自定义任务名称
"timeOut": 0, //任务超时时间 单位h 默认不设置超时时间
"transTypeCode": "CE2022001", //类型code
"transTypeName": "测试类型1" //类型名称
}
]
}
},
{
"taskId":"TT2022002",//任务ID
"taskStatus": "IN_PROGRESS", //任务状态IN_PROGRESS进行中,FINISH正常办理,TERMINATED终止,TURN转办,SUSPENDED挂起
"taskData":{} //当任务是在进行中时 无需提供其他信息
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
← 旧版API(不推荐) 常见问题 →