文档首页/工业数字模型驱动引擎/API参考/API/流程引擎/流程监控/查询审批历史 - myParticipantProcesses
更新时间：2025-12-30 GMT+08:00
查看PDF
分享

查询审批历史 - myParticipantProcesses

功能介绍

查询审批历史。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /services/workflow/myParticipantProcesses

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

IAM用户的token。

通过调用IAM服务获取用户Token接口获取（即响应消息头中X-Subject-Token的值）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Application-Id

是

String

参数解释：

应用ID。

您可以在应用设计态的“应用中心 > 应用发布”页面获取，详情请参见应用发布。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Tenant-Id

是

String

参数解释：

数据建模引擎运行态租户ID。

您可以从访问流程引擎编排服务的浏览器地址栏中获取。

流程编排服务地址：http://{承载流程编排服务的服务器域名或IP地址}:{流程编排服务的端口号}/{流程编排服务文根}/index.html#/processApplicationForm?tenantId={数据建模引擎运行态租户ID}&applicationId={应用ID}

例如tenantId=-1，表示数据建模引擎运行态默认租户“basicTenant”的租户ID为-1。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-User-Id

是

String

参数解释：

请求当前接口时上下文中的用户ID，即OrgID的用户ID。仅基础版数据建模引擎-流程引擎需要配置此参数。

通过调用OrgID服务的获取用户信息接口获取。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

表2 请求Body参数

参数

是否必选

参数类型

描述

pageSize

否

Integer

参数解释：

分页大小。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

curPage

否

Integer

参数解释：

当前页。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

taskDefinitionName

否

String

参数解释：

任务名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

processDefinitionNameCn

否

String

参数解释：

流程类型中文名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

processInstanceStartTime

否

String

参数解释：

流程创建开始时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

processInstanceEndTime

否

String

参数解释：

流程创建结束时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

processStatus

否

String

参数解释：

流程状态。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

myApproval

否

String

参数解释：

是否为我审批。

约束限制：

不涉及。

取值范围：

  • 1：是。

  • 0：否。

默认取值：

不涉及。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

orderId

String

参数解释：

请求跟踪流水号。

取值范围：

不涉及。

默认取值：

不涉及。

msg

String

参数解释：

接口响应信息。

取值范围：

不涉及。

默认取值：

不涉及。

code

Integer

参数解释：

接口返回码。

取值范围：

不涉及。

默认取值：

不涉及。

data

Array of HistoricProcessInstanceVO objects

参数解释：

接口响应数据。

取值范围：

不涉及。

默认取值：

不涉及。

pageInfo

PageVo object

参数解释：

标准响应体分页信息。

取值范围：

不涉及。

默认取值：

不涉及。

表4 HistoricProcessInstanceVO

参数

参数类型

描述

processInstanceId

String

参数解释：

流程实例ID。

取值范围：

不涉及。

默认取值：

不涉及。

processDefinitionId

String

参数解释：

流程定义ID。

取值范围：

不涉及。

默认取值：

不涉及。

processDefinitionName

String

参数解释：

流程定义英文名称。

取值范围：

不涉及。

默认取值：

不涉及。

processDefinitionNameCn

String

参数解释：

流程定义中文名称。

取值范围：

不涉及。

默认取值：

不涉及。

businessKey

String

参数解释：

业务流水号。

取值范围：

不涉及。

默认取值：

不涉及。

taskDefinitionKey

String

参数解释：

任务节点流水号。

取值范围：

不涉及。

默认取值：

不涉及。

taskDefinitionName

String

参数解释：

任务节点名称。

取值范围：

不涉及。

默认取值：

不涉及。

startTime

String

参数解释：

开始时间。

取值范围：

不涉及。

默认取值：

不涉及。

title

String

参数解释：

流程标题。

取值范围：

不涉及。

默认取值：

不涉及。

state

String

参数解释：

流程实例运行状态。

取值范围：

  • 1：进行中

  • 2：已结束

默认取值：

不涉及。

lifeCycleState

String

参数解释：

生命周期状态。

取值范围：

不涉及。

默认取值：

不涉及。

handlers

String

参数解释：

处理人。

取值范围：

不涉及。

默认取值：

不涉及。

userIds

String

参数解释：

用户ID集合。

取值范围：

不涉及。

默认取值：

不涉及。

lastUpdateDate

String

参数解释：

最后更新时间。

取值范围：

不涉及。

默认取值：

不涉及。

suspensionState

String

参数解释：

流程暂停状态。

取值范围：

  • 1：未挂起

  • 2：已挂起

默认取值：

不涉及。

processInstanceStartTime

String

参数解释：

流程实例开始时间。

取值范围：

不涉及。

默认取值：

不涉及。

processInstanceEndTime

String

参数解释：

流程实例结束时间。

取值范围：

不涉及。

默认取值：

不涉及。

createdBy

String

参数解释：

创建人ID。

取值范围：

不涉及。

默认取值：

不涉及。

createdByName

String

参数解释：

创建人账号。

取值范围：

不涉及。

默认取值：

不涉及。

endTime

String

参数解释：

结束时间。

取值范围：

不涉及。

默认取值：

不涉及。

tenantId

String

参数解释：

租户ID。

取值范围：

不涉及。

默认取值：

不涉及。

userId

String

参数解释：

用户ID。

取值范围：

不涉及。

默认取值：

不涉及。

createStartTime

String

参数解释：

创建开始时间。

取值范围：

不涉及。

默认取值：

不涉及。

createEndTime

String

参数解释：

创建结束时间。

取值范围：

不涉及。

默认取值：

不涉及。

createTaskTime

String

参数解释：

任务创建时间。

取值范围：

不涉及。

默认取值：

不涉及。

completeStartTime

String

参数解释：

审批结束的开始时间。

取值范围：

不涉及。

默认取值：

不涉及。

category

String

参数解释：

流程类型。

取值范围：

不涉及。

默认取值：

不涉及。

completeEndTime

String

参数解释：

审批结束的结束时间。

取值范围：

不涉及。

默认取值：

不涉及。

transferSign

String

参数解释：

代办标志。

取值范围：

  • 0：我的待办。

  • 1：可转审的。

默认取值：

不涉及。

taskId

String

参数解释：

任务ID。

取值范围：

不涉及。

默认取值：

不涉及。

startUserId

String

参数解释：

启动用户ID。

取值范围：

不涉及。

默认取值：

不涉及。

startUserName

String

参数解释：

启动用户名称。

取值范围：

不涉及。

默认取值：

不涉及。

taskUrl

String

参数解释：

任务的URL。

取值范围：

不涉及。

默认取值：

不涉及。

groupIds

String

参数解释：

群组ID。

取值范围：

不涉及。

默认取值：

不涉及。

lookUpId

String

参数解释：

LookUp ID。

取值范围：

不涉及。

默认取值：

不涉及。

filterResult

Array of strings

参数解释：

定制返回结果。

取值范围：

不涉及。

默认取值：

不涉及。

groupIdList

Array of strings

参数解释：

群组ID集合。

取值范围：

不涉及。

默认取值：

不涉及。

sequenceCount

Integer

参数解释：

序列数。

取值范围：

不涉及。

默认取值：

不涉及。

lastUpdateBy

String

参数解释：

最后更新人。

取值范围：

不涉及。

默认取值：

不涉及。

lastUpdateName

String

参数解释：

最后更新人名称。

取值范围：

不涉及。

默认取值：

不涉及。

operationState

String

参数解释：

流程操作状态。

取值范围：

  • 0：初始化

  • 1：已处理

  • 2：已取消

  • 3：已回收

  • 4：已转审

  • 5：转审给我的

默认取值：

不涉及。

site

String

参数解释：

引擎站点标识。

取值范围：

不涉及。

默认取值：

不涉及。

dueDate

String

参数解释：

截止日期。

取值范围：

不涉及。

默认取值：

不涉及。

表5 PageVo

参数

参数类型

描述

totalRows

Integer

参数解释：

数据总数。

取值范围：

不涉及。

默认取值：

不涉及。

curPage

Integer

参数解释：

当前页。

取值范围：

不涉及。

默认取值：

不涉及。

pageSize

Integer

参数解释：

页大小。

取值范围：

不涉及。

默认取值：

不涉及。

totalPages

Integer

参数解释：

总页数。

取值范围：

不涉及。

默认取值：

不涉及。

请求示例

https://dme.cn-north-4.huaweicloud.cn/workflowRuntime/services/workflow/myParticipantProcesses

{
  "processDefinitionNameCn" : "流程模板",
  "processInstanceStartTime" : 1712505600000,
  "processInstanceEndTime" : 1712678400000,
  "timeRange" : [ 1712505600000, 1712678400000 ],
  "processStatus" : "COMPLETED",
  "myApproval" : "1",
  "curPage" : 1,
  "pageSize" : 20
}

响应示例

状态码：200

OK

{
  "msg" : null,
  "code" : 0,
  "data" : [ {
    "processInstanceId" : "dc2b0486-a096-11ef-bed0-fa163e3e9614",
    "processDefinitionId" : "Test_lyd_1028_01:2:10c2ab292ccc4351b6b67d311ece2ba3",
    "processDefinitionName" : "Test_lyd_1028_01",
    "processDefinitionNameCn" : "测试驳回routers",
    "businessKey" : "P10019860",
    "taskDefinitionKey" : "Activity_0rbig2k",
    "taskDefinitionName" : "用户任务1",
    "startTime" : "2024-11-12T01:38:47.281+0000",
    "title" : "Test_lyd_1028_01_2024-11-12T09:38:47.006+0800",
    "state" : "COMPLETED",
    "lifeCycleState" : "Cancelled",
    "handlers" : "u.basic_admin",
    "userIds" : "548985778c8d4b7c860066b19a38d17c",
    "lastUpdateDate" : "2024-11-12T01:40:41.131+0000",
    "suspensionState" : "1",
    "processInstanceStartTime" : "2024-11-12T01:38:47.114+0000",
    "processInstanceEndTime" : "2024-11-12T01:40:41.131+0000",
    "createdBy" : "548985778c8d4b7c860066b19a38d17c",
    "createdByName" : "548985778c8d4b7c860066b19a38d17c",
    "endTime" : "2024-11-12T01:40:41.131+0000",
    "tenantId" : "10000243",
    "userId" : null,
    "createStartTime" : null,
    "createEndTime" : null,
    "createTaskTime" : "2024-11-12T01:38:47.281+0000",
    "completeStartTime" : null,
    "category" : "http://bpmn.io/schema/bpmn",
    "completeEndTime" : null,
    "transferSign" : null,
    "taskId" : "dc44f53b-a096-11ef-bed0-fa163e3e9614",
    "startUserId" : "548985778c8d4b7c860066b19a38d17c",
    "startUserName" : "548985778c8d4b7c860066b19a38d17c",
    "taskUrl" : null,
    "groupIds" : "",
    "lookUpId" : null,
    "filterResult" : null,
    "groupIdList" : null,
    "sequenceCount" : 1,
    "lastUpdateBy" : "548985778c8d4b7c860066b19a38d17c",
    "lastUpdateName" : "basic_admin",
    "operationState" : "2",
    "site" : null,
    "dueDate" : null,
    "processStatus" : "INTERNALLY_TERMINATED"
  } ],
  "pageInfo" : {
    "totalRows" : 1,
    "curPage" : 1,
    "pageSize" : 20,
    "totalPages" : 1
  },
  "orderID" : "629a38e0-f0a6-452a-b2c6-1ea4113ebaf3"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题：流程监控

相关文档