更新时间:2026-07-28 GMT+08:00
分享

查询评审记录 - findAllRecord

功能介绍

本接口用于根据流程实例ID查询流程引擎中所有任务的评审记录,适用于追溯审批流程的历史操作轨迹,包括评审意见、转审记录、任务完成记录等,支持流程审计和问题回溯。与获取导航树 - getNavigateTree接口配合,可在展示流程节点结构的同时查看各节点的详细操作记录。

接口约束

  • 本接口支持基础版和体验版数据建模引擎-流程引擎场景。

  • 返回的评审记录按“creationDate”升序排列,即按任务创建时间从早到晚排序。

  • 对于已完成的任务,“completeRecords”和“taskRecords”中均会包含该任务记录,但“completeRecords”额外包含审批意见(comment)和操作结论(operation)。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

POST /console/servicetask/api/localMethod/assessment_record/findAllRecord

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

IAM用户的token。

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

X-Application-Id

String

参数解释:

应用ID。

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

约束限制:

不涉及。

取值范围:

由英文字母和数字组成,且长度为32个字符。

默认取值:

不涉及。

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参数

参数

是否必选

参数类型

描述

processInstanceId

String

参数解释:

流程实例ID,用于指定需要查询评审记录的流程实例。可通过启动流程实例 - startProcessInstance接口的响应或查询流程实例列表 - queryProcessesInstanceList接口获取。

约束限制:

不涉及。

取值范围:

最大长度100字符。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

code

Integer

参数解释:

接口返回码,标识接口调用的执行结果。

取值范围:

  • 200:成功。

  • 非200:失败,具体错误码请参见错误码

data

Array of RenderedTaskInfoVO objects

参数解释:

接口响应数据,包含流程实例的完整评审记录信息,按记录类型分为三类。

取值范围:

不涉及。

orderID

String

参数解释:

请求跟踪流水号,用于唯一标识本次接口请求,便于问题排查和链路追踪。

遇到问题时,请提供此ID联系技术支持。

取值范围:

不涉及。

表4 RenderedTaskInfoVO

参数

参数类型

描述

taskRecords

Array of WfTaskReview objects

参数解释:

所有任务日志记录,包含流程实例中各节点的完整操作日志。包括已完成任务和进行中任务的所有历史记录。

取值范围:

不涉及。

completeRecords

Array of WfTaskReview objects

参数解释:

历史审批意见记录,包含已完成的任务审批详情及处理意见。仅包含“state”为“FINISHED”的任务记录,且包含审批意见(comment)和操作结论(operation)。

取值范围:

不涉及。

transferRecords

Array of WfTaskReview objects

参数解释:

转审记录,包含任务转审操作的详细信息。当任务从原处理人转交给其他用户时生成此记录。

取值范围:

不涉及。

表5 WfTaskReview

参数

参数类型

描述

lastUpdateDate

Integer

参数解释:

最后更新时间,标识评审记录的最后修改时间。格式为yyyy-MM-dd HH:mm:ss。

取值范围:

不涉及。

type

Integer

参数解释:

任务类型,标识当前记录的操作类型。用于区分不同的流程操作行为。

取值范围:

  • 1:评审(正常审批操作)。

  • 2:取消(任务被取消)。

  • 3:回收(任务被回收重新分配)。

  • 4:转审(任务转交给其他处理人)。

  • 5:工作中任务(任务正在处理中)。

  • 6:自动完成任务(系统自动处理的任务)。

wfBusinessSeq

wfBusinessSeq object

参数解释:

申请单信息,包含当前任务关联的业务申请单详情。

取值范围:

不涉及。

originalHandler

String

参数解释:

原始处理人,标识任务最初分配的处理人。在转审场景下,此字段记录任务最初的负责人。

取值范围:

不涉及。

lastUpdateUserCN

String

参数解释:

最后更新人名称,标识最后修改该记录的用户。

取值范围:

不涉及。

originalHandlerUuid

String

参数解释:

原始处理人UUID,用于唯一标识任务最初分配的处理人。

取值范围:

不涉及。

assigneeUuid

String

参数解释:

当前处理人UUID,用于在分布式系统中唯一标识处理人。

取值范围:

不涉及。

id

String

参数解释:

业务ID,用于唯一标识业务对象实例。

取值范围:

不涉及。

state

String

参数解释:

任务状态,标识当前任务的处理状态。

取值范围:

  • DOING:正在处理(任务已分配但尚未完成)。

  • FINISHED:已完成(任务已处理完毕)。

processInstanceId

String

参数解释:

流程实例ID,标识当前评审记录所属的流程实例。与请求参数中的“processInstanceId”一致。

取值范围:

不涉及。

creator

String

参数解释:

指派人,标识分配该任务的用户。通常为流程引擎或上一节点的处理人。

取值范围:

不涉及。

holdableList

Array of strings

参数解释:

表单集合,包含当前任务关联的业务模型类全限定名列表。用于标识任务关联的数据模型。

取值范围:

不涉及。

holderId

Integer

参数解释:

表单Holder ID,用于唯一标识表单数据持有者。

取值范围:

不涉及。

businessKey

String

参数解释:

业务流水号,用于关联外部业务系统的业务标识。

取值范围:

不涉及。

comment

String

参数解释:

审批意见,记录任务处理人的评审备注信息。仅在“completeRecords”中存在,为空表示未填写审批意见。

取值范围:

不涉及。

taskName

String

参数解释:

任务名称,用于展示当前任务的标题。可在流程元模板中配置各节点的任务名称。

取值范围:

不涉及。

assignee

String

参数解释:

当前处理人,标识当前负责处理该任务的用户。格式通常为u.{userId}或用户中文名。

取值范围:

不涉及。

nodeId

String

参数解释:

节点ID,标识当前任务在流程模型中的节点定义标识。与流程元模板中的节点ID一致。

取值范围:

不涉及。

holderType

String

参数解释:

操作类型,标识当前记录的业务对象类型。

取值范围:

  • business:申请单级别操作。

  • task:任务级别操作。

taskId

String

参数解释:

任务ID,用于唯一标识当前任务。与查询任务列表 - queryTaskList接口返回的ID字段一致。

取值范围:

不涉及。

ccBy

String

参数解释:

抄送人,标识被抄送该任务的用户。多个抄送人可能以逗号分隔。

取值范围:

不涉及。

ccByUuid

String

参数解释:

抄送人UUID,用于唯一标识被抄送该任务的用户。

取值范围:

不涉及。

表6 wfBusinessSeq

参数

参数类型

描述

className

String

参数解释:

实体名称,标识业务对象的类全限定名。

取值范围:

不涉及。

id

Integer

参数解释:

业务ID,用于唯一标识业务对象实例。

取值范围:

不涉及。

clazz

String

参数解释:

数据实例的实体名称,用于标识业务数据的实体类型。与“className”通常一致。

取值范围:

不涉及。

状态码:400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

result

String

结果。

trace_id

String

追踪ID。

请求示例

POST https://dme.cn-north-4.huaweicloud.cn/workflowRuntime/console/servicetask/api/localMethod/assessment_record/findAllRecord

{
  "processInstanceId" : "c47ad3e7-94fb-11ee-a252-7804e3968f51"
}

响应示例

状态码:200

OK

{
  "code" : 0,
  "data" : {
    "transferRecords" : [ ],
    "completeRecords" : [ {
      "lastUpdateDate" : "2023-11-11 10:33:05",
      "type" : 1,
      "currentUserId" : 0,
      "scope" : null,
      "assigneeUuid" : "1008600000011707713",
      "rowIdx" : -1,
      "id" : "564759616731258880",
      "state" : "FINISHED",
      "processInstanceId" : "88a1d676-803a-11ee-8fd1-7804e3968f51",
      "creator" : "hid_fje4j2nvnue3xwp",
      "appName" : "WfWorkflowDemoService",
      "entityType" : "task",
      "holdableList" : [ "com.huawei.it.plm.workflow.framework.model.WfFormData", "com.huawei.it.plm.workflow.framework.model.WfAttachment", "com.huawei.it.plm.workflow.framework.model.WfBusinessObject" ],
      "creationDate" : "2023-11-11 10:33:05",
      "holderId" : 564759616731258900,
      "taskStartTime" : "2023-11-11 10:32:18",
      "assigneeCompleteUid" : "dali",
      "businessKey" : "P10001238",
      "ccBy" : "",
      "comment" : "1111111",
      "taskName" : "用户任务",
      "assignee" : "hid_fje4j2nvnue3xwp",
      "ccByUuid" : "",
      "nodeId" : "Activity_1r07gjk",
      "operation" : "ok",
      "holderType" : "task",
      "taskId" : "88e6a7b1-803a-11ee-8fd1-7804e3968f51",
      "taskEndTime" : "2023-11-11 10:33:01"
    }, {
      "lastUpdateDate" : "2023-11-11 10:32:26",
      "type" : 1,
      "currentUserId" : 0,
      "scope" : null,
      "assigneeUuid" : "1008600000011707713",
      "rowIdx" : -1,
      "id" : "564759452041912320",
      "state" : "FINISHED",
      "processInstanceId" : "88a1d676-803a-11ee-8fd1-7804e3968f51",
      "creator" : "hid_fje4j2nvnue3xwp",
      "appName" : "WfWorkflowDemoService",
      "entityType" : "task",
      "holdableList" : [ "com.huawei.it.plm.workflow.framework.model.WfFormData", "com.huawei.it.plm.workflow.framework.model.WfAttachment", "com.huawei.it.plm.workflow.framework.model.WfBusinessObject" ],
      "creationDate" : "2023-11-11 10:32:26",
      "holderId" : 564759452041912300,
      "taskStartTime" : "2023-11-11 10:32:18",
      "assigneeCompleteUid" : "dali",
      "businessKey" : "P10001238",
      "ccBy" : "",
      "comment" : "",
      "taskName" : "start",
      "assignee" : "hid_fje4j2nvnue3xwp",
      "ccByUuid" : "",
      "nodeId" : "StartEvent_1",
      "operation" : "ok",
      "holderType" : "task",
      "taskId" : "3559641652775904",
      "taskEndTime" : "2023-11-11 10:32:18"
    } ],
    "taskRecords" : [ {
      "lastUpdateDate" : "2023-11-11 10:33:05",
      "type" : 1,
      "currentUserId" : 0,
      "scope" : null,
      "assigneeUuid" : "1008600000011707713",
      "rowIdx" : -1,
      "id" : "564759616731258880",
      "state" : "FINISHED",
      "processInstanceId" : "88a1d676-803a-11ee-8fd1-7804e3968f51",
      "creator" : "hid_fje4j2nvnue3xwp",
      "appName" : "WfWorkflowDemoService",
      "entityType" : "task",
      "holdableList" : [ "com.huawei.it.plm.workflow.framework.model.WfFormData", "com.huawei.it.plm.workflow.framework.model.WfAttachment", "com.huawei.it.plm.workflow.framework.model.WfBusinessObject" ],
      "creationDate" : "2023-11-11 10:33:05",
      "holderId" : 564759616731258900,
      "taskStartTime" : "2023-11-11 10:32:18",
      "assigneeCompleteUid" : "dali",
      "businessKey" : "P10001238",
      "ccBy" : "",
      "comment" : "1111111",
      "taskName" : "用户任务",
      "assignee" : "hid_fje4j2nvnue3xwp",
      "ccByUuid" : "",
      "nodeId" : "Activity_1r07gjk",
      "operation" : "ok",
      "holderType" : "task",
      "taskId" : "88e6a7b1-803a-11ee-8fd1-7804e3968f51",
      "taskEndTime" : "2023-11-11 10:33:01"
    }, {
      "lastUpdateDate" : "2023-11-11 10:32:26",
      "type" : 1,
      "currentUserId" : 0,
      "scope" : null,
      "assigneeUuid" : "1008600000011707713",
      "rowIdx" : -1,
      "id" : "564759452041912320",
      "state" : "FINISHED",
      "processInstanceId" : "88a1d676-803a-11ee-8fd1-7804e3968f51",
      "creator" : "hid_fje4j2nvnue3xwp",
      "appName" : "WfWorkflowDemoService",
      "entityType" : "task",
      "holdableList" : [ "com.huawei.it.plm.workflow.framework.model.WfFormData", "com.huawei.it.plm.workflow.framework.model.WfAttachment", "com.huawei.it.plm.workflow.framework.model.WfBusinessObject" ],
      "creationDate" : "2023-11-11 10:32:26",
      "holderId" : 564759452041912300,
      "taskStartTime" : "2023-11-11 10:32:18",
      "assigneeCompleteUid" : "dali",
      "businessKey" : "P10001238",
      "ccBy" : "",
      "comment" : "",
      "taskName" : "start",
      "assignee" : "hid_fje4j2nvnue3xwp",
      "ccByUuid" : "",
      "nodeId" : "StartEvent_1",
      "operation" : "ok",
      "holderType" : "task",
      "taskId" : "3559641652775904",
      "taskEndTime" : "2023-11-11 10:32:18"
    } ]
  },
  "orderID" : "e1041ea1230c412fa7740308d77ce641"
}

状态码:400

Bad Request

{
  "error_code" : "500",
  "error_msg" : "origin is not allowed!",
  "result" : "FAIL",
  "trace_id" : "2509bee60b3e40asdf9f741d9e23466a9"
}

状态码

状态码

描述

200

OK

400

Bad Request

错误码

请参见错误码

相关文档