Help Center/ CodeArts Req/ API Reference/ API/ IPD Work Item Management/ Querying Work Item List on the Personal Workbench

Updated on 2026-10-13 GMT+08:00

View PDF

Querying Work Item List on the Personal Workbench

Function

This API is used to obtain the work items of the current user in the tenant space, including their raw requirements, system features, R&D requirements, bugs, and tasks. You can filter work items by type, priority, creation time, update time, planned completion time, status, and responsible project.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account root user has all the permissions required to call all APIs, but IAM users must be assigned the following required identity policy-based permissions. For details about the required permissions, see Permissions Policies and Supported Actions.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
codeartsreq:workitem:list	List	-	codeartsreq:Model codeartsreq:ProjectId	-	-

URI

POST /v1/ipdprojectservice/projects/tenant/query

**Table 1** Query Parameters
Parameter	Mandatory	Type	Description
project_id	No	String	Definition 32-character UUID of a project, which must be unique. Obtain the value by calling the API for querying the IPD project list. The value of project_id in the response message body is the project ID. Constraints Multiple projects are separated by commas (,). A maximum of 10 projects can be queried at a time. If the number of projects exceeds 10, the first 10 project IDs after deduplication will be used. Range N/A Default Value N/A
issue_type	Yes	String	Definition Work item type. Constraints Use commas (,) to separate multiple values. Range RR SF Epic FE IR SR AR US Bug Task Default Value N/A

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
filter	No	Array of Map<String,ConditionVO> objects	Definition Array of query filters, where each element defines a filter condition as a Map<String, ConditionVO> object. Within the Map, the key represents the database column to query and ConditionVO indicates the condition's value. The value source is dynamically determined by the key. For example, a filter element {"descendants.plan_pi": {"values": ["956200745322848257"], "operator": "\|\|"}} queries for work items under the release with ID 956200745322848257. This translates to a SQL clause: select ... where plan_pi in ("956200745322848257"). plan_pi is used as the key. descendants. indicates a search within a tree structure for matching child items and is optional. In general use, plan_pi alone is sufficient as the key. The release ID is the value of the query condition. To query work items under multiple releases, provide multiple release plan IDs in the values array. Constraints Max. 200 characters. Range N/A Default Value N/A
filter_mode	No	String	Definition Filtering mode. Constraints Max. 512 characters. Range OR_AND: The relationship between multiple filters is OR, and the relationship between the key and value of the same filter is AND. AND_OR: The relationship between multiple filters is AND, and the relationship between the key and value of the same filter is OR. Default Value AND_OR
page	No	PageInfoVO object	Definition Pagination information. Constraints N/A Range N/A Default Value N/A
sort	No	Array of SortInfo objects	Definition Sorting criteria. Constraints N/A Range N/A Default Value N/A

**Table 3** ConditionVO
Parameter	Mandatory	Type	Description
values	No	Array of strings	Definition Value of the query condition. Range The value is determined by the query key. If the key is plan_pi, the value must be a release plan ID. If the key is a user field like assignee, the value must be a user ID. If the key is a datetime field like created_date, the value is typically a millisecond-precision timestamp range (for example, [1760284800000,1760371199999]). Constraints Max. 200 characters.
operator	No	String	Definition Operator. Constraints N/A Range \|\| indicates a logical OR relationship between the query target and the values. ! indicates a logical NOT relationship. = indicates an EQUALS relationship, generally applied when the values array contains a single element. <>, <, and > represent range, less-than, and greater-than relationships, respectively. These are typically used for datetime or integer comparisons and include boundary values. Default Value "\|\|"

**Table 4** PageInfoVO
Parameter	Mandatory	Type	Description
page_no	No	Integer	Definition Page index. Constraints N/A Range 1 to 10000 Default Value 1
page_size	No	Integer	Definition Page size. Constraints N/A Range 5 to 200 Default Value 200

**Table 5** SortInfo
Parameter	Mandatory	Type	Description
field	No	String	Definition Sorting field code. Constraints N/A Range Obtain the value from the API for querying field templates. The value is code in the response body. Default Value N/A
asc	No	Boolean	Definition Ascending or not. Constraints N/A Range true: ascending false: descending Default Value N/A

Response Parameters

Status code: 200

**Table 6** Response body parameters
Parameter	Type	Description
status	String	Definition Response status. Range success: The response is successful. error: The response failed.
message	String	Definition Information. Range N/A
result	IssueListResult object	Definition Result data.

**Table 7** IssueListResult
Parameter	Type	Description
issues	Array of IssueVO objects	Definition Work item list. Range N/A
total	Integer	Definition Total number of work items that meet the filter criteria. Range N/A

**Table 8** IssueVO
Parameter	Type	Description
sys_analysis_conclusion	String	Definition Analysis conclusion, which is filled during RR acceptance. Range N/A
sys_remark	String	Definition Remarks. This field is filled during RR submission for acceptance. Range N/A
promised	OptionVO object	Definition Promised or not. This field is filled during RR acceptance. Range N/A
type	String	Definition Work item type. Range requirement (R&D requirement) raw requirement bug task feature
belong_inside	String	Definition Whether a work item is submitted across projects. Range 1: submitted across projects 0: submitted within a project
src_domain	DomainVO object	Definition ID of the project space where the work item is created. Range N/A
domain_id	DomainVO object	Definition ID of the project space to which the work item belongs. Range N/A
send_from	String	Definition ID of the raw requirement's upstream requirement. Range N/A
number	String	Definition Work item ID, which consists of the work item type, year, month, day, and six random digits. For example, an IR created on September 30, 2025 may be numbered RR20250930982833. Range N/A
send_to	String	Definition ID of the raw requirement's downstream requirement. Range N/A
path	String	Definition Path between the parent and child work items. Range N/A
workload_man_day	String	Definition Planned workloads of a work item. Range N/A
sys_check_conclusion	String	Definition Acceptance conclusion. This field is filled during RR acceptance. Range N/A
id	String	Definition Unique ID of a work item. Range N/A
state	String	Definition Work item lifecycle. Range In use: work items that can be operated properly Discarded: soft-deleted work items that can be restored from the recycle bin Deleted: permanently deleted work items that cannot be restored
stay_days	Integer	Definition Number of days that a work item stays in the current status. Range N/A
assigned_cc	Array of UserVO objects	Definition Cc recipient. Range N/A
submit_time	String	Definition Submission time of a work item. It is the time when the work item enters the workflow, rather than the creation time. Range N/A
workitem2label	Array of WorkItemLabelVO objects	Definition Work item label. Range N/A
sys_return_conclusion	String	Definition Reason for return. This field is filled when an RR/bug is returned. Range N/A
close_time	String	Definition Completion time of a work item. Range N/A
priority	OptionVO object	Definition Priority. Range Low Medium High
modified_date	String	Definition Last modification time of a work item. Range N/A
created_by	UserVO object	Definition Work item creator. Range N/A
break_status	OptionVO object	Definition Breakdown status. Range N/A
status_modified_date	String	Definition Time when the work item was last transferred, which can be used to calculate the stay days. The value is a UNIX timestamp in milliseconds. Range N/A
expect_delivery_time	String	Definition Expected completion time. The value is a UNIX timestamp in milliseconds. Range N/A
parent_id	String	Definition Parent work item ID of a work item. Range N/A
assignee	UserVO object	Definition Owner. Range N/A
region	String	Definition Domain of the tenant to which the work item belongs. Range N/A
status	AlmStatus object	Definition Work item status. Range N/A
tenant_id	String	Definition ID of the tenant to which the work item belongs. Range N/A
plan_pi	PlanVO object	Definition Release to which a work item belongs. Range N/A
link	String	Definition Relationship field of the associated work item. Use commas (,) to separate multiple values. Range N/A
description	String	Definition Work item description. A maximum of 500,000 characters are supported. Range N/A
is_suspended	OptionVO object	Definition Suspended or not. Range N/A
change_status	OptionVO object	Definition Change review status of a work item. Range N/A
title	String	Definition Work item title. Range N/A
sum_workload_man_day	String	Definition Actual workloads of a work item. Range N/A
sys_close_reason	String	Definition Reason for closing a work item. Range N/A
sys_resubmit_reason	String	Definition Reason for resubmission, which is used when resubmitting a returned RR/bug. Range N/A
plan_end_date	String	Definition Planned completion time of a work item. Range N/A
rr2ir	String	Definition ID of the child IR of an RR. Use commas (,) to separate multiple values. Range N/A
category_layer_id	String	Definition Work item type level ID. Range N/A
submitted_by	Array of UserVO objects	Definition Work item submitter. Range N/A
rr2us	String	Definition ID of the child US of an RR. Use commas (,) to separate multiple values. Range N/A
sys_no_develop_reason	String	Definition Reason why no development is requirement for the work item. Range N/A
plan_iteration	PlanVO object	Definition Sprint to which the work item belongs. Range N/A
sys_return_reason	String	Definition Reason for return. It is usually used when returning an RR/bug. Range N/A
cascade_delete	String	Definition Flag indicating whether to perform cascading deletion. Range N/A
recipient	Array of UserVO objects	Definition Receiver. It is usually used for RRs. Range N/A
modified_by	Array of UserVO objects	Definition Last modifier of a work item. Range N/A
created_date	String	Definition Creation time of a work item. Range N/A
category	String	Definition Work item type. Range 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.
collaborative_status	String	Definition Collaboration status of an R&D requirement. Range N/A
project	DomainVO object	Definition Project to which the work item belongs. Range N/A
child_issues	Map<String,IssueVO>	Definition Child work item list. Range N/A
activate_times	Integer	Definition Number of activation times. The value is automatically assigned when the bug is activated. Range N/A
baseline	OptionVO object	Definition Work item baseline status. Range N/A
business_domain	OptionVO object	Definition Domain of a work item. Range software soft-hardware hardware Performance Functions O&M Operations User experience Privacy protection Compliance Resilience (reliability/availability) Resilience (hazard detection and recovery) Transparent Harmless Security API Cost Maintainability Other DFX Availability others
children	String	Definition ID of a child work item. Use commas (,) to separate multiple values. Range N/A
collaborative_history	String	Definition Change history of a collaborative requirement's status. The value is a JSON string. Range N/A
collaboratives	String	Definition R&D requirement collaboration task ID. Obtain the value from the Querying Tree-shaped Work Items API. The value is collaboratives in the response body. Range N/A
convolution_actual_hours	String	Definition Actual roll-up workloads, summed from the actual workloads of all the child and collaborative work items. Range N/A
convolution_plan_hours	String	Definition Planned roll-up workloads, summed from the planned workloads of all the child and collaborative work items. Range N/A
develop_owner	String	Definition Development owner. This field is usually used for nodes in the developing status. Range N/A
done_ratio	OptionVO object	Definition Progress. Range N/A
expected_repair_date	String	Definition Expected fixing time. Range N/A
feature2ir	String	Definition ID of the child IR of an SF. Use commas (,) to separate multiple values. Range N/A
feature_set	OptionVO object	Definition Feature set to which the SF belongs. Range N/A
found_env	OptionVO object	Definition Environment. Range N/A
found_iteration	PlanVO object	Definition Sprint. Range N/A
found_pi	PlanVO object	Definition Release. Range N/A
function_scene	String	Definition Function scenario. Range N/A
ir2feature	String	Definition ID of the SF associated with an IR. An IR can be associated with only one SF. Range N/A
ir2rr	String	Definition ID of the parent RR associated with an IR. Use commas (,) to separate multiple values. Range N/A
issue_opinion_id	String	Definition ID of the decision comment associated with a work item. Range N/A
issue_review_id	String	Definition ID of the review comment associated with a work item. Range N/A
module	OptionVO object	Definition Module. Range N/A
need_break	OptionVO object	Definition Whether work item breakdown is required. Range yes: Breakdown is required. no: Breakdown is not required.
need_develop	OptionVO object	Definition Whether development is required. Range N/A
no_break_reason	String	Definition Reason for no breakdown required. Range N/A
no_develop_reason	String	Definition Reason for no development required. Range N/A
order	Integer	Definition Priority order. Range 1–100
plan_dev_end_date	String	Definition Planned development end time. This field is usually used for nodes in the developing status. The value is a UNIX timestamp in milliseconds. Range N/A
plan_processing_end_date	String	Definition Planned end time of processing. This field is usually used for in-progress nodes. The value is a UNIX timestamp in milliseconds. Range N/A
plan_researchanddevelop_end_date	String	Definition Planned R&D end time. This field is usually used for nodes in the R&D status. The value is a UNIX timestamp in milliseconds. Range N/A
plan_test_end_date	String	Definition Planned test end time. This field is usually used for nodes in the testing status. The value is a UNIX timestamp in milliseconds. Range N/A
position_float	String	Definition Initial position of a work item in the list. Range N/A
processing_owner	String	Definition Owner for in-progress nodes. This field is usually used for in-progress nodes. Range N/A
reason_analysis	String	Definition Reason analysis. Range N/A
regression_failure_number	Integer	Definition Number of times that regression failed. This field is automatically assigned when the bug test fails. Range N/A
related_network_security	OptionVO object	Definition Whether network security is involved. Range yes: Network security is involved. no: Network security is not involved.
repair_solution	String	Definition Fix solution. This field is usually used for bugs. Range N/A
researchanddevelop_owner	String	Definition R&D owner. This field is usually used for nodes in the R&D status. Range N/A
severity	OptionVO object	Definition Severity. Range N/A
sys_activation_reason	String	Definition Severity. Range N/A
sys_no_repair_reason	String	Definition Reason why rectification is not required. This field is used when the bug does not need to be fixed. Range N/A
test_failures_times	Integer	Definition Number of times that the test failed. Range N/A
test_owner	String	Definition Test owner. This field is usually used for nodes in the testing status. Range N/A
test_report	String	Definition Test report. Range N/A
val_feature	OptionVO object	Definition Value feature. Range N/A
workitem2ganttchart	String	Definition ID of the Gantt chart associated with a work item. Range N/A
workitem2mindmap	String	Definition ID of the mind map associated with a work item. Range N/A

**Table 9** WorkItemLabelVO
Parameter	Type	Description
id	String	Definition Label ID. Range A string of 18 to 19 digits.
category	String	Definition Object type. Range Label
label_type	String	Definition Type of the work item to which the label belongs, corresponding to the type field of the work item. The options are as follows. Range raw requirement feature (system feature) requirement (R&D requirement) task bug
color	String	Definition Label RGB color. Range The available color codes and their descriptions are as follows: #86CAFF: light sky blue #6DDEBB: aquamarine #A6DD82: light green #FAC20A: golden yellow #FA9841: sandy orange #F66F6A: light coral #F3689A: pink #A97AF8: medium purple #71757F: slate gray #5E7CE0: soft blue #207AB3: steel blue #169E6C: sea green #6CA83B: olive green #B58200: dark golden yellow #B54E04: burnt orange #B02121: dark red #AD215B: dark pink #572DB3: deep violet #4F4F4F: dark gray #3C51A6: indigo blue
title	String	Definition Label title. Range 1 to 30 characters.
type	String	Definition Data type of the current object. Range label
state	String	Definition Lifecycle of a label. Range In use: The label is normal and can be used. Discarded: The label has been deleted and cannot be used. Deleted: The project to which the label belongs has been deleted and the label cannot be used.
modified_by	String	Definition Last modifier. Range N/A

**Table 10** UserVO
Parameter	Type	Description
user_id	String	Definition User ID. Range N/A
user_num_id	Integer	Definition Short ID of a user. Range N/A
user_name	String	Definition Username. Range N/A
domain_id	String	Definition ID of the domain to which the user belongs. Range N/A
domain_name	String	Definition Tenant name. Range N/A
nick_name	String	Definition User alias. Range N/A
role_id	String	Definition Role ID. If a user has multiple roles in a project, use commas (,) to separate the values. Range N/A
role_name	String	Definition Role name. If a user has multiple roles, use commas (,) to separate the values. Range N/A
role_code	String	Definition Role code. If a user has multiple roles, use commas (,) to separate the values. Range N/A

**Table 11** AlmStatus
Parameter	Type	Description
id	String	Definition Status ID. Range N/A
belonging	String	Definition Work item status. Range START: To Do state, such as Initial or Analyzing. IN_PROGRESS: Doing state, such as Fixing, Testing, or In R&D. END: Done state, such as Closed or Completed.
space_id	String	Definition ID of the project space to which the status belongs. Range N/A
name	String	Definition Status name. Range N/A
code	String	Definition Status code. Range N/A
definition_type	String	Definition Status definition level. The values 1, 2, and 3 indicate the system level, the value 4 indicates the tenant-defined level, and the value 5 indicates the project-defined level. Range N/A
belong_definition_type	Integer	Definition Status definition level. The values 1, 2, and 3 indicate the system level, the value 4 indicates the tenant-defined level, and the value 5 indicates the project-defined level. It is different from definition_type. If the definition level is system-level or tenant-defined, a copy of metadata is copied to the project space. Range N/A
display_value	String	Definition Status name, which is the same as the value of name. Range N/A
position	Integer	Definition Position sequence. Range N/A
displayable	Integer	Definition Display or not. Range N/A
editable	Integer	Definition Editable or not. Range N/A
deletable	Integer	Definition Deletable or not. Range N/A
mutable	Integer	Definition Whether the status value is fixed. Range N/A
title_py	String	Definition Initial letters of a title. Range N/A
created_by	String	Definition User ID of the creator. Range N/A
created_date	Integer	Definition Creation time. The value is a UNIX timestamp in milliseconds. Range N/A
modified_date	Integer	Definition Last modification time. The value is a UNIX timestamp in milliseconds. Range N/A
modified_by	String	Definition ID of the last modifier. Range N/A
linkage_node_fields	Boolean	Definition Whether to add the node owner/end time in the workflow configuration. Range true: The node owner/end time can be added to the status flow node. false: The node owner/end time cannot be added to the status flow node.

**Table 12** DomainVO
Parameter	Type	Description
id	String	Definition Unique ID of a project space. Range N/A
name	String	Definition Project space name. Range N/A
title	String	Definition Project space name. Range N/A
project_id	String	Definition 32-character UUID of a project space. Range N/A
parent_id	String	Definition Parent project space ID of the project space, which is used only in programs. Range N/A
category	String	Definition Project space type. Range Project Group
created_by	String	Definition ID of the project space creator. Range N/A
model_id	String	Definition Model ID corresponding to the project space. Range 10001: system device 10002: standalone software

**Table 13** PlanVO
Parameter	Type	Description
id	String	Definition: ID of a release, sprint, or milestone. Value range: N/A
title	String	Definition: Title. Options: N/A
category	String	Definition: Type. The value is of the enumerated type. Value range: PI: release Iteration: sprint PlanMilestone: milestone
description	String	Definition: Description Options: N/A
state	String	Definition Discard flag. The value is of the enumerated type. Range In use: releases that can be operated normally. Discarded: releases that have been soft deleted. Deleted: releases that have been permanently deleted.
status	String	Definition: Release/Sprint status. The value is of the enumerated type. Value range: planned: not started going: ongoing ended
children	Array of PlanVO objects	Definition: Sub-project sprint information.
created_by	String	Definition Creator ID. Range N/A
modified_by	String	Definition ID of the last updater. Range N/A
plan_start_date	String	Definition Planned start time, in the format of "yyyy-MM-dd". Example: 2024-01-01. Range N/A
plan_end_date	String	Definition Planned completion time, in the format of "yyyy-MM-dd". Example: 2024-01-01. Range N/A
created_date	Long	Definition: Creation time, which is a Unix timestamp (unit: millisecond). Options: N/A
parent_id	String	Definition Parent work item ID. When the plan type is iteration, this parameter specifies the release plan to which the work item belongs. Range N/A
baseline	String	Definition Baseline status. The value is of the enumerated type and indicates whether the plan has been included in baseline management. Range baselined unbaseline "" (not baselined)
workload	String	Definition Estimated workload, which is used to identify the required workforce or time investment for the plan. The unit is person/day. Range Max. 11 characters.
owner	String	Definition Owner ID, which identifies the owner of a plan. Range A string of 32 characters.

**Table 14** OptionVO
Parameter	Type	Description
id	String	Definition Option ID. Range N/A
display_value	String	Definition Option name. Range N/A
value	String	Definition Unique ID of an option. The ID and value of a custom option are the same. Range N/A
code	String	Definition Option code. Range N/A
value_py	String	Definition Initial letter of the Chinese pinyin of the option name. Range N/A
sequence	Integer	Definition Option's position in the list. Range N/A
level	Integer	Definition Hierarchical depth (1, 2, 3, or 4) of an option. For single-choice and multi-choice lists, the value is 1. Range 1: first level. Options in both single-choice and multi-choice lists belong to the first level. 2: second level. 3: third level. 4: fourth level.
domain_id	String	Definition ID of the project space to which the option belongs. Range N/A
belong_definition_type	String	Definition Definition level of the option. 1, 2, and 3 indicate the system level, 4 indicates the tenant-defined level, and 5 indicates the project-defined level. Range 1: system-preset option. 2: system-preset option. 3: system-preset option. 4: tenant-defined option. 5: project-defined option.

Status code: 400

**Table 15** Response body parameters
Parameter	Type	Description
error_code	String	Definition Error code. Range N/A
error_msg	String	Definition Error description, which is a supplement to error_code. Range N/A

Example Requests

Querying the R&D requirements whose status is Start and priority is High on the personal workbench (15 records each page)

POST https://{endpoint}/v1/ipdprojectservice/projects/tenant/query?issue_type=IR,US&project_id=4f967f6f05554273b0476da123e73b41

{
  "page" : {
    "page_no" : 1,
    "page_size" : 15
  },
  "filter" : [ {
    "category" : {
      "values" : [ "IR", "US", "AR", "SR" ],
      "operator" : "||"
    }
  }, {
    "priority" : {
      "values" : [ "High" ],
      "operator" : "||"
    }
  }, {
    "status" : {
      "values" : [ "Start" ],
      "operator" : "||"
    }
  } ]
}

Example Responses

Status code: 200

{
  "status" : "success",
  "message" : null,
  "result" : {
    "total" : 1,
    "issues" : [ {
      "promised" : null,
      "type" : "raw requirement",
      "src_domain" : {
        "id" : "965714701520515072",
        "name" : "IPD-system device-0217",
        "title" : "IPD-system device-0217",
        "project_id" : "e4b0424709934bd1a54753e70336564d",
        "parent_id" : null,
        "category" : "Project",
        "created_by" : "a360371833bf4c558f796fd707b44daf",
        "model_id" : "10001"
      },
      "domain_id" : {
        "id" : "965714701520515072",
        "name" : "IPD-system device-0217",
        "title" : "IPD-system device-0217",
        "project_id" : "e4b0424709934bd1a54753e70336564d",
        "parent_id" : null,
        "category" : "Project",
        "created_by" : "a360371833bf4c558f796fd707b44daf",
        "model_id" : "10001"
      },
      "send_from" : "",
      "number" : "RR20240402742063",
      "send_to" : "",
      "convolution_actual_hours" : null,
      "workload_man_day" : null,
      "id" : "981935538274476033",
      "state" : "In use",
      "stay_days" : 1,
      "assigned_cc" : null,
      "submit_time" : "1712041275000",
      "workitem2label" : null,
      "close_time" : null,
      "priority" : {
        "id" : "965714705672876036",
        "display_value" : "Medium",
        "value" : "Medium",
        "code" : "Medium",
        "value_py" : "2",
        "sequence" : 2,
        "level" : 1,
        "domain_id" : "965714701520515072",
        "belong_definition_type" : "5"
      },
      "modified_date" : "1712041276000",
      "created_by" : {
        "watcher" : null,
        "user_id" : "a360371833bf4c558f796fd707b44daf",
        "user_num_id" : 4091,
        "user_name" : "devcloud_devcloud_01",
        "domain_id" : "4e919d73499648e3b0292cd3cbef806a",
        "domain_name" : "devcloud_devcloud_01",
        "nick_name" : "Test account",
        "role_id" : "8dc2cd191a104148a77f937681f9a5d6,6af50476ba89492698d237fb6fa456d6",
        "role_name" : "Project administrator and project manager",
        "role_code" : "project_admin,Project manager",
        "image_id" : null,
        "region" : null,
        "has_removed" : null
      },
      "break_status" : {
        "id" : "965714705672876041",
        "display_value" : "undecomposed",
        "value" : "undecomposed",
        "code" : "undecomposed",
        "value_py" : "undecomposed",
        "sequence" : 2,
        "level" : 1,
        "domain_id" : "965714701520515072",
        "belong_definition_type" : "5"
      },
      "status_modified_date" : "1712041276000",
      "canceled" : null,
      "expect_delivery_time" : null,
      "parent_id" : null,
      "assignee" : {
        "watcher" : null,
        "user_id" : "a360371833bf4c558f796fd707b44daf",
        "user_num_id" : 4091,
        "user_name" : "devcloud_devcloud_01",
        "domain_id" : "4e919d73499648e3b0292cd3cbef806a",
        "domain_name" : "devcloud_devcloud_01",
        "nick_name" : "Test account",
        "role_id" : "8dc2cd191a104148a77f937681f9a5d6,6af50476ba89492698d237fb6fa456d6",
        "role_name" : "Project administrator and project manager",
        "role_code" : "project_admin,Project manager",
        "image_id" : null,
        "region" : null,
        "has_removed" : null
      },
      "region" : "region",
      "status" : {
        "id" : "965714705815482388",
        "belonging" : "START",
        "space_id" : "965714701520515072",
        "name" : "Analyzing",
        "status_category" : null,
        "code" : "Analyse",
        "definition_type" : "5",
        "belong_definition_type" : 3,
        "belong_scope" : null,
        "display_value" : "Analyzing",
        "position" : 2,
        "displayable" : 1,
        "editable" : 1,
        "deletable" : 1,
        "mutable" : 1,
        "title_py" : "fx",
        "builtin" : null,
        "label" : null,
        "description" : null,
        "created_by" : "a360371833bf4c558f796fd707b44daf",
        "created_userinfo" : null,
        "created_on" : null,
        "created_date" : 1708202727000,
        "modified_date" : 1708202727000,
        "modified_by" : "a360371833bf4c558f796fd707b44daf",
        "category_code" : null,
        "editing_fields" : null,
        "associate" : null,
        "linkage_node_fields" : false
      },
      "tenant_id" : "4e919d73499648e3b0292cd3cbef806a",
      "link" : "",
      "is_suspended" : null,
      "change_status" : null,
      "title" : "RR-01",
      "sum_workload_man_day" : null,
      "plan_end_date" : null,
      "rr2ir" : "",
      "convolution_plan_hours" : null,
      "submitted_by" : [ {
        "watcher" : null,
        "user_id" : "a360371833bf4c558f796fd707b44daf",
        "user_num_id" : 4091,
        "user_name" : "devcloud_devcloud_01",
        "domain_id" : "4e919d73499648e3b0292cd3cbef806a",
        "domain_name" : "devcloud_devcloud_01",
        "nick_name" : "Test account",
        "role_id" : "8dc2cd191a104148a77f937681f9a5d6,6af50476ba89492698d237fb6fa456d6",
        "role_name" : "Project administrator and project manager",
        "role_code" : "project_admin,Project manager",
        "image_id" : null,
        "region" : null,
        "has_removed" : null
      } ],
      "rr2us" : "",
      "cascade_delete" : "none",
      "recipient" : [ {
        "watcher" : null,
        "user_id" : "a360371833bf4c558f796fd707b44daf",
        "user_num_id" : 4091,
        "user_name" : "devcloud_devcloud_01",
        "domain_id" : "4e919d73499648e3b0292cd3cbef806a",
        "domain_name" : "devcloud_devcloud_01",
        "nick_name" : "Test account",
        "role_id" : "8dc2cd191a104148a77f937681f9a5d6,6af50476ba89492698d237fb6fa456d6",
        "role_name" : "Project administrator and project manager",
        "role_code" : "project_admin,Project manager",
        "image_id" : null,
        "region" : null,
        "has_removed" : null
      } ],
      "modified_by" : {
        "watcher" : null,
        "user_id" : "a360371833bf4c558f796fd707b44daf",
        "user_num_id" : 4091,
        "user_name" : "devcloud_devcloud_01",
        "domain_id" : "4e919d73499648e3b0292cd3cbef806a",
        "domain_name" : "devcloud_devcloud_01",
        "nick_name" : "Test account",
        "role_id" : "8dc2cd191a104148a77f937681f9a5d6,6af50476ba89492698d237fb6fa456d6",
        "role_name" : "Project administrator and project manager",
        "role_code" : "project_admin,Project manager",
        "image_id" : null,
        "region" : null,
        "has_removed" : null
      },
      "created_date" : "1712041275000",
      "closed_flag" : null,
      "category" : "RR",
      "collaborative_status" : [ ],
      "setup" : true
    } ]
  }
}

Status code: 400

{
  "error_code" : "PM.02174103",
  "error_msg" : "No permission."
}

SDK Sample Code

The SDK sample code is as follows.

Java

Querying the R&D requirements whose status is Start and priority is High on the personal workbench (15 records each page)

     package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.projectman.v4.region.ProjectManRegion;
import com.huaweicloud.sdk.projectman.v4.*;
import com.huaweicloud.sdk.projectman.v4.model.*;

import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.util.HashMap;

public class ShowTenantIssueListSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");

        ICredential auth = new BasicCredentials()
                .withAk(ak)
                .withSk(sk);

        ProjectManClient client = ProjectManClient.newBuilder()
                .withCredential(auth)
                .withRegion(ProjectManRegion.valueOf("<YOUR REGION>"))
                .build();
        ShowTenantIssueListRequest request = new ShowTenantIssueListRequest();
        QueryVO body = new QueryVO();
        PageInfoVO pagebody = new PageInfoVO();
        pagebody.withPageNo(1)
            .withPageSize(15);
        List<String> listFilterValues = new ArrayList<>();
        listFilterValues.add("Start");
        ConditionVO filterFilter = new ConditionVO();
        filterFilter.withOperator("||")
            .withValues(listFilterValues);
        Map<String, ConditionVO> listFilterFilter1 = new HashMap<>();
        listFilterFilter1.put("status", filterFilter);
        List<String> listFilterValues1 = new ArrayList<>();
        listFilterValues1.add("High");
        ConditionVO filterFilter2 = new ConditionVO();
        filterFilter2.withOperator("||")
            .withValues(listFilterValues1);
        Map<String, ConditionVO> listFilterFilter3 = new HashMap<>();
        listFilterFilter3.put("priority", filterFilter2);
        List<String> listFilterValues2 = new ArrayList<>();
        listFilterValues2.add("IR");
        listFilterValues2.add("US");
        listFilterValues2.add("AR");
        listFilterValues2.add("SR");
        ConditionVO filterFilter4 = new ConditionVO();
        filterFilter4.withOperator("||")
            .withValues(listFilterValues2);
        Map<String, ConditionVO> listFilterFilter5 = new HashMap<>();
        listFilterFilter5.put("category", filterFilter4);
        List<Map<String, ConditionVO>> listbodyFilter = new ArrayList<>();
        listbodyFilter.add(listFilterFilter1);
        listbodyFilter.add(listFilterFilter3);
        listbodyFilter.add(listFilterFilter5);
        body.withPage(pagebody);
        body.withFilter(listbodyFilter);
        request.withBody(body);
        try {
            ShowTenantIssueListResponse response = client.showTenantIssueList(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}
 
 
  

Python

Querying the R&D requirements whose status is Start and priority is High on the personal workbench (15 records each page)

     # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkprojectman.v4.region.projectman_region import ProjectManRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkprojectman.v4 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]

    credentials = BasicCredentials(ak, sk)

    client = ProjectManClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(ProjectManRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = ShowTenantIssueListRequest()
        pagebody = PageInfoVO(
            page_no=1,
            page_size=15
        )
        listValuesFilter = [
            "Start"
        ]
        filterFilter = ConditionVO(
            operator="||",
            values=listValuesFilter
        )
        listFilterFilter1 = {
            "status": filterFilter
        }
        listValuesFilter1 = [
            "High"
        ]
        filterFilter2 = ConditionVO(
            operator="||",
            values=listValuesFilter1
        )
        listFilterFilter3 = {
            "priority": filterFilter2
        }
        listValuesFilter2 = [
            "IR",
            "US",
            "AR",
            "SR"
        ]
        filterFilter4 = ConditionVO(
            operator="||",
            values=listValuesFilter2
        )
        listFilterFilter5 = {
            "category": filterFilter4
        }
        listFilterbody = [
            listFilterFilter1,
            listFilterFilter3,
            listFilterFilter5
        ]
        request.body = QueryVO(
            page=pagebody,
            filter=listFilterbody
        )
        response = client.show_tenant_issue_list(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)
 
 
  

Go

Querying the R&D requirements whose status is Start and priority is High on the personal workbench (15 records each page)

     package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    projectman "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/projectman/v4"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/projectman/v4/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/projectman/v4/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")

    auth, err := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        SafeBuild()

    if err != nil {
        fmt.Println(err)
        return
    }

    hcClient, err := projectman.ProjectManClientBuilder().
         WithRegion(region.ValueOf("<YOUR REGION>")).
         WithCredential(auth).
         SafeBuild()


    if err != nil {
        fmt.Println(err)
        return
    }

    client := projectman.NewProjectManClient(hcClient)

    request := &model.ShowTenantIssueListRequest{}
	pageNoPage:= int32(1)
	pageSizePage:= int32(15)
	pagebody := &model.PageInfoVo{
		PageNo: &pageNoPage,
		PageSize: &pageSizePage,
	}
	var listValuesFilter = []string{
        "Start",
    }
	operatorFilter:= "||"
	filterFilter := model.ConditionVo{
		Operator: &operatorFilter,
		Values: &listValuesFilter,
	}
	var listFilterFilter1 = map[string](model.ConditionVo){
        "status": filterFilter,
    }
	var listValuesFilter1 = []string{
        "High",
    }
	operatorFilter1:= "||"
	filterFilter3 := model.ConditionVo{
		Operator: &operatorFilter1,
		Values: &listValuesFilter1,
	}
	var listFilterFilter4 = map[string](model.ConditionVo){
        "priority": filterFilter3,
    }
	var listValuesFilter2 = []string{
        "IR",
	    "US",
	    "AR",
	    "SR",
    }
	operatorFilter2:= "||"
	filterFilter6 := model.ConditionVo{
		Operator: &operatorFilter2,
		Values: &listValuesFilter2,
	}
	var listFilterFilter7 = map[string](model.ConditionVo){
        "category": filterFilter6,
    }
	var listFilterbody = []map[string](model.ConditionVo){
        listFilterFilter1,
        listFilterFilter4,
        listFilterFilter7,
    }
	request.Body = &model.QueryVo{
		Page: pagebody,
		Filter: &listFilterbody,
	}
	response, err := client.ShowTenantIssueList(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}
 
 
  

For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.

Status Codes

Status Code	Description
200	OK
400	Response upon a request failure. For example, the user does not have the operation permission or the project does not exist.

Error Codes

See Error Codes.

Parent topic: IPD Work Item Management

Previous topic: Querying Work Item Details V2

Next topic: Querying the Associated Items of a Work Item

Querying Work Item List on the Personal Workbench

Function

Calling Method

Authorization Information

URI

Request Parameters

Response Parameters

Example Requests

Example Responses

SDK Sample Code

Java

Python

Go

More

Status Codes

Error Codes

What is your overall rating for this page?