Jira使用CSV文件导入数据格式注意点

---

前言

在使用CSV导入数据到Jira系统中时，有一些注意事项决定了导入的成功和失败。
之前遇到了个导入数据出错的问题，当时是巧合下给解决了。后续查找了些文档资料后，发现似乎解决方法是不正确的。很尴尬，但是问题提出者目前还没有提出问题。

所以这里记录一些CSV导入数据的注意事项，以便正确解决常见问题。

使用CSV向Jira中导入数据主要就是两个步骤（第3步是可选步骤）：

1. 准备CSV文件
2. 运行CSV导入向导
3. 保存配置以备将来使用

第3步是可选步骤，根据实际情况选择是否执行。

一、准备CSV文件

这里注意Jira系统插件（Jira Importers plugin）假定您的CSV文件基于默认的Microsoft Excel样式的CSV文件。字段之间用逗号分隔。

注意⚠️：对于Microsoft Excel和OpenOffice，由于这些应用程序会自动处理此问题，因此不必在单元格中引用值。

示例：pandas 是基于NumPy 的一种工具，该工具是为了解决数据分析任务而创建的。

CSV文件的要求

如上文所述，CSV文件要具有基本的正确格式，还要有以下关键要求：

1. 每个CSV文件必须包含带“Summary”列的标题行

   CSV文件导入向导使用CSV文件的标题行来确定如何将数据从CSV文件的第二行及以后映射到项目问题中的字段。

   标题行 应避免包含任何标点符号 （除逗号分隔各列外），否则导入程序可能无法正常工作。

2. 逗号（作为列/字段分隔符）不能省略
   例如，这是有效的：

    Summary, Assignee, Reporter, Issue Type, Description, Priority
    "Test issue", admin, admin, 1, ,
   

   下例是无效的：

    Summary, Assignee, Reporter, Issue Type, Description, Priority
    "Test issue", admin, admin, 1
   

   也就是要和标题行列数保持一致，没有值的用“空”来表示。

CSV文件封装Jira数据的格式

捕获跨多行的数据

在CSV中使用双引号（"）来获取跨多行数据。例如（This is ona new line）：

Summary, Description, Status
"Login fails", "This is on
a new line", Open

特殊字符字面意义保留

也是使用双引号（"）来保留特殊字符的字面意义。这样导入数据后，这些特殊字符都将作为Jira字段中数据的一部分内容存储。特殊字符包括回车/回车符/逗号等。
如果想要文本内容本身带双引号，可以使用另一个双引号进行字面意义保留。例如：
在CSV文件中：

"Clicking the ""Add"" button results in a page not found error"

导入到Jira中后显示：

Clicking the "Add" button results in a page not found error

将多个值聚合在单个Jira字段中：

前提是这个jira字段是支持多个值的（例如，Fix Version, Affects Version, Component, Labels）。要这样做的时候，CSV文件必须为每个要聚合到映射的Jira字段中的值指定相同的列名。且指定的列数必须和要聚合到映射字段中的最大数量值相匹配。（即标题行列数和具体值保持一致