# 查询评审记录 - findAllRecord #### 功能介绍 本接口用于根据流程实例ID查询流程引擎中所有任务的评审记录，适用于追溯审批流程的历史操作轨迹，包括评审意见、转审记录、任务完成记录等，支持流程审计和问题回溯。与[获取导航树 - getNavigateTree](https://support.huaweicloud.com/api-idme/getNavigateTree.html)接口配合，可在展示流程节点结构的同时查看各节点的详细操作记录。 #### 接口约束 - 本接口支持基础版和体验版数据建模引擎-流程引擎场景。 - 返回的评审记录按"creationDate"升序排列，即按任务创建时间从早到晚排序。 - 对于已完成的任务，"completeRecords"和"taskRecords"中均会包含该任务记录，但"completeRecords"额外包含审批意见（comment）和操作结论（operation）。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-idme/idme_api_0003.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-idme/idme_api_0017.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI POST /console/servicetask/api/localMethod/assessment_record/findAllRecord #### 请求参数 表1请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** IAM用户的token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（即响应消息头中X-Subject-Token的值）。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | X-Application-Id | 是 | String | **参数解释：** 应用ID。 您可以在应用设计态的"应用中心 \> 应用发布"页面获取，详情请参见[应用发布](https://support.huaweicloud.com/usermanual-idme/idme_usermanual_0085.html)。 **约束限制：** 不涉及。 **取值范围：** 由英文字母和数字组成，且长度为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服务的[获取用户信息](https://support.huaweicloud.com/api-orgid/ShowOauth2UserInfo.html)接口获取。 **约束限制：** 仅基础版数据建模引擎-流程引擎需要配置此参数。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | processInstanceId | 是 | String | **参数解释：** 流程实例ID，用于指定需要查询评审记录的流程实例。可通过[启动流程实例 - startProcessInstance](https://support.huaweicloud.com/api-idme/startProcessInstance.html)接口的响应或[查询流程实例列表 - queryProcessesInstanceList](https://support.huaweicloud.com/api-idme/queryProcessesInstanceList.html)接口获取。 **约束限制：** 不涉及。 **取值范围：** 最大长度100字符。 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | Integer | **参数解释：** 接口返回码，标识接口调用的执行结果。 **取值范围：** - 200：成功。 - 非200：失败，具体错误码请参见[错误码](https://support.huaweicloud.com/api-idme/WorkFlow-Engine-ErrorCode.html)。 | | data | Array of [RenderedTaskInfoVO] objects | **参数解释：** 接口响应数据，包含流程实例的完整评审记录信息，按记录类型分为三类。 **取值范围：** 不涉及。 | | orderID | String | **参数解释：** 请求跟踪流水号，用于唯一标识本次接口请求，便于问题排查和链路追踪。 遇到问题时，请提供此ID联系技术支持。 **取值范围：** 不涉及。 | 表4RenderedTaskInfoVO | 参数 | 参数类型 | 描述 | |:---|:---|:---| | taskRecords | Array of [WfTaskReview] objects | **参数解释：** 所有任务日志记录，包含流程实例中各节点的完整操作日志。包括已完成任务和进行中任务的所有历史记录。 **取值范围：** 不涉及。 | | completeRecords | Array of [WfTaskReview] objects | **参数解释：** 历史审批意见记录，包含已完成的任务审批详情及处理意见。仅包含"state"为"FINISHED"的任务记录，且包含审批意见（comment）和操作结论（operation）。 **取值范围：** 不涉及。 | | transferRecords | Array of [WfTaskReview] objects | **参数解释：** 转审记录，包含任务转审操作的详细信息。当任务从原处理人转交给其他用户时生成此记录。 **取值范围：** 不涉及。 | 表5WfTaskReview | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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](https://support.huaweicloud.com/api-idme/queryTaskList.html)接口返回的ID字段一致。 **取值范围：** 不涉及。 | | ccBy | String | **参数解释：** 抄送人，标识被抄送该任务的用户。多个抄送人可能以逗号分隔。 **取值范围：** 不涉及。 | | ccByUuid | String | **参数解释：** 抄送人UUID，用于唯一标识被抄送该任务的用户。 **取值范围：** 不涉及。 | 表6wfBusinessSeq | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-idme/WorkFlow-Engine-ErrorCode.html)。