本文导读

功能介绍
URI
请求头
请求参数
响应参数
请求示例
响应示例
状态码
错误码

展开导读

文档首页/ 硬件开发工具链平台云服务/ 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

上一篇：查询流程实例列表

下一篇：查询我的申请单草稿

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

查询任务列表

功能介绍

URI

请求头

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线

文档反馈