文档首页/ 需求管理 CodeArts Req/ API参考/ API/ Scrum项目的工作项/ 导出工作项V2 - ExportViaExcelNewV2
更新时间:2025-12-23 GMT+08:00
分享

导出工作项V2 - ExportViaExcelNewV2

功能介绍

导出工作项V2。

调用方法

请参见如何调用API

URI

POST /v2/issues/export-reqs-new

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

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

约束限制:

必传。

取值范围:

最小长度:10,最大长度:32768。

默认取值:

不涉及。

表2 请求Body参数

参数

是否必选

参数类型

描述

projectUUId

String

参数解释

项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。

约束限制

32位的数字和字母组成的字符串。

取值范围

不涉及。

默认取值

不涉及。

fields

String

参数解释:

要导出的列字段,多值使用英文逗号分隔。

约束限制:

不涉及。

取值范围:

  • id:工作项id

  • subject:标题

  • closed_on:完成时间

  • status:状态

  • assigned_to:处理人

  • start_date:预计开始日期

  • due_date:预计结束日期

  • priority:优先级

  • created_on:创建时间

  • actual_work_hours:实际工时

  • done_ratio:完成度

  • tracker:工作项类型

  • module:模块

  • order:优先级顺序

  • severity:严重程度

  • parent_issue:父工作项

  • domain:领域

  • expected_work_hours:预计工时

  • fixed_version:迭代

  • env:发现环境

  • story_point:故事点

  • tag_id:标签

  • description:描述

  • author:创建人

  • assigned_cc:抄送人

  • developer:开发人员

  • updated_on:更新时间

默认取值:

不涉及。

export_child

Boolean

参数解释:

是否导出子工作项。

约束限制:

不涉及。

取值范围:

  • true:导出子工作项

  • false:不导出子工作项

默认取值:

不涉及。

type

String

参数解释:

导出工作项的结构类型。

约束限制:

不涉及。

取值范围:

  • tree:树形结构

  • list:列表结构

默认取值:

不涉及。

time_zone

Integer

参数解释:

时区(示例:8)。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

page_no

Integer

参数解释:

分页索引。

约束限制:

不涉及

取值范围:

最小值0,最大值9,999,999,999。

默认取值:

不涉及。

page_size

Integer

参数解释:

分页大小。

约束限制:

不涉及。

取值范围:

最小值0,最大值9,999,999,999。

默认取值:

不涉及。

export_all

Boolean

参数解释:

是否导出全部字段。

约束限制:

不涉及。

取值范围:

  • true:导出全部字段

  • false:按照选择的字段导出

默认取值:

不涉及。

tracker_id

String

参数解释

工作项类型ID。

约束限制

不涉及。

取值范围

  • 2:任务/Task

  • 3:缺陷/Bug

  • 5:Epic

  • 6:Feature

  • 7:Story

默认取值

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

-

File

参数解释

文件。

取值范围

不涉及。

请求示例

POST https://{endpoint}/v2/issues/export-reqs-new?_=1753102328713

{
  "projectUUId" : "d00fd603ddf64115939e7d3609d6cb05",
  "fields" : "id,subject,closed_on,status,assigned_to,start_date,due_date,priority,created_on,actual_work_hours,done_ratio,tracker,module,order,severity,parent_issue,domain,releaseDev,expected_work_hours,fixed_version,findReleaseDev,env,story_point,tag_id,description,author,assigned_cc,developer,updated_on",
  "export_child" : "false",
  "type" : "tree",
  "time_zone" : 8,
  "page_no" : 1,
  "page_size" : 2000,
  "export_all" : "false",
  "tracker_id" : "5,6,7,2,3"
}

响应示例

状态码

状态码

描述

200

导出事务接口成功的响应。

错误码

请参见错误码

相关文档