身為 Jira 管理員，會解這 30 個問題是很正常的！ 如果不清楚，沒關係，你知道怎麼找到我們!
本文章預定會同步收錄在 Titansoft_Atlassain Consultant GOJira Medium 敬請期待

今天要來分享準備有效的 CSV 檔案

我們在 Day 24 - 身為 Jira 管理員會使用 CSV 檔案將資料匯入到 Jira 示範了匯入 CSV 檔案到 Jira 的步驟，但要如何準備檔案才能有效的達成搬遷的任務呢？今天就來分享囉。

準備用於導入 Jira 的 CSV 文件

Comma-separated value (CSV) 文件是表示表格資料的文字文件，大多數處理表格資料的系統（例如電子表格和資料庫）都支援該文件。您可以將 CSV 檔案的結構基於預設的 Microsoft Excel CSV 格式。
建立可匯入 Jira 的 CSV 檔案時，請確保所有欄位均以 , 分隔，並且任何內容（包括逗號和換行符）都以引號引起來。

準備 CSV 的重點

1. 包含帶有摘要欄位的標題行

導入文件時，始終需要摘要欄位。它提供了問題的概述。
摘要欄位是問題的簡短描述，用於提供問題相關內容的快速概述。它通常是您在瀏覽問題時看到的第一個訊息。該字段應該簡潔且具有描述性，並應提供足夠的資訊來理解問題的性質。
CSV 匯入器使用檔案標題行來決定如何將檔案第二行及之後的資料對應到 Jira 中的欄位。
如果您要匯入包含母子關係的 Issues 的數據，還需要其他 fields，具體取決於實例的配置。

2. 指派 Assign users

將人員作為受讓人、記者或創建者新增至 CSV 檔案時，請使用電子郵件地址。這將幫助我們將它們映射到所創建的項目和問題。了解有關將 CSV 資料匯入 Jira 欄位的信息
如果 CSV 檔案的使用者欄位中不包含電子郵件地址，您可以在匯入過程中手動將電子郵件地址新增至相關使用者 ID。

3. 避免在標題行中使用標點符號

為了防止匯入不準確，請避免在標題行中包含任何標點符號（分隔每列的逗號除外）。

4. 在問題的描述或評論中提及用戶

若要在問題的描述或評論欄位中使用提及，請將資料中的使用者提及替換為以下基於電子郵件的提及格式： [~email:user@example.com]
匯入後，提及將連結到使用者與提供的電子郵件地址相關聯。

建構 CSV 檔案的重點

1. 按字面意思對待特殊字符

在文字部分周圍使用雙引號 ( " ) 可以按字面意思處理該部分中的任何特殊字元。匯入此資料後，這些特殊字元將作為 Jira 欄位資料的一部分儲存。特殊字元的範例包括回車符/輸入字元、逗號等。

若要按字面意思處理雙引號，您可以新增另一個雙引號字元：

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

...導入後，將在 Jira 中儲存為：

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

2. 將多個數值集中到到單一欄位中

您可以將多個值匯入接受多個值的單一 Jira 欄位（例如觀察者、元件、標籤）。為此，您的 CSV 檔案必須為要匯入到相同欄位的每個值指定相同的列名稱。指定的列名數量必須與要聚合到對應欄位中的值的最大數量相符。

例如：

IssueType, Summary, Label, Label, Label, Component, Component
bug, "First issue", v1, , , Component1,
bug, "Second issue", v2, , , Component1, Component2
bug, "Third issue", v1, v2, v3, Component1,

在上面的範例中，第一個的 Label 和 Component 欄位以及第三個的 Component 欄位匯入後會在相關欄位中產生多個值。

3. 處理自訂字段

將資料匯入您的業務或軟體專案時，您可以選擇建立新的自訂欄位。自訂欄位可讓您新增特定於團隊需求的資訊。您也可以將資料匯入到實例中先前建立的各種現有自訂欄位。

身為 Jira 管理員，會解這 30 個問題是很正常的！
如果不清楚，沒關係，你知道怎麼找到我們