查询复杂流程图数据 - queryActInstInfoByProcId

processInstanceId

是

String

参数解释：

流程实例ID，用于指定需要查询流程图数据的流程实例。

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

约束限制：

不涉及。

取值范围：

最大长度100字符。

默认取值：

不涉及。

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

约束限制：

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

取值范围：

不涉及。

默认取值：

不涉及。

code

String

参数解释：

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

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

取值范围：

• 200：成功。

• 500：失败。

message

String

参数解释：

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

取值范围：

不涉及。

resultObj

ActInstanceResult object

参数解释：

返回单个响应数据，包含流程图的核心信息（路由列表、节点详情、国际化信息等）。

取值范围：

不涉及。

routeList

Array of strings

参数解释：

流程中的路由信息列表，包含节点之间的顺序流（Sequence Flow）信息。用于绘制流程图的连接线，展示节点之间的流转路径。数组元素为JSON字符串格式，需解析后获取源节点和目标节点信息。

取值范围：

不涉及。

activityInfo

Array of ActivityInfoVO objects

参数解释：

流程中节点详细信息列表，包含每个节点的执行状态、操作历史、操作人信息等。按startTime升序排列，即按流程执行的时间顺序展示。

取值范围：

不涉及。

processDefinitionId

String

参数解释：

该流程的流程模板Key+版本+流程实例ID。格式为{processTemplateKey}:{version}:{deploymentId}，用于唯一标识流程定义模板。

取值范围：

不涉及。

processDefinitionKey

String

参数解释：

该流程的流程模板ID（Key），用于标识流程模板的唯一标识。与流程元模板中的模板Key一致。

取值范围：

不涉及。

i18n

Array of I18nDisplay objects

参数解释：

国际化信息列表，包含节点名称、描述等字段的多语言翻译。用于前端根据当前语言环境渲染对应的显示文本。

取值范围：

不涉及。

taskDefineKey

String

参数解释：

流程节点ID（任务定义Key），用于唯一标识流程模型中的节点定义。与流程元模板中的节点ID一致，可用于关联节点配置和导航树。

取值范围：

不涉及。

taskDefineName

String

参数解释：

流程节点名，用于展示当前节点的标题。可在流程元模板中配置，或通过i18n字段获取多语言版本。

取值范围：

不涉及。

startTime

String

参数解释：

流程节点的开始时间，标识节点被创建或开始执行的时间。格式为ISO 8601标准时间字符串（yyyy-MM-dd'T'HH:mm:ss.SSSXXX）。

取值范围：

不涉及。

userAccount

String

参数解释：

流程节点操作人的Account（账号名），标识执行当前操作的用户登录账号。与userId和userCN共同标识操作人信息。

取值范围：

不涉及。

userCN

String

参数解释：

流程节点操作人的中文名，用于展示操作人的可读名称。如果操作人未设置中文名，此字段可能为null。

取值范围：

不涉及。

userId

String

参数解释：

流程节点操作人的用户ID（UUID），用于在分布式系统中唯一标识操作人。与查询人员信息 - getUserInfos接口返回的uuid字段一致。

取值范围：

不涉及。

type

String

参数解释：

流程节点的类型，标识当前节点在BPMN模型中的角色。用于前端渲染不同类型的节点图标和样式。

取值范围：

• startEvent：开始事件（流程起点）。

• userTask：用户任务（需要人工处理）。

• manualTask：手工任务（需要手动执行的外部操作）。

• receiveTask：接收任务（等待外部信号触发）。

• subProcess：子流程（包含嵌套的子流程实例）。

• endEvent：结束事件（流程终点）。

• exclusiveGateway：排他网关（条件分支）。

• parallelGateway：并行网关（并行分支）。

status

String

参数解释：

流程节点状态，标识当前节点的执行状态。用于前端渲染节点的颜色和高亮状态。

取值范围：

• wait：等待中（节点已创建但尚未执行）。

• suspended：挂起（节点执行被暂停）。

• cancelled：已取消（节点执行被取消）。

• finished：已完成（节点执行完毕）。

• doing：进行中（节点正在执行中）。

nodeOptCount

Integer

参数解释：

流程节点操作次数，标识当前节点被执行或操作的累计次数。对于被驳回后重新执行的节点，此计数可能大于1。

取值范围：

不涉及。

key

String

参数解释：

国际化数据key值，标识需要翻译的原始文本或标识符。通常为变量名称或描述字段的编码。

取值范围：

不涉及。

value

String

参数解释：

国际化数据key对应的value值，即翻译后的显示文本。前端根据当前语言环境匹配对应的value值进行展示。

取值范围：

不涉及。

error_code

String

错误码。

error_msg

String

错误描述。

result

String

结果。

trace_id

String

追踪ID。

200

OK

400

Bad Request