概述

流程的集成是指在第三方系统需要调用流程的能力,目前平台主要提供的流程能力如下:

  1. 获取所有的授权的流程定义
  2. 启动流程
  3. 待办审批
  4. 获取流程实例明细

实现以上能力的集成,前提是先获取流程平台的授权,具体授权访问请参考12.7的外部接口调用,http://doc.redxun.cn/docs/jpaas/externalCall

获取授权的流程定义接口

  • 接口路径:api/api-bpm/restApi/bpm/getMySolutions
  • 参数:
  • 请求参数:userAccount
  • 请求体body:
    {
      "pageNo": 1,
      "pageSize": 10,
      "params": {},
      "sortField": "",
      "sortOrder": "asc"
    }
参数名 参数值 必要性
userAccount 用户账号
pageNo 当前页码
pageSize 分页大小
params 条件,例:Q_NAME__S_LK
sortField 排序字段
sortOrder 排序(asc/desc)

启动流程

  • 接口路径:api/api-bpm/restApi/bpm/startProcess
  • 参数:
  • 请求参数:userAccount
  • 请求体Body:
    {
      "checkType": "AGREE",
      "defId": "1288318003842125826",
      "formJson": "{'jdbd':{'mc':'123','dz':'123'}}"
    }
参数名 参数值 必要性
userAccount 用户账号,用于当发起人用户
checkType 审批类型
defId 流程定义ID defId,defKey 必须二选一
defKey 流程定义KEY,如果指定了defId,优先使用defId
formJson 表单数据
nodeUserIds 发起时指定任务节点执行人
busKey 业务主键
boAlias Bo别名
vars 启动时传递变量

待办审批

  • 接口路径:/api/api-bpm/restApi/bpm/completeTask
  • 参数:
  • 请求参数:userAccount
  • 请求体Body:
    {
      "taskId": "1288397808436527106",
      "checkType": "AGREE",
      "copyUserAccounts": "zhangsan",
      "formJson": "{'t':       {'INST_ID_':'1288374364525404162','r':'','ID_':'1288374366400274434','CREATE_TIME_':1596007360000,'INST_STATUS_':'RUNNING','PARENT_ID_':'0','y':'','REF_ID_':'0','CREATE_BY_':'1'}}",
      "msgTypes": "",
      "nodeExecutors": {"UserTask_0clful0": [{"type": "user", "id": "1", "name": "管理员", "calcType": "none"}]},
      "opFiles": "[]",
      "opinion": "AAAAA",
      "opinionName": ""
    }
参数名 参数值 必要性
userAccount 用户账号,用于当审批人用户
taskId 任务ID
checkType 审批类型
opinion 审批意见
copyUserAccounts 抄送用户账号,用‘,’隔开
formJson 表单数据
msgTypes 消息通知
nodeExecutors 下一节点审批人配置
opFiles 审批附件
opinionName 审批意见名称
destNodeId 目标节点ID
vars 流程变量
nodeExecutors 指定节点的用户

1.指定节点执行人
nodeExecutors 数据格式:

{"nodeId1":[{"calcType":"none","id":"2","name":"ludy","type":"user"},{"calcType":"none","id":"1","name":"ray","type":"user"}]}

type:
user:表示节点执行人为用户
group:表示节点执行人为用户组

2.指定流程变量

vars 数据格式:

{"name":"ray","days":1}

这段可以在流程中设置两个流程变量。

流程实例明细

  • 接口路径:api/api-bpm/restApi/bpm/getInstDetail
  • 参数:
  • 请求参数:instId
参数名 参数值 必要性
instId 实例ID
userAccount 用户账号

其他接口

更多其他接口的集成请参考流程模块的接口集成。

文档更新时间: 2021-03-29 11:53   作者:zyg