概述
流程的集成是指在第三方系统需要调用流程的能力,目前平台主要提供的流程能力如下:
- 获取所有的授权的流程定义
- 启动流程
- 待办审批
- 获取流程实例明细
实现以上能力的集成,前提是先获取流程平台的授权,具体授权访问请参考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