概述
待办是指在第三方的系统中,需要在该系统中实现流程待办的展示,这需要通过平台的接口获取待办相关信息,包括:
我的待办列表
我的已办列表
我的待办数
我的已办数量
同时还需要在列表办,进行待办的任务处理,这需要实现待办的跳转处理。任务的办理有两种集成方式:
- 通过第三方平台通过调用平台的待办接口实现任务的办理
- 通过单点登录,跳到平台待办页中
集成
第三方系统集成平台的待办任务,需要通过获取平台的任务相关接口,需要获取接口的访问授权,授权的思路请参考外部接口调用:http://doc.redxun.cn/docs/jpaas/externalCall
第三方系统集成,即只需要通过Restful API 访问以下相关的接口即可,涉及到的相关的接口如下:
获取待办数
接口路径:api/api-bpm/restApi/bpm/getTaskCountsByUserAccount
参数:
请求参数:userAccount
响应参数值
{
success:false,
message:'',
data: 10
}
说明:data 则表示为返回的数量值
根据用户账号获取待办列表
- 接口路径:api/api-bpm/restApi/bpm/getTasksByUserAccount
- 参数:
- 请求参数:userAccount
- 请求体body:
{ "pageNo": 1, "pageSize": 10, "params": {}, "sortField": "", "sortOrder": "asc" }
参数名 | 参数值 | 必要性 |
---|---|---|
userAccount | 用户账号 | 是 |
pageNo | 当前页码 | |
pageSize | 分页大小 | |
params | 条件,例:Q_SUBJECT__S_LK | |
sortField | 排序字段 | |
sortOrder | 排序(asc/desc) |
- 响应结果
{ success:false, message:'', result: { pageSize:25, pageNo:1, totalCount:50, totalPage::2, data:[ { taskId:'', name:'', key:'', billType:'', billNo:'', busKey:'', descp:'', subject:'', owner:'', assignee:'', actInstId:'', actDefId:'', defId:'', instId:'', status:'', priority:'', expiredTime:'', createTime:'', updateTime:'', createBy:'', updateBy:'' } //... ] } }
根据用户账号获取已办数量
- 接口路径:api/api-bpm/restApi/bpm/getMyApprovedCounts
- 参数:
- 请求参数:userAccount
- 返回
{
success:false,
message:’’,
data: 10
}
根据用户账号获取已办
- 接口路径:api/api-bpm/restApi/bpm/getMyApproved
- 参数:
- 请求参数:userAccount
- 请求体body:
{
"pageNo": 1,
"pageSize": 10,
"params": {},
"sortField": "",
"sortOrder": "asc"
}
- 返回
{
success:false,
message:'',
result: {
pageSize:25,
pageNo:1,
totalCount:50,
totalPage::2,
data:[
{
instId:'',
defId:'',
treeId:'',
actInstId:'',
actDefId:'',
defCode:'',
instNo:'',
billNo:'',
billType:'',
subject:'',
status:'',
version:'',
busKey:'',
checkFileId:'',
isTest:'',
errors:'',
endTime:'',
dataSaveMode:'',
supportMobile:'',
startDepId:'',
startDepFull:'',
isLive:'',
liveInstId:'',
lockedBy:'',
createTime:'',
updateTime:'',
createBy:'',
updateBy:''
}
//...
]
}
}
待办跳转页面
从第三方平台跳至待办处理页,需要实现在待办列表跳过来的处理,需要实现如下地址的跳转并且实现参数传递:
http://ipaddress/jpaas/bpmTask/start?taskId=134343
【说明】:
taskId 为任务的主键,从待办列表中可以获取。
文档更新时间: 2021-03-29 11:53 作者:zyg