文档首页/ 硬件开发工具链平台云服务/ API参考/ IPDCenter基础服务API/ 流程定义API/ 查询任务列表
更新时间：2025-03-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询任务列表

功能介绍

查询任务列表。

URI

POST /services/workflow/queryTaskList/{pageSize}/{curPage}

示例接口地址：{域名（有文根需带文根）}/pdmcore/ipdcworkflowservice/services/workflow/queryTaskList/2/1

表1 路径参数

参数

是否必选

参数类型

描述

pageSize

是

String

分页大小

curPage

是

String

当前页数

请求头

使用机机认证调用接口时需传入header：Authorization，其值为机机鉴权token。

请求参数

表2 请求body，筛选条件

参数

是否必选

参数类型

描述

processInstanceStartTime

否

String

流程创建开始时间

processInstanceEndTime

否

String

流程创建结束时间

createStartTime

否

String

任务启动开始时间

createEndTime

否

String

任务启动结束时间

processDefinitionId

否

String

流程模板ID

businessKeys

否

String

业务流水号，多个以逗号隔开

processDefinitionName

否

String

流程模板名称

processDefinitionNameCn

否

String

流程模板名称中文

processDefinitionNames

否

String

流程模板名称

taskDefinitionKey

否

String

任务定义编码

taskDefinitionName

否

String

任务定义名称

pageSize

否

Integer

每页的条数

curPage

否

Integer

当前页数

businessKey

否

String

业务流水号

i18n

否

Integer

国际化标识

title

否

String

流程标题

titleCn

否

String

流程标题中文

titles

否

Array of strings

流程标题列表

createdBy

否

String

创建人

category

否

String

流程类型

lastUpdateName

否

String

最后修改人

taskHandler

否

String

任务处理人

requestSource

否

String

请求源

startUserId

否

String

发起流程的用户

lifeCycleState

否

String

生命周期状态

sites

否

String

站点查询

state

否

String

状态

userId

否

String

用户

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

orderId

String

请求跟踪流水号

msg

String

接口响应信息

code

Integer

接口返回码

data

Array of HistoricProcessInstanceVO objects

接口响应数据，JSON对象或数组

pageInfo

PageVo object

标准响应体分页信息
表4 HistoricProcessInstanceVO

参数

参数类型

描述

processInstanceId

String

流程实例ID

processDefinitionId

String

流程定义ID(拼接字段:流程模板key+版本+流程实例ID)

processDefinitionName

String

流程模板ID

processDefinitionNameCn

String

流程模板名称

businessKey

String

业务流水号

taskDefinitionKey

String

任务节点流水号

taskDefinitionName

String

任务节点名称

startTime

String

开始时间

title

String

流程标题

state

String

流程实例运行状态

lifeCycleState

String

生命周期状态

handlers

String

处理人

userIds

String

用户ID集合

lastUpdateDate

String

最后更新时间

suspensionState

String

流程暂停状态

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

filterResult

Array of strings

定制返回结果

groupIdList

Array of strings

group ID集合

sequenceCount

Integer

序列数

lastUpdateBy

String

最后更新人

lastUpdateName

String

最后更新人名称

operationState

String

流程操作状态

site

String

引擎站点标识

dueDate

String

截止日期

groupIds

String

-

lookUpId

String

-

processStatus

String

-
表5 PageVo

参数

参数类型

描述

totalRows

Integer

总共有多少条数据

curPage

Integer

当前是第几页

pageSize

Integer

一页有多少条数据

totalPages

Integer

总共有多少页

请求示例

入参包含userId则查对应user的任务，不包含则查当前登录用户的任务

{ 
  "userId" : "1008600000065234815" 
}

响应示例

{
    "msg": null,
    "code": 0,
    "data": [
        {
            "processInstanceId": "f6483177-0a16-11f0-8e03-d24aa7462b46",
            "processDefinitionId": "Test20250326001:1:88c99420548b4f3bb3104329d136c35d",
            "processDefinitionName": "Test20250326001",
            "processDefinitionNameCn": "测试20250326001",
            "businessKey": "P10000031",
            "taskDefinitionKey": "Activity_0sqf3co",
            "taskDefinitionName": "用户任务001",
            "startTime": "2025-03-26T07:50:18.775+0000",
            "title": "Test20250326001_2025-03-26T15:50:18.552+0800",
            "state": "ACTIVE",
            "lifeCycleState": null,
            "handlers": "u.sysadmin",
            "userIds": "1000001",
            "lastUpdateDate": "2025-03-26T07:50:18.775+0000",
            "suspensionState": "1",
            "processInstanceStartTime": "2025-03-26T07:50:18.598+0000",
            "processInstanceEndTime": null,
            "createdBy": "sysadmin",
            "createdByName": "1000001",
            "endTime": null,
            "tenantId": "10000001",
            "userId": null,
            "createStartTime": null,
            "createEndTime": null,
            "createTaskTime": "2025-03-26T07:50:18.775+0000",
            "completeStartTime": null,
            "category": "http://bpmn.io/schema/bpmn",
            "completeEndTime": null,
            "transferSign": null,
            "taskId": "f6635aac-0a16-11f0-8e03-d24aa7462b46",
            "startUserId": "1000001",
            "startUserName": "1000001",
            "taskUrl": null,
            "groupIds": "",
            "lookUpId": null,
            "filterResult": null,
            "groupIdList": null,
            "sequenceCount": 1,
            "lastUpdateBy": "1000001",
            "lastUpdateName": "sysadmin",
            "operationState": null,
            "site": null,
            "dueDate": null,
            "processStatus": null
        },
        {
            "processInstanceId": "1a63945f-0a15-11f0-8e03-d24aa7462b46",
            "processDefinitionId": "Test20250326001:1:88c99420548b4f3bb3104329d136c35d",
            "processDefinitionName": "Test20250326001",
            "processDefinitionNameCn": "测试20250326001",
            "businessKey": "P10000030",
            "taskDefinitionKey": "Activity_0sqf3co",
            "taskDefinitionName": "用户任务001",
            "startTime": "2025-03-26T07:37:00.425+0000",
            "title": "Test20250326001_2025-03-26T15:37:00.131+0800",
            "state": "ACTIVE",
            "lifeCycleState": null,
            "handlers": "u.sysadmin",
            "userIds": "1000001",
            "lastUpdateDate": "2025-03-26T07:37:00.425+0000",
            "suspensionState": "1",
            "processInstanceStartTime": "2025-03-26T07:37:00.181+0000",
            "processInstanceEndTime": null,
            "createdBy": "sysadmin",
            "createdByName": "1000001",
            "endTime": null,
            "tenantId": "10000001",
            "userId": null,
            "createStartTime": null,
            "createEndTime": null,
            "createTaskTime": "2025-03-26T07:37:00.425+0000",
            "completeStartTime": null,
            "category": "http://bpmn.io/schema/bpmn",
            "completeEndTime": null,
            "transferSign": null,
            "taskId": "1a88cfb4-0a15-11f0-8e03-d24aa7462b46",
            "startUserId": "1000001",
            "startUserName": "1000001",
            "taskUrl": null,
            "groupIds": "",
            "lookUpId": null,
            "filterResult": null,
            "groupIdList": null,
            "sequenceCount": 1,
            "lastUpdateBy": "1000001",
            "lastUpdateName": "sysadmin",
            "operationState": null,
            "site": null,
            "dueDate": null,
            "processStatus": null
        }
    ],
    "pageInfo": {
        "totalRows": 12,
        "curPage": 1,
        "pageSize": 2,
        "totalPages": 6
    },
    "orderID": "4243cc3f-9ef6-42ae-a447-cad138df89fe"
}

状态码

状态码

描述

200

带分页的标准响应体

错误码

请参见错误码。

父主题： 流程定义API

相关文档