CSV からのデータのインポート

CSV ファイルの準備

JIRA インポータープラグインは、CSV ファイルがデフォルトの Microsoft Excel 形式の CSV ファイルに基づいているものと想定します。フィールドはコンマで区切られ、文字どおりに扱われる必要のあるコンテンツ (コンマや改行/「キャリッジリターン」そのもの) は、引用符で囲まれます。

Microsoft Excel と OpenOffice の場合、セル内の値を引用符で囲む必要はありません。これらのアプリケーションでは、自動でこの処理が行われます。

CSV ファイルの要件

CSV ファイルには、"適切に構造化されている" ことに加えて次の要件があります。

各 CSV ファイルには、要約列を持つ見出し行が存在する必要がある

The CSV file import wizard (below) uses a CSV file's header row to determine how to map data from the CSV file's 2nd row and beyond to fields in JIRA.

The header row should avoid containing any punctuation (apart from the commas separating each column) or the importer may not work correctly.

The header row must contain a column for 'Summary' data.

列/フィールドのセパレーターとしてのコンマは省略不可

たとえば、以下は有効です。

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 データ構造をカプセル化する

複数行にまたがるデータを取得する

Use double-quote marks (") in your CSV file to capture data that spans multiple lines. For example, upon import, JIRA will treat the following as a valid CSV file with a single record:

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

特殊文字を文字どおりに扱う

Use double-quote marks (") around a section of text to treat any special characters in that section literally. Once this data is imported into JIRA, these special characters will be stored as part of JIRA's field data. Examples of special characters include carriage returns/enter characters (as shown in the example above), commas, etc.

二重引用符を文字どおりに扱うようにするには、もう 1 つ二重引用符を追加して "エスケープ" します。したがって、CSV 値は次のようになります。

• "Clicking the ""Add"" button results in a page not found error"
  once imported, will be stored in JIRA as:
• Clicking the "Add" button results in a page not found error

複数の値を単一の JIRA フィールドに集約する

You can import multiple values into a JIRA field that accepts multiple values (e.g. Fix (for) Version, Affects Version, Component, Labels). To do this, your CSV file must specify the same column name for each value you wish to aggregate into the mapped JIRA field. The number of column names specified must match the maximum number of values to be aggregated into the mapped field. For example:

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

In the above example, the Component field of the second issue and the Fix Version field of the third issue will generate multiple values in appropriate JIRA fields upon import.

複数の値をサポートしている JIRA フィールドは限定されているので注意してください。CSV インポーターは、単一の値のみをサポートしている JIRA フィールドへの集約データのインポートを許可しません。

添付ファイルをインポートする

CSV ファイルから作成された課題にファイルを添付できます。これを行うには、CSV ファイル内の "Attachments" 列で、添付ファイルの URL を指定します。

Assignee, Summary, Description, Attachment, Comment
Admin, "Issue demonstrating the CSV attachment import", "Please check the attached image below.", https://jira-server:8080/secure/attachment/image-name.png, "01/01/2012 10:10;Admin; This comment works"

URLs for attachments only support the HTTP and HTTPS protocols and can be any location that your JIRA server must be able to access.

サブタスクの作成

CSV ファイルで構造をカプセル化することにより、CSV ファイルのインポートを通して課題のサブタスクを作成できます。この操作を行うには、次の手順を実行します。

• Your CSV file requires two additional columns whose headings should be named similarly to Issue Id and Parent Id.
• Ensure each regular (non sub-task) issue is given a unique (sequential) number in the Issue Id column. Do not include any value in the Parent Id fields for regular issues.
• To create a sub-task of a regular issue in your CSV file, reference the unique Issue Id number of the regular issue in the Parent Id column. Do not include any value in the Issue Id fields for sub-tasks.

例:

IssueType, Summary, FixVersion, FixVersion, FixVersion, Component, Component, Issue ID, Parent ID, Reporter
bug, "First issue", v1, , , Component1, , 1, , jbloggs
bug, "Second issue", v2, , , Component1, Component2, 2, , fferdinando
bug, "Third issue", v1, v2, v3, Component1, , 3, , fferdinando
subtask, "Fourth issue", v1, v2, , Component2, , , 2, jbloggs

In the example above, the fourth issue will be sub-task of the second issue upon import, assuming you match the 'Issue ID' and 'Parent ID' fields in your CSV file to the Issue Id and Parent Id JIRA fields, respectively during the CSV file import wizard.

複数の JIRA プロジェクトに課題をインポートする

CSV ファイルのインポートを通じて、課題を CSV ファイルから様々な JIRA プロジェクトにインポートできます。この操作を行うには：

• Your CSV file requires two additional columns whose headings should be named similarly to Project Name and Project Key.
• Ensure that every issue represented in your CSV file contains the appropriate name and key in these columns for the JIRA projects to which they will be imported.
  The project name and key data is the minimum JIRA project data required for importing issues from a CSV file into specific JIRA projects.

IssueType, Summary, Project Name, Project Key
bug, "First issue", Sample, SAMP
bug, "Second issue", Sample, SAMP
task, "Third issue", Example, EXAM

In the example above, the first and second issues will be imported into the 'Sample' project (with project key 'SAMP') and the third issue will be imported into the 'Example' project (with project key 'EXAM') , assuming you match the 'Project Name' and 'Project Key' fields in your CSV file to the Project name and Project key JIRA fields, respectively during the CSV file import wizard.

Allowing comments in CSV files

Your CSV file can contain comments which are not processed by the CSV file import wizard. Any text appearing to the right of a hash (#) symbol on a line of text in the CSV file will be disregarded by the import wizard. For example:

Assignee, Summary, Comment
Admin, "Test issue", "This is a comment that will be added to the issue once imported into JIRA" # And this is a comment that will not be processed by the JIRA import wizard.

Comments are useful if you want to add additional information to the CSV file that you do not want JIRA to import.

CSV ファイル インポート ウィザードを実行する

If your JIRA installation has existing data, then before you begin, back up your existing JIRA data.

1. Log in to JIRA as a user with the JIRA Administrators global permission.
2. Select Administration > System > Import & Export > External System Import > Import button associated with the Comma-separated values (CSV) option to open the CSV File import page.
   Keyboard shortcut: g + g + start typing external system import
   
3. On the CSV File import page, select your CSV Source File. If you want to change the file's encoding and CSV delimiter format, click the Advanced heading to reveal this option (as shown in the above screenshot).
     Note:
   
   • ファイルは、ここで指定したファイルのエンコード方法 (既定では UTF- 8) を使用してインポートされます。
   • CSV ファイルでコンマ以外の別の区切り文字を使用する場合、[CSV 区切り記号] フィールドでその文字を指定します。
4. Leave the Use an existing configuration file check box cleared if you do not have a configuration file or if you want to create a new configuration file. Configuration files specify a mapping between column names in your CSV file's header row and fields in your JIRA installation.
     Note:
   • このオプションを選択すると、既存の設定ファイルを指定するかどうか尋ねられます。
   • このオプションを選択しない場合、CSV ファイル インポート ウィザード の最終段階で、今後の CSV インポート（CSV ファイル インポート ウィザードの本ステップ）で使用できる設定ファイルが作成されます。
5. Click the Next button to proceed to the Setup project mappings step of the CSV file import wizard.
   

6. プロジェクト マッピングの設定ページで、すべての課題を 1 つの JIRA プロジェクト（新規または既存）にインポートするか、または（CSV ファイルに必要な最小限の JIRA プロジェクト データ － すなわち、JIRA プロジェクト名とキーが含まれるようにして ）複数の JIRA プロジェクトにインポートするか、いずれかの設定が可能です。次のフィールド/オプションを入力します。

   JIRA プロジェクトへのインポート	以下のいずれかを選択します。 プロジェクトを選択し、次のいずれかの操作を行います。 JIRA にすでに存在するプロジェクトの名前（またはキー）を入力するか、ドロップダウンメニューを使用して、既存の JIRA プロジェクトを選択します。 Select Create New from the dropdown menu and in the resulting Add A New Project dialog box, type the following: 新規プロジェクトの名前 A new project Key This will be used as the prefix for all issue IDs in your JIRA project. プロジェクト リーダー。 Defined in CSV. Ensure that every issue in your CSV file includes data for the JIRA Project Name and Project Key. This option is useful if you want to import issues from your CSV file into multiple JIRA projects. See Importing issues into multiple JIRA projects for details.
   新規ユーザー用のメール識別子	CSV ファイルで指定され、インポート中に JIRA に追加される新規ユーザー用のメールアドレス ドメインを入力します。
   インポートファイルの日付形式	Specify the date format used in your CSV file. Use the syntax that complies with the Java SimpleDateFormat.

7. Click the Next button to proceed to the Setup field mappings step of the CSV file import wizard.
   

8. On the Setup field mappings page, specify each CSV Field (determined by your CSV file's header row) you want to import into your chosen JIRA project by selecting their check boxes under the Import column on the left.
     Please Note:

   • 少なくとも、これらのフィールドのいずれかに JIRA のサマリ フィールドのデータが含まれている必要があります。

   • If your CSV file contains more than one of the same field name specified in its header row, the CSV file import wizard will aggregate these into a single field, which will be marked by a symbol at this step of the wizard.

9. In the JIRA field column, select the JIRA fields you want to match to fields defined in your CSV file (i.e. each CSV Field you selected in the previous step). For more information about matching CSV fields to JIRA fields, see Tips for importing CSV data into JIRA fields below.
     Please Note:

   • サマリ フィールドは、JIRA フィールドのいずれかを指定してマッピングする必要があります。これを行うまでは、次へ ボタンは使用不可のままとなります。

   • CSV ファイル インポート ウィザードによって集約された CSV フィールドに対しては、複数の値をサポートする JIRA フィールドしか選択できません。

   • サブタスクをインポートする場合、JIRA の課題 ID  フィールドと親ID  フィールドを CSV ファイルの対応するフィールドに一致させるのを忘れないようにします。
   • 複数のプロジェクトに課題をインポートする場合、上記のプロジェクトのマッピング設定ステップで CSV で定義済みを選択していることを確認し、JIRA のプロジェクト名フィールドとプロジェクト キー フィールドを CSV ファイルの対応するフィールドに一致させるのを忘れないようにします。
10. To modify the values of any fields' data in the CSV file before they are imported into JIRA, select the Map field value check boxes next to the appropriate fields.
11. Click the Next button to proceed to proceed to the Setup value mappings step of the CSV file import wizard.
    
12. On the Setup value mappings page, specify the JIRA field values for each CSV file field value (which has been detected by the CSV file import wizard).
    Please Note:
    
    • Any fields whose Map field value check boxes were selected in the previous step of the CSV file import wizard will be presented on this page.

    • 値を現状のままインポートしたい場合は、フィールドを空欄のままにしておくか、フィールド内のコンテンツを消去します。

    • You can create new Priority, Resolution and Issue Type values in JIRA (i.e. based on the data in your CSV file) by clicking the Add new ... link (e.g. Add new issue type 'subtask' shown in the screenshot above) next to the appropriate field.

    • If you are importing a username-based CSV field (e.g. Reporter or Assignee) and you do not select the Map field value check box for this field in the previous step of the CSV file import wizard, then the importer will automatically map imported usernames from the CSV file to (lowercase) JIRA usernames.
      Regardless of whether or not you specify a mapping for these username fields, JIRA will automatically create usernames based on the data in your CSV file if they have not already been defined in JIRA. 

13. Click the Begin Import button when you are ready to begin importing your CSV data into JIRA. The importer will display updates as the import progresses, then a success message when the import is complete.
    
    Note:
    • インポートで問題が生じた場合、[詳細ログのダウンロード] リンクをクリックして、CSV ファイルのインポート処理に関する詳細情報を表示します。
    • If you need to import another CSV file with the same (or similar) settings to what you used through this procedure, click the save the configuration link to download a CSV configuration file, which you can use at the first step of the CSV file import wizard.

Congratulations, you have successfully imported your CSV data into JIRA! If you have any questions or encounter any problems, please contact Atlassian support.

CSV データを JIRA フィールドにインポートするためのヒント

データを CSV ファイルから特定の JIRA フィールドにインポートする場合に役立つヒントを以下に示します。