查询评审记录 - findAllRecord
功能介绍
本接口用于根据流程实例ID查询流程引擎中所有任务的评审记录,适用于追溯审批流程的历史操作轨迹,包括评审意见、转审记录、任务完成记录等,支持流程审计和问题回溯。与获取导航树 - getNavigateTree接口配合,可在展示流程节点结构的同时查看各节点的详细操作记录。
接口约束
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
POST /console/servicetask/api/localMethod/assessment_record/findAllRecord
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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服务的获取用户信息接口获取。 约束限制: 仅基础版数据建模引擎-流程引擎需要配置此参数。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| processInstanceId | 是 | String | 参数解释: 流程实例ID,用于指定需要查询评审记录的流程实例。可通过启动流程实例 - startProcessInstance接口的响应或查询流程实例列表 - queryProcessesInstanceList接口获取。 约束限制: 不涉及。 取值范围: 最大长度100字符。 默认取值: 不涉及。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | Integer | 参数解释: 接口返回码,标识接口调用的执行结果。 取值范围:
|
| data | Array of RenderedTaskInfoVO objects | 参数解释: 接口响应数据,包含流程实例的完整评审记录信息,按记录类型分为三类。 取值范围: 不涉及。 |
| orderID | String | 参数解释: 请求跟踪流水号,用于唯一标识本次接口请求,便于问题排查和链路追踪。 遇到问题时,请提供此ID联系技术支持。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| taskRecords | Array of WfTaskReview objects | 参数解释: 所有任务日志记录,包含流程实例中各节点的完整操作日志。包括已完成任务和进行中任务的所有历史记录。 取值范围: 不涉及。 |
| completeRecords | Array of WfTaskReview objects | 参数解释: 历史审批意见记录,包含已完成的任务审批详情及处理意见。仅包含“state”为“FINISHED”的任务记录,且包含审批意见(comment)和操作结论(operation)。 取值范围: 不涉及。 |
| transferRecords | Array of WfTaskReview objects | 参数解释: 转审记录,包含任务转审操作的详细信息。当任务从原处理人转交给其他用户时生成此记录。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| lastUpdateDate | Integer | 参数解释: 最后更新时间,标识评审记录的最后修改时间。格式为yyyy-MM-dd HH:mm:ss。 取值范围: 不涉及。 |
| type | Integer | 参数解释: 任务类型,标识当前记录的操作类型。用于区分不同的流程操作行为。 取值范围: |
| wfBusinessSeq | wfBusinessSeq object | 参数解释: 申请单信息,包含当前任务关联的业务申请单详情。 取值范围: 不涉及。 |
| originalHandler | String | 参数解释: 原始处理人,标识任务最初分配的处理人。在转审场景下,此字段记录任务最初的负责人。 取值范围: 不涉及。 |
| lastUpdateUserCN | String | 参数解释: 最后更新人名称,标识最后修改该记录的用户。 取值范围: 不涉及。 |
| originalHandlerUuid | String | 参数解释: 原始处理人UUID,用于唯一标识任务最初分配的处理人。 取值范围: 不涉及。 |
| assigneeUuid | String | 参数解释: 当前处理人UUID,用于在分布式系统中唯一标识处理人。 取值范围: 不涉及。 |
| id | String | 参数解释: 业务ID,用于唯一标识业务对象实例。 取值范围: 不涉及。 |
| state | String | 参数解释: 任务状态,标识当前任务的处理状态。 取值范围: |
| 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 | 参数解释: 操作类型,标识当前记录的业务对象类型。 取值范围: |
| taskId | String | 参数解释: 任务ID,用于唯一标识当前任务。与查询任务列表 - queryTaskList接口返回的ID字段一致。 取值范围: 不涉及。 |
| ccBy | String | 参数解释: 抄送人,标识被抄送该任务的用户。多个抄送人可能以逗号分隔。 取值范围: 不涉及。 |
| ccByUuid | String | 参数解释: 抄送人UUID,用于唯一标识被抄送该任务的用户。 取值范围: 不涉及。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| className | String | 参数解释: 实体名称,标识业务对象的类全限定名。 取值范围: 不涉及。 |
| id | Integer | 参数解释: 业务ID,用于唯一标识业务对象实例。 取值范围: 不涉及。 |
| clazz | String | 参数解释: 数据实例的实体名称,用于标识业务数据的实体类型。与“className”通常一致。 取值范围: 不涉及。 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 |
错误码
请参见错误码。