从 CSV 导入议题
您可以通过上传包含以下列的 CSV 文件将议题导入项目：
| 名称 | 是否必需？ | 描述 |
|---|---|---|
title
| Yes | 议题的标题。 |
description
| Yes | 议题描述。 |
due_date
| No |
YYYY-MM-DD 格式的议题到期日期。引入于 15.2 版本。
|
不导入其他列中的数据。
您可以使用 description 字段嵌入快速操作，向议题添加其他数据。
例如，标记、指派人和里程碑。
或者，您可以移动议题。移动议题会保留更多数据。
上传 CSV 文件的用户被设置为导入议题的作者。
导入议题需要开发者或更高的权限级别。
准备导入
- 考虑导入仅包含几个议题的测试文件。如果不使用 API，则无法撤消大型导入。
- 确保您的 CSV 文件符合文件格式要求。
导入文件
要导入议题：
- 转到您项目的议题列表页面。
- 打开导入功能，具体取决于项目是否有问题：
- 存在现有议题：选择右上角 批量编辑 旁边的导入图标，再选择 操作 () > 导入 CSV。
- 项目没有议题：选择页面中间的 导入 CSV。
- 选择要导入的文件，然后选择 导入议题。
文件在后台处理，导入完成后会向您发送通知电子邮件。
CSV 文件格式
从 CSV 文件导入议题时，必须以某种方式对其进行格式化：
要导入议题，极狐GitLab 要求 CSV 文件具有特定格式：
| 元素 | 格式 |
|---|---|
| 标题行 | CSV 文件必须包含以下标题：title 和 description。标题的大小写无关紧要。
|
| 列 | 不导入 title 和description 之外的列中的数据。
|
| 分隔符 | 从标题行中自动检测列分隔符。支持的分隔符有：逗号（,）、分号（;）和制表符（\t）。行分隔符可以是 CRLF 或 LF。
|
| 双引号字符 | 双引号 (") 字符用于引用字段，允许在字段中使用列分隔符（请参阅下面示例 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。