从 CSV 导入议题

您可以通过上传包含以下列的 CSV 文件将议题导入项目:

名称 是否必需? 描述
title Yes 议题的标题。
description Yes 议题描述。
due_date No YYYY-MM-DD 格式的议题到期日期。引入于 15.2 版本。

不导入其他列中的数据。

您可以使用 description 字段嵌入快速操作,向议题添加其他数据。 例如,标记、指派人和里程碑。

或者,您可以移动议题。移动议题会保留更多数据。

上传 CSV 文件的用户被设置为导入议题的作者。

note导入议题需要开发者或更高的权限级别。

准备导入

  • 考虑导入仅包含几个议题的测试文件。如果不使用 API,则无法撤消大型导入。
  • 确保您的 CSV 文件符合文件格式要求。

导入文件

要导入议题:

  1. 转到您项目的议题列表页面。
  2. 打开导入功能,具体取决于项目是否有问题:
    • 存在现有议题:选择右上角 批量编辑 旁边的导入图标,再选择 操作 () > 导入 CSV
    • 项目没有议题:选择页面中间的 导入 CSV
  3. 选择要导入的文件,然后选择 导入议题

文件在后台处理,导入完成后会向您发送通知电子邮件。

CSV 文件格式

从 CSV 文件导入议题时,必须以某种方式对其进行格式化:

要导入议题,极狐GitLab 要求 CSV 文件具有特定格式:

元素 格式
标题行 CSV 文件必须包含以下标题:titledescription。标题的大小写无关紧要。
不导入 titledescription 之外的列中的数据。
分隔符 从标题行中自动检测列分隔符。支持的分隔符有:逗号(,)、分号(;)和制表符(\t)。行分隔符可以是 CRLFLF
双引号字符 双引号 (") 字符用于引用字段,允许在字段中使用列分隔符(请参阅下面示例 CSV 数据中的第三行)。插入双引号 (") 在带引号的字段中,连续使用两个双引号字符,即 ""
数据行 在标题行之后,后续行必须遵循相同的列顺序。议题标题是必需的,而描述是可选的。

如果您有特殊字符(例如,,\n)或字段中有多行(例如,使用快速操作时),请用双引号将字符括起来 (")。

使用快速操作时,每个操作必须位于单独的行上。

示例 CSV 数据:

title,description,due date
My Issue Title,My Issue Description,2022-06-28
Another Title,"A description, with a comma",
"One More Title","One More Description",
An Issue with Quick Actions,"Hey can we change the frontend?

/assign @sjones
/label ~frontend ~documentation",

文件大小

限制取决于极狐GitLab 实例的托管方式:

  • 私有化部署版:由极狐GitLab 实例的“最大附件大小”的配置值设置。
  • SaaS 版:在 JihuLab.com 上,设置为 10 MB。