将数据导入 Jira

Jira 允许您从其它来源（如其它问题跟踪系统）导入数据，并告诉您是否可以 CSV 或 JSON 等支持格式导出数据。所有导入程序都有一个向导驱动的界面，引导你完成一系列步骤。这些步骤大多相同，但也有一些差异。一般来说，将数据导入 Jira 有以下四个步骤：

选择源数据，例如 CSV 文件。
选择导入问题的目标项目。可以是现有项目，也可以是即时创建的新项目。
将源数据（例如 CSV）中的字段映射到 Jira 字段。
将源字段值映射到 Jira 字段值。对于基于选择的字段，如优先级字段或选择列表字段，通常需要这样做。对于文本和数字字段等字段，则不需要这样做。

现在，让我们看看如何使用 CSV 文件导入数据。

通过 CSV 导入数据

Jira 自带 CSV 导入器，可以导入 逗号分隔值(CSV) 格式的数据。这是一个非常有用的工具，因为大多数系统都能以这种格式导出数据。您还可以使用该工具将 Excel 电子表格转换为 CSV 文件。

在将 CSV 文件导入 Jira 之前，您需要确保数据格式正确。以下是导入数据前必须确认的项目清单：

每一行都必须作为一个问题导入，因此请确保问题的所有值都在一行中。
每一列都应映射到相应的 Jira 字段。可以是系统字段，也可以是自定义字段。
至少，您需要为必填字段（如问题摘要）提供值。
所有日期或日期-时间值都需要使用一致的格式。
如果要将列映射到用户字段（如受让人），请确保有正确的用户名值。
如果要将列映射到基于选择的字段，如选择列表或复选框，请确保检查了值的拼写。

格式化 CSV 文件后，请按照以下步骤将其导入 Jira：

从项目下拉菜单中选择 导入外部项目 选项。
点击 CSV 选项。这将启动导入向导。
现在，您需要点击 Choose File(选择文件) 按钮，选择包含要导入数据的 CSV 文件。
选择源文件后，可以展开高级部分，选择 CSV 文件中使用的文件编码和分隔符。此外，还有 使用现有配置文件 选项，我们将在本节稍后讨论。
点击 下一步 按钮继续，如下图所示：

Figure 1. Figure 2.8 – CSV File import
接下来，您需要选择要导入数据的项目。您也可以选择 创建新项目 选项，即时创建一个新项目。
如果 CSV 文件包含日期相关数据，请确保在 日期格式 字段中输入使用的格式。
单击 下一步 按钮继续，如下图所示：

Figure 2. Figure 2.9 – Map projects
接下来，您需要将 CSV 字段（列）映射到 Jira 中的字段。并非所有字段都需要映射。如果不想从特定列导入数据，只需不将 CSV 字段映射到 Jira 字段即可。
对于包含需要手动映射的数据的字段，如选择列表字段，您需要选中 映射字段值 复选框。这将使您可以将 CSV 字段值映射到 Jira 字段值，以便正确导入。如果不手动映射这些值，它们将被原样复制过来。对于选择列表等字段，将自动创建新选项。
点击 下一步 按钮继续，如下图所示：

Figure 3. Figure 2.10 – Map fields
最后，您需要将 CSV 字段值映射到 Jira 字段值。只有在步骤 10 中勾选了 映射字段值 复选框的字段才需要此步骤：
1. 为每个 CSV 字段值输入 Jira 字段值。
2. 完成字段值映射后，单击 开始导入 按钮开始实际导入过程，如下截图所示。根据数据量的大小，这可能需要一些时间才能完成：
  
  Figure 4. Figure 2.11 – Map values
导入过程完成后，您会收到一条确认信息，显示已导入的问题数量，如下图所示。这个数字应该与 CSV 文件中的记录数一致：

Figure 5. Figure 2.12 – Completed import process

在最后一个确认页面，您可以点击 下载详细日志 链接，下载包含导入过程所有信息的完整日志文件。如果导入不成功，这一点尤其有用。

您还可以点击 保存配置 链接，这将生成一个文本文件，其中包含这次导入的所有映射。如果将来需要运行类似的导入，可以使用该导入文件，这样就不需要再次手动重新映射所有内容了。要使用此配置文件，请选中步骤 4 中显示的 使用现有配置文件 选项。

正如我们所见，Jira 的项目导入器让从其它系统导入数据变得简单易行。在下一节中，我们将学习如何归档旧项目，以帮助提高 Jira 的性能。