# 快速处理说明

事务中心提供了快速办理功能,业务系统可以自定义操作列表,匹配对应的操作地址;操作按钮会按照按钮权限最终显示在事务中心列表中;

为满足审核人具备足够信息,支撑其进行快速办理,额外提供待办的信息摘要;以下为摘要字段要求:

["请假天数|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

点击按钮,接口回调,会根据不同类型请求,携带参数 如下参数:

参数 说明
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

body 中参数会进行对称加密;

# 按钮权限说明

按钮对应操作权限设定如下:

待办
   HANDLE办理、HANG_UP挂起、ACTIVE激活、CIRCULARIZE传阅、TRANSFER转办、DEAL待办人操作、ALL所有人操作
已办
   HANDLEDR已办人操作 ALL所有人操作;
发起  
   REVOKE撤回 BREAK_UP终止 PROMOTER发起人操作 ALL所有人操作;
1
2
3
4
5
6

# 事务回调机制(1.2.3版本及以上)

事务中心的两种回调机制

  1. 我的待办页面待办停留超过N小时(可配置),点击详情跳转第三方办理页面时触发回调机制
  2. 事务中心定时每天23:00:00触发回调机制

回调接口需要注意

  1. 回调机制2中需要批量处理任务,考虑接口满足批量的查询功能(机制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