文档首页/ 工业数字模型驱动引擎/ API参考/ API/ 流程引擎/ 流程实例/ 根据流程实例ID查询关联评审数据列表 - listReviewDatasByInstanceId
更新时间：2026-07-28 GMT+08:00
查看PDF
分享

根据流程实例ID查询关联评审数据列表 - listReviewDatasByInstanceId

功能介绍

本接口用于根据流程实例ID查询关联评审数据列表，适用于获取流程运行过程中基于数据模型填写的评审数据（如设备采购申请单中的设备名称、数量、预算等），这些数据是流程流转和决策的重要依据。

在流程运行过程中，业务人员通过特定流程元模板（如“设备采购申请”），在表单或表格组件中录入具体业务数据并发起审批后，系统将自动生成唯一的流程实例ID。调用本接口时，仅需传入该流程实例ID，即可一键获取该流程运行过程中产生的所有关联评审数据列表。

返回数据包含数据模型标识、模型名称以及用户实际填写的字段详情（如文件名、属性值等），适用于流程详情页展示、数据归档或下游系统集成场景。与根据评审数据模型查询关联的流程实例列表 - listProcessInstancesByReviewModel接口配合，可同时获取流程的操作轨迹和业务数据，完整还原流程实例的全貌。

接口约束

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

  • 仅当流程元模板在“UI编辑”中存在表单或表格组件，且该组件已绑定“数据编辑”中添加的数据模型时，启动并提交流程实例后，才会生成关联的评审数据。

调用方法

请参见如何调用API。

授权信息

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

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

URI

GET /services/workflow/processInstances/{processInstanceId}/reviewDatas

表1 路径参数

参数

是否必选

参数类型

描述

processInstanceId

是

String

参数解释：

流程实例ID，用于唯一标识需要查询评审数据的流程实例。可通过我的任务、我发起的流程等接口获取。

约束限制：

不涉及。

取值范围：

最大长度100字符。

默认取值：

不涉及。

请求参数

表2 请求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服务的获取用户信息接口获取。

约束限制：

仅基础版数据建模引擎-流程引擎需要配置此参数。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

code

String

参数解释：

返回状态码，标识接口调用的执行结果。

注意：本接口使用字符串类型的状态码，与其他接口的Integer类型不同。

取值范围：

  • 200：成功。

  • 500：失败。

message

String

参数解释：

返回信息，描述接口调用的结果说明。当code为“500”时，此字段包含具体的错误描述。

取值范围：

不涉及。

result

Array of ProcessReviewDataVO objects

参数解释：

流程实例评审数据列表，包含该流程实例关联的所有数据模型实例数据。如果流程未配置数据模型或暂无评审数据，返回空数组[]。

取值范围：

不涉及。
表4 ProcessReviewDataVO

参数

参数类型

描述

modelId

String

参数解释：

数据模型的唯一编码，用于标识数据模型的定义。可在流程元模板的“数据编辑”页面查看模型编码。

取值范围：

不涉及。

modelNameEn

String

参数解释：

数据模型的英文名称，用于展示数据模型的标识。与流程元模板中定义的模型名称一致。

取值范围：

不涉及。

fields

Object

参数解释：

数据模型的实例数据。采用动态结构，具体包含的字段由数据模型定义决定。

格式为：Map<String, Object>

取值范围：

由数据模型定义决定，常见字段包括：

  • fileName：文件名（附件类型字段）。

  • size：文件大小或数量（数值类型字段）。

  • ID/Key：业务标识（字符串类型字段）。

  • Modifier：修改人（字符串类型字段，可能为null）。

  • RdmVersion：数据版本（字符串类型字段）。

状态码：400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

result

String

结果。

trace_id

String

追踪ID。

请求示例

GET https://dme.cn-north-4.huaweicloud.cn/workflowRuntime/services/workflow/processInstances/2b263825-e206-11ee-b9f9-7804e3968f51/reviewDatas

响应示例

状态码：200

OK

{
  "code" : "200",
  "message" : "success",
  "result" : [ {
    "modelId" : "DM08545158",
    "modelNameEn" : "DataModel_001",
    "fields" : {
      "fileName" : "Bom.txt",
      "size" : "18",
      "Modifier" : null,
      "RdmVersion" : "1"
    }
  }, {
    "modelId" : "622380088872144896",
    "modelNameEn" : "PropertyModel",
    "fields" : {
      "ID" : "123",
      "Key" : "1",
      "Modifier" : null,
      "RdmVersion" : "1"
    }
  } ]
}

状态码：400

Bad Request

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

状态码

状态码

描述

200

OK

400

Bad Request

错误码

请参见错误码。

父主题： 流程实例

相关文档