更新时间:2025-06-23 GMT+08:00
分享

查询复杂流程图数据

功能介绍

通过流程实例ID查询复杂流程图数据。

URI

GET /services/workflow/processInstance/queryActInstInfoByProcId

表1 Query参数

参数

是否必选

参数类型

描述

processInstanceId

String

参数解释:

流程实例ID,可通过我的任务、我发起的流程等接口获取。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

IAM用户的token。

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

X-Application-Id

String

参数解释:

应用ID。

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

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

参数解释:

返回状态。

取值范围:

  • 200:成功。

  • 500:失败。

默认取值:

200。

message

String

参数解释:

流程实例ID。

取值范围:

不涉及。

默认取值:

不涉及。

result

Array of objects

参数解释:

返回响应数据列表。

取值范围:

不涉及。

默认取值:

不涉及。

resultObj

ActInstanceResult object

参数解释:

返回单个响应数据。

取值范围:

不涉及。

默认取值:

不涉及。

i18n

Array of I18nDisplay objects

参数解释:

返回响应的国际化信息。

取值范围:

不涉及。

默认取值:

不涉及。

site

String

参数解释:

站点信息。

取值范围:

不涉及。

默认取值:

不涉及。

表4 ActInstanceResult

参数

参数类型

描述

routeList

Array of strings

参数解释:

流程中的路由信息列表。

取值范围:

不涉及。

默认取值:

不涉及。

activityInfo

Array of ActivityInfoVO objects

参数解释:

流程中节点详细信息列表。

取值范围:

不涉及。

默认取值:

不涉及。

processDefinitionId

String

参数解释:

该流程的流程模板Key+版本+流程实例ID。

取值范围:

不涉及。

默认取值:

不涉及。

processDefinitionKey

String

参数解释:

该流程的流程模板ID。

取值范围:

不涉及。

默认取值:

不涉及。

i18n

Array of I18nDisplay objects

参数解释:

国际化信息列表。

取值范围:

不涉及。

默认取值:

不涉及。

表5 ActivityInfoVO

参数

参数类型

描述

dueDate

DateTime

参数解释:

流程节点的截止日期。

取值范围:

不涉及。

默认取值:

不涉及。

followUpDate

DateTime

参数解释:

流程节点的跟进日期。

取值范围:

不涉及。

默认取值:

不涉及。

description

String

参数解释:

流程节点的描述信息。

取值范围:

不涉及。

默认取值:

不涉及。

taskDefineKey

String

参数解释:

流程节点ID。

取值范围:

不涉及。

默认取值:

不涉及。

taskDefineName

String

参数解释:

流程节点名。

取值范围:

不涉及。

默认取值:

不涉及。

startTime

DateTime

参数解释:

流程节点的开始时间。

取值范围:

不涉及。

默认取值:

不涉及。

endTime

DateTime

参数解释:

流程节点的结束时间。

取值范围:

不涉及。

默认取值:

不涉及。

operationType

String

参数解释:

流程节点的操作类型。

取值范围:

不涉及。

默认取值:

不涉及。

userAccount

String

参数解释:

流程节点操作人的Account。

取值范围:

不涉及。

默认取值:

不涉及。

userCN

String

参数解释:

流程节点操作人的中文名。

取值范围:

不涉及。

默认取值:

不涉及。

userId

String

参数解释:

流程节点操作人的用户ID。

取值范围:

不涉及。

默认取值:

不涉及。

type

String

参数解释:

流程节点的类型。

取值范围:

不涉及。

默认取值:

不涉及。

subProInstId

String

参数解释:

流程节点子流程实例ID。

取值范围:

不涉及。

默认取值:

不涉及。

status

String

参数解释:

流程节点状态。

取值范围:

不涉及。

默认取值:

不涉及。

nodeOptCount

Integer

参数解释:

流程节点操作次数。

取值范围:

不涉及。

默认取值:

不涉及。

表6 I18nDisplay

参数

参数类型

描述

key

String

参数解释:

国际化数据key值。

取值范围:

不涉及。

默认取值:

不涉及。

value

String

参数解释:

国际化数据key对应的value值。

取值范围:

不涉及。

默认取值:

不涉及。

请求示例

响应示例

状态码:200

OK

{
  "code" : 200,
  "message" : "success",
  "resultObj" : null,
  "routeList" : [ null ],
  "activityInfo" : [ {
    "taskDefineKey" : "StartEvent_1",
    "startTime" : "2024-11-28T06:57:50.793+0000",
    "endTime" : "2024-11-28T06:57:50.793+0000",
    "operationType" : "Create",
    "userAccount" : "XDM_Developer",
    "userCN" : null,
    "userId" : "93172bbfd0f64437956d4c9de9345386",
    "type" : "startEvent",
    "status" : "finished",
    "nodeOptCount" : 1
  }, {
    "taskDefineKey" : "SubmitTask_1",
    "taskDefineName" : "提交任务",
    "startTime" : "2024-11-28T06:57:50.794+0000",
    "endTime" : "2024-11-28T06:57:50.968+0000",
    "operationType" : "Complete",
    "userAccount" : "XDM_Developer",
    "userCN" : null,
    "userId" : "93172bbfd0f64437956d4c9de9345386",
    "type" : "userTask",
    "status" : "finished",
    "nodeOptCount" : 1
  }, {
    "taskDefineKey" : "Activity_16kgz9u",
    "taskDefineName" : "用户任务",
    "startTime" : "2024-11-28T06:57:50.970+0000",
    "userAccount" : "XDM_Developer",
    "userCN" : null,
    "userId" : "93172bbfd0f64437956d4c9de9345386",
    "type" : "userTask",
    "status" : "doing",
    "nodeOptCount" : 1
  } ],
  "processDefinitionId" : "Process_xiejia_1126_2:1:a60b112ee2304d84a5432b94e86d81ec",
  "processDefinitionKey" : "Process_xiejia_1126_2",
  "i18n" : [ null ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档