JIRA - 使用 CSV 创建问题

Jira - 使用 CSV 导入创建事项

Jira 允许您通过导入逗号分隔值（CSV）文件中的数据，一次性高效创建多个事项（issue）。CSV 文件是纯文本文件，用于存储表格数据，其值通常由逗号分隔。

此过程通常包含三个主要步骤：

• 准备包含事项数据的 CSV 文件。
• 使用内置的导入向导将 CSV 文件导入 Jira。
• （可选）保存导入配置以供将来重用，对于重复性导入强烈推荐这样做。

准备 CSV 文件

精心准备 CSV 文件对于成功导入至关重要。请考虑以下指导原则：

• **标题行：**您的 CSV 文件的第一行必须是标题行。此行中的值应对应于 Jira 事项字段（例如，Summary、Description、Assignee、Reporter、Priority、Issue Type、Due Date、Labels、Sprint）。示例：Summary,Description,Issue Type,Assignee,Reporter,Priority。
• **必填字段：**至少，您通常需要一个 Summary 字段。根据您的 Jira 项目配置，其他字段如 Issue Type 和 Project Key（如果通过系统管理员导入导入到多个项目）也可能是必填的。
• **多行数据：**要在单个字段中包含跨越多行的数据（例如，详细描述），请将整个字段内容用双引号（"）括起来。例如："登录问题","这是一个详细描述。 它跨越多行。",开放。
• **特殊字符：**如果您的数据包含逗号，请将字段用双引号括起来。如果包含双引号，请使用另一个双引号进行转义（例如，"他说 ""你好！"""）。
• **用户字段（Assignee、Reporter）：**对于用户字段，您通常可以使用 Jira 用户名或电子邮件地址。确保这些信息与您的 Jira 实例中的现有用户匹配。不匹配是常见的导入错误。
• **日期字段：**使用 Jira 可以识别的统一日期格式。导入向导通常允许您指定 CSV 中使用的日期格式（例如，dd/MMM/yy、yyyy-MM-dd）。
• **项目标识：**当作为 Jira 管理员进行导入时，您可以指定 Project Name 和 Project Key 列，以便将事项导入到特定项目中。对于项目级别的导入，事项通常是在当前项目中创建的。
• **编码：**使用 UTF-8 编码保存 CSV 文件，以确保正确处理特殊字符和国际语言。

CSV 示例片段：

Summary,Description,Issue Type,Assignee,Reporter,Priority,Labels
"Fix login button","User cannot log in when clicking the main login button.",Bug,jsmith,adoe,High,"login,ui-bug"
"Develop new user profile page","Create a new user profile page as per specifications.",Story,cjohnson,adoe,Medium,"profile,new-feature"

将 CSV 文件导入 Jira

访问 CSV 导入向导的确切步骤可能因您的 Jira 版本（Cloud 或 Data Center）和权限而略有不同。通常，您会在以下两个位置之一找到此功能：

• **Jira 系统管理员：**在 Jira Administration（通常通过齿轮图标 ⚙️ > System 访问）下寻找 ‘External System Import’ 或 ‘CSV Import’ 等选项。这允许导入到多个项目。
• **项目管理员/用户：**在特定项目内，您可能会在项目设置中或通过事项页面上的“操作”或“更多”菜单找到“从 CSV 导入事项”选项。

一旦找到导入向导，流程通常遵循以下步骤：

步骤 1：设置文件导入 (Setup File Import)

• 选择要上传的 CSV 源文件。
• 系统会询问您是否要使用现有配置文件。如果这是您第一次导入或需要新的映射，请不要选择此项。配置文件会保存您的字段映射和设置，这对于重复导入结构相似的 CSV 文件非常有用。

以前，您可能会看到一个名为“批量创建设置 (Bulk Create Setup)”的页面。现代界面会引导您完成“设置 (Setup)”、“设置 (Settings)”、“映射字段 (Map Fields)”和“映射值 (Map Values)”等步骤。

步骤 2：设置 (Settings)

• 指定 CSV 分隔符（通常是逗号 ,）。如果您的文件使用不同的分隔符（例如分号 ;、制表符 \t），请在此处输入。
• 指明文件编码（建议使用 UTF-8）。
• 如果您要使用现有配置文件，可以在此处选择它。

此步骤确保 Jira 正确解析您的 CSV 文件结构。

步骤 3：映射字段 (Map Fields)

• Jira 将显示您的 CSV 文件中的列标题。您需要将每个 CSV 标题映射到对应的 Jira 事项字段。
• 例如，将您的 CSV 列“Summary”映射到 Jira 的“Summary”字段。
• 映射 Summary 字段至关重要。其他需要映射的重要字段包括 Issue Type、Assignee、Reporter、Priority、Description 等。
• 对于您希望控制特定数据值如何转换为 Jira 值的字段（例如，将 CSV 状态“In Progress”映射到 Jira 的“In Progress”状态，或将 CSV 优先级“1”映射到 Jira 的“Highest”优先级），请勾选“映射字段值 (Map field value)”复选框。

准确的字段映射是成功导入的关键。如果 CSV 列标题与 Jira 字段名称完美匹配，Jira 可能会自动映射它。

步骤 4：映射值 (Map Values)（可选）

• 如果在上一步中您勾选了任何字段的“映射字段值 (Map field value)”复选框，则会出现此步骤。
• 在此处，您可以定义这些字段中特定值的映射关系。例如，如果您的 CSV 有一个“Priority”列，其值为“P1”、“P2”，您可以将“P1”映射到 Jira 的“High”优先级，将“P2”映射到 Jira 的“Medium”优先级。
• 对于“Assignee”或“Reporter”等用户字段，如果您未选择“映射字段值 (Map Field Value)”，Jira 将尝试将您的 CSV 中的用户名或电子邮件地址与现有的 Jira 用户进行匹配（可能适用不区分大小写）。

这种精细控制有助于将您的 CSV 数据与 Jira 的特定字段选项和用户群体对齐。

步骤 5：开始导入（验证）(Begin Import (Validation))

• 在开始实际导入之前，Jira 通常会提供一个“验证 (Validate)”选项。点击此选项会检查您的映射和数据是否存在常见错误，而不会实际创建事项。
• 审查任何错误或警告。常见问题包括未映射的必填字段、错误的日期格式或找不到的用户。
• 一旦验证成功（或您已解决任何问题），点击“开始导入 (Begin Import)”。

验证有助于及早发现问题，避免混乱的导入。系统将报告将成功导入的事项数量。

步骤 6：导入完成和结果 (Import Completion & Results)

• Jira 将处理导入。对于大型文件，这可能需要一些时间。
• 完成后，您将收到导入摘要，包括成功创建的事项数量和遇到的任何错误。
• 您通常会有一个“保存配置 (Save the configuration)”的选项。强烈建议您这样做，因为它会将您的字段和值映射保存到一个文件中，您可以将其重复用于将来导入类似的 CSV 文件，显著加快流程。
• 您还可以导航到查看新创建的事项。

成功导入后，最好检查几个新创建的事项，以确保所有数据都按预期导入。

实际应用场景

• **从其他工具迁移：**将旧系统中的任务导出为 CSV 并将其导入 Jira。
• **批量加载待办事项：**在规划期间，在电子表格中收集产品待办项 (PBI) 或用户故事，然后将其导入 Jira。
• **创建重复性任务：**对于重复性的项目阶段或新客户 onboarding，可以使用 CSV 模板快速生成标准任务集。

常见问题排查

• **用户匹配：**确保您的 CSV 中的用户名或电子邮件地址与 Jira 中的完全匹配。检查是否存在拼写错误或域名差异。
• **日期格式：**在导入向导中指定您的 CSV 中使用的正确日期格式。格式不匹配是常见错误。
• **自定义字段：**对于自定义字段，尤其是选择列表或多选字段，确保您的 CSV 中的值与 Jira 中的可用选项匹配，或进行相应的映射。
• **必需字段：**确保所有 Jira 项目必需的字段都存在于您的 CSV 中并正确映射。
• **文件编码：**始终使用 UTF-8 以避免字符损坏。

有关详细的、最新的说明和高级选项，请始终参考您的特定 Jira 版本（Cloud 或 Data Center）的 Atlassian Jira 官方文档。