作者:钟剑华  历史版本:1  更新时间:2025-10-14 18:31
流程任务变更列表
简述:
- 【流程任务变更】列表(分页条件查询)数据
 
请求URL:
- http://ip:port/ibps/business/v3/bpm/task/change/query
 - URL中的ip需要替换为自己网关ip
 - URL中的port需要替换为自己网关端口
 
请求方式:
- POST
 
请求参数:
- Headers:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| X-Authorization-access_token | String | 是 | 系统令牌 | 
- Query:
 
暂无
- Body:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| request | APIRequest[1] | 是 | 动态查询请求对象 | 
请求参数示例:
{
    "parameters": [],
    "requestPage": {
        "pageNo": 1,
        "limit": 20
    },
    "sorts": []
}返回示例:
{
  "state": 200,
  "request": null,
  "message": "",
  "cause": "",
  "variables": {},
  "data": {
    "dataResult": [
      {
        "pk": "",
        "name": null,
        "ip": null,
        "createBy": null,
        "createTime": "2020-02-12 16:08:30",
        "updateBy": null,
        "updateTime": null,
        "tenantId": null,
        "dataStatus": null,
        "dbtype": null,
        "id": "677184296619868160",
        "taskId": "677183859263012865",
        "taskSubject": "管理员在2020-02-12 16:06:51发起分支网关加跳转规则",
        "taskName": "领导审批",
        "procInstId": "677183849335095296",
        "nodeId": "UserTask_059cdtd",
        "changeType": "shift",
        "status": "running",
        "ownerId": "1",
        "executorId": null,
        "comment": "默认转办描述",
        "completeTime": null,
        "cancelTime": null,
        "delBeforeSave": true,
        "bpmTaskChangeAssignPoList": [],
        "ownerName": "管理员",
        "executorName": null
      }
    ],
    "pageResult": {
      "limit": 2,
      "page": 1,
      "totalCount": 1,
      "totalPages": 1
    }
  }
}
返回参数说明:
| 名称 | 类型 | 备注 | 
|---|---|---|
| dataResult | List< BpmTaskChangePo > | 流程任务变更列表数据 | 
| pageResult | Object | 分页数据 | 
流程任务变更列表数量
简述:
- 【流程任务变更】列表(分页条件查询)数据数量
 
请求URL:
- http://ip:port/ibps/business/v3/bpm/task/change/queryCount
 - URL中的ip需要替换为自己网关ip
 - URL中的port需要替换为自己网关端口
 
请求方式:
- POST
 
请求参数:
- Headers:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| X-Authorization-access_token | String | 是 | 系统令牌 | 
- Query:
 
暂无
- Body:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| request | APIRequest[1] | 是 | 动态查询请求对象 | 
请求参数示例:
{
    "parameters": [],
    "requestPage": {},
    "sorts": []
}返回示例:
{
    "state": 200,
    "request": null,
    "message": "",
    "cause": "",
    "variables": {},
    "data": "12"
}返回参数说明:
| 名称 | 类型 | 备注 | 
|---|---|---|
| data | Integer | 数量 | 
根据id获取对象信息
简述:
- 根据id获取对象信息
 
请求URL:
- http://ip:port/ibps/business/v3/bpm/task/change/get
 - URL中的ip需要替换为自己网关ip
 - URL中的port需要替换为自己网关端口
 
请求方式:
- GET
 
请求参数:
- Headers:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| X-Authorization-access_token | String | 是 | 系统令牌 | 
- Query:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| id | String | 是 | 主键id | 
- Body:
 
暂无
请求参数示例:
http://192.168.3.230:15100/ibps/business/v3/bpm/task/change/get?id=677184296619868160返回示例:
{
  "state": 200,
  "request": null,
  "message": "",
  "cause": "",
  "variables": {},
  "data": {
    "pk": "",
    "name": null,
    "ip": null,
    "createBy": null,
    "createTime": "2020-02-12 16:08:30",
    "updateBy": null,
    "updateTime": null,
    "tenantId": null,
    "dataStatus": null,
    "dbtype": null,
    "id": "677184296619868160",
    "taskId": "677183859263012865",
    "taskSubject": "管理员在2020-02-12 16:06:51发起分支网关加跳转规则",
    "taskName": "领导审批",
    "procInstId": "677183849335095296",
    "nodeId": "UserTask_059cdtd",
    "changeType": "shift",
    "status": "running",
    "ownerId": "1",
    "executorId": null,
    "comment": "默认转办描述",
    "completeTime": null,
    "cancelTime": null,
    "delBeforeSave": true,
    "bpmTaskChangeAssignPoList": [
      {
        "pk": "",
        "name": null,
        "ip": null,
        "createBy": null,
        "createTime": null,
        "updateBy": null,
        "updateTime": null,
        "tenantId": null,
        "dataStatus": null,
        "dbtype": null,
        "id": "677184296951218176",
        "taskChangeId": "677184296619868160",
        "type": "employee",
        "executor": "664433378967158784",
        "typeName": null,
        "executorName": "664433378967158784"
      }
    ],
    "ownerName": "管理员",
    "executorName": null
  }
}返回参数说明:
| 名称 | 类型 | 备注 | 
|---|---|---|
| data | BpmTaskChangePo | 流程任务变更对象 | 
保存
简述:
- 保存流程任务变更
 
请求URL:
- http://ip:port/ibps/business/v3/bpm/task/change/save
 - URL中的ip需要替换为自己网关ip
 - URL中的port需要替换为自己网关端口
 
请求方式:
- POST
 
请求参数:
- Headers:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| X-Authorization-access_token | String | 是 | 系统令牌 | 
- Query:
 
暂无
- Body:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| id | String | 否 | 主键id | ||
| taskId | String | 是 | 任务ID | ||
| taskSubject | String | 是 | 事项标题 | ||
| taskName | String | 是 | 任务名称 | ||
| procInstId | String | 是 | 流程实例ID | ||
| nodeId | String | 是 | 任务节点ID | ||
| changeType | String | 是 | 更改类型 | ||
| status | String | 否 | 状态 | ||
| ownerId | String | 否 | 所属人ID | ||
| executorId | String | 否 | 执行人ID | ||
| comment | String | 否 | 变更描述 | ||
| createTime | String | 否 | 任务完成时间 | ||
| completeTime | String | 否 | 任务完成时间 | ||
| cancelTime | String | 否 | 任务取消时间 | ||
| bpmTaskChangeAssignPoList | String | 是 | 转办受理人信息 | 
请求参数示例:
{
    "pk": "",
    "name": null,
    "ip": null,
    "createBy": null,
    "createTime": "2022-05-20 11:16:38",
    "updateBy": null,
    "updateTime": null,
    "tenantId": null,
    "dataStatus": null,
    "deleted": null,
    "dbType": null,
    "dsAlias": null,
    "id": null,
    "taskId": "977167872725876736",
    "taskSubject": "管理员在2022-05-20 11:16:15发起验证按钮01",
    "taskName": "发起人",
    "procInstId": "977167871803129857",
    "nodeId": "Activity_1u01sua",
    "changeType": "shift",
    "status": "running",
    "ownerId": "1",
    "executorId": null,
    "comment": "默认转办描述",
    "completeTime": null,
    "cancelTime": null,
    "delBeforeSave": true,
    "bpmTaskChangeAssignPoList": [
        {
            "type": "employee",
            "executor": "973977875986251776",
            "executorName": "自行车"
        },
        {
            "type": "employee",
            "executor": "974673302050045952",
            "executorName": "eddy"
        }
    ],
    "ownerName": "管理员",
    "executorName": null,
    "icon": null,
    "iconBgColor": null
}返回示例:
{
  "state": 200,
  "request": null,
  "message": "保存流程任务变更成功",
  "cause": "",
  "variables": {},
  "data": null
}返回参数说明:
| 名称 | 类型 | 备注 | 
|---|---|---|
| data | Void | 
删除
简述:
- 批量删除流程任务变更
 
请求URL:
- http://ip:port/ibps/business/v3/bpm/task/change/remove
 - URL中的ip需要替换为自己网关ip
 - URL中的port需要替换为自己网关端口
 
请求方式:
- POST
 
请求参数:
- Headers:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| X-Authorization-access_token | String | 是 | 系统令牌 | 
- Query:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| id | String | 是 | 主键id | 
- Body:
 
暂无
请求参数示例:
http://192.168.3.230:15100/ibps/business/v3/bpm/task/change/remove?id=654357778126602240,638399136323862528返回示例:
{
  "state": 200,
  "request": null,
  "message": "删除流程任务变更成功",
  "cause": "",
  "variables": {},
  "data": null
}返回参数说明:
| 名称 | 类型 | 备注 | 
|---|---|---|
| data | Void | 
设置流程任务变更状态
简述:
- 设置【流程任务变更】状态
 
请求URL:
- http://ip:port/ibps/business/v3/bpm/task/change/setStatus
 - URL中的ip需要替换为自己网关ip
 - URL中的port需要替换为自己网关端口
 
请求方式:
- POST
 
请求参数:
- Headers:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| X-Authorization-access_token | String | 是 | 系统令牌 | 
- Query:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| id | String | 是 | 主键ID | ||
| status | String | 否 | cancel | 状态 | running-运行中、finish-完成、cancel-取消 | 
- Body:
 
暂无
请求参数示例:
http://192.168.3.230:15100/ibps/business/v3/bpm/task/change/setStatus?id=626866373389189120返回示例:
{
    "state": 200,
    "request": null,
    "message": "取消流程转办代理成功",
    "cause": "",
    "variables": {},
    "data": {}
}返回参数说明:
| 名称 | 类型 | 备注 | 
|---|---|---|
| data | Void | 
是否允许流程任务变更
简述:
- 是否允许【流程任务变更】
 
请求URL:
- http://ip:port/ibps/business/v3/bpm/task/change/allowShfit
 - URL中的ip需要替换为自己网关ip
 - URL中的port需要替换为自己网关端口
 
请求方式:
- POST
 
请求参数:
- Headers:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| X-Authorization-access_token | String | 是 | 系统令牌 | 
- Query:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| taskId | String | 是 | 流程id | 
- Body:
 
暂无
请求参数示例:
http://192.168.3.230:15100/ibps/business/v3/bpm/task/change/allowShfit?taskId=626866373389189120返回示例:
{
    "state": 200,
    "request": null,
    "message": "允许转办",
    "cause": "",
    "variables": {
        "hiddenDelegate": false
    },
    "data": {}
}返回参数说明:
| 名称 | 类型 | 备注 | 
|---|---|---|
| data | Void | 
根据id或任务id查询对象信息
简述:
- 根据id或任务id查询对象信息
 
请求URL:
- http://ip:port/ibps/business/v3/bpm/task/change/edit
 - URL中的ip需要替换为自己网关ip
 - URL中的port需要替换为自己网关端口
 
请求方式:
- GET
 
请求参数:
- Headers:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| X-Authorization-access_token | String | 是 | 系统令牌 | 
- Query:
 
| 名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 | 
|---|---|---|---|---|---|
| id | String | 是 | 流程任务变更id | ||
| taskId | String | 是 | 流程id | 
- Body:
 
暂无
请求参数示例:
http://192.168.3.230:15100/ibps/business/v3/bpm/task/change/edit?id=677184296619868160返回示例:
{
  "state": 200,
  "request": null,
  "message": "",
  "cause": "",
  "variables": {},
  "data": {
    "pk": "",
    "name": null,
    "ip": null,
    "createBy": null,
    "createTime": "2020-02-12 16:08:30",
    "updateBy": null,
    "updateTime": null,
    "tenantId": null,
    "dataStatus": null,
    "dbtype": null,
    "id": "677184296619868160",
    "taskId": "677183859263012865",
    "taskSubject": "管理员在2020-02-12 16:06:51发起分支网关加跳转规则",
    "taskName": "领导审批",
    "procInstId": "677183849335095296",
    "nodeId": "UserTask_059cdtd",
    "changeType": "shift",
    "status": "running",
    "ownerId": "1",
    "executorId": null,
    "comment": "默认转办描述",
    "completeTime": null,
    "cancelTime": null,
    "delBeforeSave": true,
    "bpmTaskChangeAssignPoList": [
      {
        "pk": "",
        "name": null,
        "ip": null,
        "createBy": null,
        "createTime": null,
        "updateBy": null,
        "updateTime": null,
        "tenantId": null,
        "dataStatus": null,
        "dbtype": null,
        "id": "677184296951218176",
        "taskChangeId": "677184296619868160",
        "type": "employee",
        "executor": "664433378967158784",
        "typeName": null,
        "executorName": "664433378967158784"
      }
    ],
    "ownerName": "管理员",
    "executorName": null
  }
}返回参数说明:
| 名称 | 类型 | 备注 | 
|---|---|---|
| data | BpmTaskChangePo | 流程任务对象 | 
备注
- [1] : APIRequest为动态查询请求对象,详情请移步全局请求格式