Help us learn about your current experience with the documentation. Take the survey.

从 CSV 文件导入 issues

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

您可以通过上传包含以下列的 CSV（逗号分隔值）文件将 issues 导入到项目中：

Name Required? Description
title check-circle Yes Issue 标题。
description check-circle Yes Issue 描述。
due_date dotted-circle No Issue 的截止日期，格式为 YYYY-MM-DD。在 GitLab 15.2 中引入。
milestone dotted-circle No Issue 的里程碑标题。在 GitLab 16.7 中引入。

其他列中的数据不会被导入。

您可以使用 description 字段嵌入 quick actions 来为 issue 添加其他数据。 例如，标签、指派人和里程碑。

或者，您可以 移动 issue。移动 issue 会保留更多数据。

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

您必须拥有 Planner 角色或至少是项目的 Developer 角色才能导入 issues。

准备导入

  • 考虑导入一个只包含少量 issues 的测试文件。如果不使用 GitLab API，无法撤销大量导入操作。
  • 确保您的 CSV 文件符合 文件格式 要求。
  • 如果您的 CSV 包含 milestone 标题，请确保文件中所有唯一的里程碑标题已存在于项目或其父组中。

导入文件

要导入 issues：

  1. 转到项目的 Issues 页面。
  2. 打开导入功能，根据项目是否已有 issues：
    • 项目已有 issues：在右上角，Bulk edit 旁边，选择 Actions（ ellipsis_v ）> Import CSV。
    • 项目没有 issues：在页面中间，选择 Import CSV。
  3. 选择要导入的文件，然后选择 Import issues。

文件将在后台处理，如果检测到任何错误或导入完成后，会向您发送通知电子邮件。

CSV 文件格式

要导入 issues，GitLab 要求 CSV 文件具有特定格式。

有关可能影响导入文件在 GitLab 中显示方式的 CSV 解析要求的信息，请参阅 CSV 解析注意事项。

Element Format
header row CSV 文件必须包含以下标题：title 和 description。标题的大小写不重要。
columns title、description、due_date 和 milestone 之外列的数据不会被导入。
separators 列分隔符从标题行检测。支持的分隔符字符包括逗号（,）、分号（;）和制表符（\t）。行分隔符可以是 CRLF 或 LF。
double-quote character 双引号（"）字符用于引用字段，使字段中可以使用列分隔符（参见下面示例 CSV 数据的第三行）。要在引用字段中插入双引号（"），连续使用两个双引号字符（""）。
data rows 标题行之后，后续行必须使用相同的列顺序。issue 标题是必需的，但描述是可选的。

如果您的字段中有特殊字符（例如，, 或 \n）或多行内容（例如，使用 quick actions 时），请用双引号（"）包围这些字符。

同样在使用 quick actions 时：

  • 每个 action 必须在单独的一行。
  • 对于 /label 和 /milestone 等 quick actions，标签或里程碑必须已存在于项目中。
  • 您指派 issue 的用户必须是项目的成员。

示例 CSV 数据：

title,description,due_date,milestone
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",
An issue with milestone,"My milestone is created",,v1.0

文件大小

限制取决于您的 GitLab 实例的托管方式：

  • GitLab Self-Managed：由 GitLab 实例的 Max Attachment Size 配置值设置。
  • GitLab SaaS：在 GitLab.com 上，设置为 10 MB。