从 CSV 导入议题
可以通过上传包含 title
和 description
列的 CSV 文件将议题导入到项目中。其他列未导入。如果要保留标签和里程碑等列,请考虑使用移动议题功能。
上传 CSV 文件的用户被设置为导入议题的作者。
导入议题需要开发者或更高的权限级别。
准备导入
- 考虑导入仅包含几个议题的测试文件。如果不使用 API,则无法撤消大型导入。
- 确保您的 CSV 文件符合文件格式要求。
导入文件
要导入议题:
- 转到您项目的议题列表页面。
- 打开导入功能,具体取决于项目是否有问题:
- 存在现有议题:选择右上角 编辑议题 旁边的导入图标。
- 项目没有议题:选择页面中间的 导入 CSV。
- 选择要导入的文件,然后选择 导入议题。
文件在后台处理,导入完成后会向您发送通知电子邮件。
CSV 文件格式
从 CSV 文件导入议题时,必须以某种方式对其进行格式化:
要导入议题,极狐GitLab 要求 CSV 文件具有特定格式:
元素 | 格式 |
---|---|
标题行 | CSV 文件必须包含以下标题:title 和 description 。标题的大小写无关紧要。
|
列 | 不导入 title 和description 之外的列中的数据。
|
分隔符 | 从标题行中自动检测列分隔符。支持的分隔符有:逗号(, )、分号(; )和制表符(\t )。行分隔符可以是 CRLF 或 LF 。
|
双引号字符 | 双引号 (" ) 字符用于引用字段,允许在字段中使用列分隔符(请参阅下面示例 CSV 数据中的第三行)。插入双引号 (" ) 在带引号的字段中,连续使用两个双引号字符,即 "" 。
|
数据行 | 在标题行之后,后续行必须遵循相同的列顺序。议题标题是必需的,而描述是可选的。 |
如果字段中有特殊字符(例如 \n
或 ,
),请用双引号 ("
) 将字符括起来。
示例 CSV 数据:
title,description
My Issue Title,My Issue Description
Another Title,"A description, with a comma"
"One More Title","One More Description"
文件大小
限制取决于极狐GitLab 实例的托管方式:
- 私有化部署版:由极狐GitLab 实例的“最大附件大小”的配置值设置。
- SaaS 版:在 JiHuLab.com 上,设置为 10 MB。