概述

待办是指在第三方的系统中,需要在该系统中实现流程待办的展示,这需要通过平台的接口获取待办相关信息,包括:

我的待办列表
我的已办列表
我的待办数
我的已办数量

同时还需要在列表办,进行待办的任务处理,这需要实现待办的跳转处理。任务的办理有两种集成方式:

  1. 通过第三方平台通过调用平台的待办接口实现任务的办理
  2. 通过单点登录,跳到平台待办页中

集成

第三方系统集成平台的待办任务,需要通过获取平台的任务相关接口,需要获取接口的访问授权,授权的思路请参考外部接口调用: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