Querying Work Item Process Information

Function

This API is used to query work item process information.

Calling Method

For details, see Calling APIs.

Authorization Information

No identity policy-based permission required for calling this API.

URI

GET /v1/ipdprojectservice/projects/{project_id}/work-item/{issue_id}/flow/detail

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition 32-character ID of a project, which must be unique. Obtain the value by calling the API for querying the IPD project list. The value of id in the response message body is the project ID. Constraints N/A Range A string of 32 characters consisting of letters and digits. Default Value N/A
issue_id	Yes	String	Definition Unique ID of a work item. You can obtain the value from the Querying Work Items or Querying Tree-shaped Work Items API. The value is id in the response body. Constraints N/A Range A string of 18 to 19 digits. Default Value N/A

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
issue_category	Yes	String	Definition Work item type. Constraints N/A Range Multiple work item types are supported, which are separated by commas (,), for example, IR,SR,AR. For system device projects, options include RR, SF, IR, SR, AR, Task, and Bug. For standalone software projects, options include RR, SF, IR, US, Task, and Bug. Default Value N/A

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition User token. Obtain a token by calling the IAM API for obtaining a user token. The value of X-Subject-Token in the response header is the user token. Constraints N/A Range 10 to 32,768 characters Default Value N/A

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
status	String	Definition Status code. Range N/A
message	String	Definition Response message. Range N/A
result	WorkItemFlowInfoVO object	Definition Response body of workflow details. Range N/A

**Table 5** WorkItemFlowInfoVO
Parameter	Type	Description
process_instance	WorkItemFlowProcessInstanceVO object	Definition Work item workflow instance information. Range N/A
next_flow	Array of FlowsInfoVO objects	Definition Valid transition lines. Range N/A

**Table 6** FlowsInfoVO
Parameter	Type	Description
process_instance	WorkItemFlowProcessInstanceVO object	Definition Work item workflow instance information. Range N/A
next_flow	Array of FlowsInfoVO objects	Definition Valid transition lines. Range N/A
code	String	Definition Transition line code. Range N/A
name	String	Definition Transition line name. Range N/A
description	String	Definition Transition line description. Range N/A
from_code	String	Definition Code of the current workflow node. Range N/A
to_code	String	Definition Code of the target workflow node. Range N/A

**Table 7** WorkItemFlowProcessInstanceVO
Parameter	Type	Description
process_instance	WorkItemFlowProcessInstanceVO object	Definition Work item workflow instance information. Range N/A
next_flow	Array of FlowsInfoVO objects	Definition Valid transition lines. Range N/A
id	String	Definition ID of a work item workflow instance. Range N/A
flow_state	Integer	Definition Whether a workflow instance is suspended. Range 1: running 2: suspended

Example Requests

Querying the workflow information of the IR whose ID is 1169236596358213632

GET https://{endpoint}/v1/ipdprojectservice/projects/9df557a4017d4b1b9cd53b96e44a4a50/work-item/1169236596358213632/flow/detail?issue_category=IR

Example Responses

Status code: 200

{
  "status" : "success",
  "message" : null,
  "result" : {
    "process_instance" : {
      "id" : "1169236596680073217",
      "flow_state" : 1
    },
    "next_flow" : [ {
      "code" : "__virtual_Start__2__Analyse",
      "name" : "",
      "description" : null,
      "extra_config" : null,
      "from_code" : "Start",
      "to_code" : "Analyse"
    }, {
      "code" : "__virtual_Start__2__Develop",
      "name" : "",
      "description" : null,
      "extra_config" : null,
      "from_code" : "Start",
      "to_code" : "Develop"
    } ],
    "fail_result" : null
  }
}