# 接口说明

调用本接口，对当前待办任务进行办理，完成后当前任务进入已办，同时创建下一条待办任务

# 权限

要调用此API，需要申请poa能力，获取poa token，接口请求头中添加 Authorization 值为token

详细参考-获取access token

# 请求方法

报文样例

POST /apis/ttc/v1/transaction/poa/taskHandle
Host: poa地址
Authorization:String
Content-Type:application/json
    
办理当前待办同时创建下一待办
[
  {
    "appId": "GzqhyfpMLSEexyO78bDgO-UWlK6PwOyAE",
    "handleOpinions": "",
    "handleStatus": "string",
    "handleTime": "",
    "handler": "smartadmin",
    "handlerName": "智慧校园管理员",
    "next": [
      {
        "actions": [{
            "allowMerge": 0,
            "method": "post",
            "name": "撤回",
            "nextNodeKey": "",
            "optType": 0,
            "type": "REVOKE",
            "url": "http://www.baidu.com"
        }],
        "autoCreateTransType": true,
        "canDelegate": 0,
        "handleUrl": "http://www.baidu.com",
        "handlers": "smartadmin",
        "handlingGroup": "",
        "initiator": "smartadmin",
        "initiatorName": "智慧校园管理员",
        "mHandleUrl": "http://www.baidu.com",
        "mViewUrl": "http://www.baidu.com",
        "mhandleUrl": "http://www.baidu.com",
        "mviewUrl": "http://www.baidu.com",
        "nodeId": "NODE0002",
        "nodeName": "节点2",
        "serialNumber": "NUM0001",
        "status": "next",
        "taskId": "TASK0002",
        "taskName": "待办名称0002",
        "taskSummary": ["摘要1|内容1","摘要2|内容2"],
        "timeOut": 0,
        "transSummary": ["111|222"],
        "transTypeCode": "TTCODE0001",
        "transTypeName": "事务类型0001",
        "transcationName": "自定义事务名称",
        "viewUrl": "http://www.baidu.com"
      }
    ],
    "previousActions": [{
        "allowMerge": 0,
        "method": "post",
        "name": "撤回",
        "nextNodeKey": "",
        "optType": 0,
        "type": "REVOKE",
        "url": "http://www.baidu.com",
        "times": 1
    }],
    "previousTaskId": "TASK0001",
    "status": "next"
  }
]
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
55
56
57
58
59
60
61
62
63
64
65

# Header参数

名称 类型 是否必填 描述
Authorization String 是 接口访问凭证

# Body参数

名称（1级） 名称（2级） 名称（3级） 类型 是否必填 描述
appId String 是 应用id
handler String 是 办理人账号(必须为待办的办理人)
status String 是 办理状态； next表示任务办理完成同时创建下个任务、none表示当前任务不做任务操作，只增加办理情况（适用于会签且不是最后一签，如果是最后一签，且有下一个节点使用next 或者是并行节点，且不是并行最后一个节点，都可以传none）、 end表示当前为最终节点，事务办结了
previousTaskId String 是 刚办理完成任务的taskId
handleOpinions String 否 办理意见
handleStatus String 否 办理状态
handleTime String 否 处理时间(格式：yyyy-MM-dd HH:mm:ss)，status=end表示办结时间和任务办理时间一致
handlerName String 否 办理人姓名，如果不想要展示办理人真实信息可以用这个字段代替办理人姓名
next Array 条件必传 下个任务在此创建，status不是next传了没用;该字段为数组，支持下个任务为并行任务，可设定多个任务
handlers String 是 办理人学工号，多个学工号间通过“,”分离，与handlingGroup选填一个即可
handlingGroup String 是 办理用户组，多个用户组间通过“,”分离，与handlers选填一个即可
nodeId String 是 节点id,同一节点 nodeId需要一致。例如：学生请假 - 辅导员审核这个节点，这个辅导员审核节点的主键或是唯一键可作为nodeId
nodeName String 是 节点名称,同一节点 nodeName需要一致
transTypeCode String 是 事务类型编码
actions Array 否 自定义操作列表
method String 是 调用接口方式
name String 是 按钮名称
optType Integer 是 操作类型
1：page，页面 0：api，接口(表示快速处理)
type String 是 类型，HANDLE办理、BREAK_UP终止、REVOKE撤回、HANG_UP挂起、ACTIVE激活、CIRCULARIZE传阅、TRANSFER转办、PROMOTER发起人操作、HANDLEDR待办人操作、DEAL待办人操作、ALL所有人操作
url String 是 请求地址
allowMerge Integer 否 是否允许并行，默认0
0：不允许合并 1：允许合并处理
nextNodeKey String 否 调用接口携带参数
autoCreateTransType Boolean 否 是否由系统自动创建事务类型，默认false
canDelegate Integer 否 是否允许代理任务，默认0
0：不允许代理 1：允许代理
handleUrl String 否 pc处理地址
initiator String 否 发起人学工号，不填取应用名称
initiatorName String 否 发起人姓名,不填取initiator账号在用户服务中的姓名
mHandleUrl String 否 mobile处理地址
mViewUrl String 否 mobile查阅地址
taskSummary String[] 否 任务摘要(业务办理关键字段)，完整字段标题和内容由"|"分隔，最终根据填写顺序依次展示；如果不填会显示事务摘要，都不存在则不显示
timeOut Integer 否 任务超时时间
transSummary String[] 否 事务的摘要(业务办理关键字段)，完整字段标题和内容由"|”分隔，最终根据填写顺序依次展示
viewUrl String 否 pc查阅地址
previousActions Array 否 办理完当前待办，给已办添加自定义操作
name String 是 按钮名称
method String 是 调用接口方式
url String 是 请求地址
optType String 是 操作类型
1：page，页面 0：api，接口(表示快速处理)
type String 是 类型, HANDLE办理、BREAK_UP终止、REVOKE撤回、HANG_UP挂起、ACTIVE激活、CIRCULARIZE传阅、TRANSFER转办、PROMOTER发起人操作、HANDLEDR待办人操作、DEAL待办人操作、ALL所有人操作
allowMerge Integer 否 是否允许并行，默认0
0：不允许合并 1：允许合并处理
nextNodeKey String 否 调用接口携带参数
times Integer 否 按钮执行次数，null为不限制执行次数

办理接口可以携带下一个节点的待办任务，接口会办理当前任务并根据next字段传参判断创建下一条待办任务

支持批量办理传参，批量中异常数据不影响正常数据的办理，接口响应会返回异常数据，请自行获取处理

# 接口调用成功返回

接口返回code值0为成功返回

{
  "took": 6089,
  "timestamp": 1688956011462,
  "code": 0,
  "message": "办理成功",
  "data": {
    "errorIds": []
  }
}
1
2
3
4
5
6
7
8
9

# 接口调用失败返回

  • 接口支持批量，批量操作中的每条数据独立运行，批量中有失败的数据接口整体响应code为0 （成功），data中返回出现错误的数据
  • 办理有携带创建下一个任务（next参数），办理和创建的过程独立运行，办理或者创建数据异常会在data中记录
  • 外层响应code不为0时为未知的错误，请自行设计重试机制
{
  "took": 285,
  "timestamp": 1688712485963,
  "code": 0,
  "message": "办理中有异常数据",
  "data": {
    "errorIds": [
      {
        "code": 400,
        "taskId": "TTT20230703-002-001",
        "message": "transTypeCode is null"
      }
    ]
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
  • data.errorIds.code说明:
  • 任务id（taskId）为next参数中创建任务的id时，查看任务创建的报错码
code message 说明
400 xxx is null 参数校验不合法
500 * 业务逻辑异常
2004 this task is not exist 当前任务不存在
2005 this task has been finished 当前任务已办理

← 任务转办 →