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

The Jira Importers plugin, which is bundled with Jira, allows you to import your data from a comma-separated value (CSV) file. This might be helpful when you are migrating from an external issue tracker to Jira.

CSV files are text files representing tabulated data and are supported by most applications that handle tabulated data (for example, Microsoft Excel, databases, etc.).

The CSV import feature allows you to import issues from an external (issue tracking) system that can export its data in a structured or tabulated format (preferably CSV).

Our main website highlights some top reasons why people migrate from such an external issue tracking system to Jira.

The CSV import process consists of the following stages:

  1. Preparing your CSV file (find the instructions below).
  2. Running the CSV file import wizard (find the instructions below).
    • インポート プロセスで個々のフィールドやフィールド値のマッピングを選択できます。
    • At the end of the CSV file import wizard, you can choose to create a CSV configuration file that contains the settings you configured while running through the CSV file import wizard. This is useful if you need to test your CSV file import on a test Jira server first before performing the import on a production system.

Several methods are available for importing data from other issue tracking systems into Jira. Depending on your other issue tracking system, it may be more appropriate to use a different import method instead of exporting data from that system to a CSV file and then importing that CSV file to Jira.

If your other issue tracking system is listed on the Migrating from other issue trackers page, try using the appropriate method to import data to Jira.

You may also want to use the Bulk issues import feature instead of External system import. Learn more about Bulk issues import in here.

このページの内容

CSV ファイルの準備

The Jira Importers plugin assumes that your CSV file is based off a default Microsoft Excel-styled CSV file:

  • Fields are separated by commas.
  • Any content that must be treated literally, such as commas and new lines/"carriage returns" themselves are enclosed in quotation marks.

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

CSV ファイルの要件

In addition to being "well-formed", CSV files have the following requirements.

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

The CSV file import wizard (see more details 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 shouldn't contain any punctuation, except for the commas separating each column. Otherwise, the importer may not work correctly.

The header row must contain a column for the issue's "Summary" data.

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

For example, the following format is valid:

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

While this one is not valid:

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

CSV ファイルで Jira データ構造をカプセル化する

In this section, you’ll find solutions for the following issues:

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

Use double-quote marks (") in your CSV file to capture data that spans multiple lines. For example, during 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

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

テキスト部分を二重引用符 (") で囲むと、その範囲の特殊文字を文字どおりに扱うように指定できます。このデータが Jira にインポートされると、これらの特殊文字は Jira のフィールド データの一部として保管されます。特殊文字の例としては、キャリッジリターン / 改行文字、コンマなどがあります。

To treat a double quote mark literally, you can "escape" them with another double quote mark character. For example:

  • Your CSV file might contain the value like "Clicking the ""Add"" button results in a page not found error".
  • Once imported, it 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. For example, Fix (for) VersionAffects VersionComponent, or 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 this 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.

Be aware that only a limited number of Jira fields support multiple values. The CSV importer will not allow you to import aggregated data into Jira fields that only support a single value.

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

You can attach files to issues, created from your CSV file. To do this, specify the URL of your attachment in an "Attachments" column in your CSV file.

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"
Admin, "CSV attachment import with timestamp,author and filename", "Please check the attached image below.", "01/01/2012 13:10;Admin;image.png;file://image-name.png", "01/01/2012 10:10;Admin; This comment works"

URLs for attachments support the HTTP and HTTPS protocols and can be any location that your Jira server must be able to access. You can also use the FILE protocol to access files in the import/attachments subdirectory of your Jira home directory.

サブタスクの作成

You can create sub-tasks of issues through a CSV file import by encapsulating this structure in your CSV file. To do this:

  • The CSV file must have two additional columns whose headings should be named similarly to Issue Id and Parent Id.
  • Ensure that 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. Don't set 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
Sub-task, "Fourth issue", v1, v2, , Component2, , , 2, jbloggs

In this example, the fourth issue will be imported as a sub-task of the second issue, 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 ファイルのインポートを通じて、1 つの CSV ファイルから複数の Jira プロジェクトにインポートできます。この場合、次の点に留意します。

  • The CSV file must have 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 those 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 this example, 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.

Handl unresolved issues

解決状況、優先度、課題タイプへのフィールド マッピングについては、Jira で利用可能な値が入った選択リストが提供されます。また、緑色のプラス記号をクリックすると、Jira に存在しない値をすぐに作成できます。

ステータスへのフィールド マッピングについては、Jira で利用可能な値が入った選択リストが提供されますが、新しいステータス値を作成するプラス記号は提供されません。

これらの 4 つのフィールドについては、Jira で使用可能な値のほかに、次の 2 つの特別なオプションが選択リストに用意されます。

  • "Import as blank". If selected, the Jira value to be blank for that field. Note that if you are importing Unresolved issues, you should create a field mapping for the Resolution field and set the value "Unresolved" to "Import as blank".
  • "No mapping". This attempts to import the value in the CSV file as-is. Note that using "No mapping" for a field value will result in a failed import if the value is not valid for that Jira field. For fields mapping to Status and Issue Type, default values are used when the "Import as blank" option is selected.

作業ログ エントリのインポート

CSV ファイルには作業ログ エントリを含めることができます。例:

Summary,Worklog
Only time spent (one hour),3600
With a date and an author,2012-02-10 12:30:10;wseliga;120
With an additional comment,Testing took me 3 days;2012-02-10 12:30:10;wseliga;259200

消費時間を追跡するには、秒単位を使用する必要があります。

Importing to multi-select custom fields

CSV ファイルには、1 つの複数選択カスタムフィールドへの複数のエントリを含めることができます。例:

Summary,Multi Select,Multi Select,Multi Select
Sample issue,Value 1,Value 2,Value 3

これは、複数の値を持つ複数選択カスタムフィールドにデータを追加します。

カスケード選択カスタム フィールドへのインポート

次の構文を使用して、カスケード選択カスタム フィールドに値をインポートできます。

Summary, My Cascading Custom Field
Example Summary, Parent Value -> Child Value

"->" セパレーターを使用すると、 階層をインポートできます。

Currently, Jira doesn't support importing multi-level cascading select fields via CSV ( JRA-34202 - Getting issue details... STATUS ).

既存の課題の更新

From version 4.3 of Jira Importers plugin, you can update existing issues. Your CSV file needs to contain a column that will be mapped to Issue Key during the import. If an issue exists for a given key, it will be updated. For example:

issue key,summary,votes,labels,labels
TT-1,Original summary,1,label1,label2
TT-1,,7,label-1,label-2
TT-1,Changed summary,,,
TT-2,Original summary 2,1,label-1,label-2
TT-2,,<<!clear!>>,<<!clear!>>,

The first row will create an issue, the second row will set votes to 7 and add two labels. The following row will change the summary. Issue TT-2 will be created with two labels, but the second row will remove those labels with a special marker <<!clear!>>.

CSV をインポートして既存の課題を更新する場合、CSV で指定されていない列は既定値にリセットされます

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

Before you begin, you need to back up your Jira data. 

To use the External system import feature to import your issues to Jira:

  1. Jira 管理者グローバル権限を持つユーザーとしてログインします。
  2. Select Administration > System > Import & Export > External System Import.
  3. Select CSV to open the CSV File import page.
  4. On the CSV File import page, select your CSV Source File. If you want to change the file's encoding and CSV delimiter format, select the Advanced heading to reveal this option.

    • The file will be imported using the File encoding type you specify here. The default file type is UTF-8
    • CSV ファイルでコンマ以外の別の区切り文字を使用する場合、[CSV 区切り記号] フィールドでその文字を指定します。
  5. Leave the Use an existing configuration file checkbox 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.

    • このオプションを選択すると、既存の設定ファイルを指定するかどうか尋ねられます。
    • このオプションを選択しない場合、CSV ファイル インポート ウィザードの最後に、以降の CSV インポート (CSV ファイル インポート ウィザードの本ステップ) で使用できる設定ファイルが作成されます。
  6. Select Next to proceed to the Setup project mappings step of the CSV file import wizard.
  7. On the Setup project mappings page, you can either import all your issues into either one Jira project (new or existing), or multiple Jira projects. If you choose to import to multiple projects, ensure that your CSV file includes the minimum Jira project data required, which is Jira project name and key. Complete the following fields/options:

    Jira プロジェクトへのインポート

    以下のいずれかを選択します。

    • Select a project. Use this option to import issues to an existing Jira project or create a new project and import issues to it. 
      • Jira に存在するプロジェクトの名前 (またはキー) を入力するか、ドロップダウン メニューを使用して既存の Jira プロジェクトを選択します。
      • Select Create New from the dropdown menu and in the resulting Add A New Project dialog box, fill in the following fields:
        1. Enter the project Name
        2. Enter the project Key

          This will be used as the prefix for all issue IDs in your Jira project.

        3. Specify the Project Lead.
    • Defined in CSV. Use this option to import issues to multiple Jira projects. Ensure that every issue in your CSV file includes data for the Jira Project Name and Project KeySee Importing issues into multiple Jira projects for details.
    新規ユーザー用のメール識別子Enter the email address domain for any new users specified in the CSV file that will be added to Jira during the import.
    インポートファイルの日付形式CSV ファイルで使用する日付形式を指定します。Java SimpleDateFormat に準拠した構文を使用します。
  8. Select Next to proceed to the Setup field mappings step of the CSV file import wizard.

  9. In the Setup field mappings page, map the fields in the CSV file to the issue fields in the selected project. In the Jira field column, select the Jira field that you want to map to the field from the CSV file. For more information about matching CSV fields to Jira fields, see Tips for importing CSV data into Jira fields below.

    • 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 an  (warning) icon at this step of the wizard.

    • For CSV fields that have been aggregated by the CSV file import wizard, you will only be able to select Jira Fields that support multiple values.

    • サブタスクをインポートする場合、Jira の Issue ID  フィールドと Parent ID フィールドを CSV ファイルの対応するフィールドに一致させる必要があります。
    • If you are importing issues into multiple projects, ensure that you selected Defined in CSV during the Setup project mappings step. Remember to match the Project Name and Project Key fields in Jira to those in your CSV file.
  10. CSV ファイルのフィールドのデータの値を Jira にインポートされる前に変更する場合、該当のフィールドの横にある [フィールドの値のマッピング] チェックボックスを選択します。
  11. Select Next 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 that has been detected by the CSV file import wizard.

    • Any fields which Map field value checkboxes were selected in the previous step of the CSV file import wizard will be presented on this page.
    • Leave a field cleared or clear any content within it if you wish to import the value "as is".

    • You can create new Priority, Resolution, and Issue Type values in Jira (i.e. based on the data in your CSV file) by selecting the Add new link next to the appropriate field.

    • If you are importing a username-based CSV field (e.g. Reporter or Assignee) and you didn't select the Map field value checkbox 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 select the Map field value checkbox, Jira will automatically create usernames based on the data in your CSV file if they haven't been defined in Jira yet. 

  13. Select 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.

    • If you experience problems with the import (or you are curious), select the download a detailed log link to view detailed information about the CSV file import process.
    • If you need to import another CSV file with the same (or similar) settings to what you used through this procedure, select 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.

これで、CSV データを Jira に正常にインポートできました。ご不明な点や、問題が生じた場合は、アトラシアン サポートにご連絡ください。

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

The following are some helpful tips when importing data from your CSV file into specific Jira fields.

Jira フィールド

インポート時の注意

プロジェクト

CSV data is imported on a per-project basis. You can either specify an existing Jira project(s) as the target or the importer will automatically create a new project(s) for you at time of import.

要約

これは唯一の必須フィールドです。

課題キーインポートされた課題の課題キーを設定できます。対象のキーの課題がすでに存在する場合、その課題が更新されます。

コンポーネント

単独の列に各コンポーネントを入力することで、複数のコンポーネントを持つ課題をインポートできます。

影響バージョン

単独の列に各バージョンを入力することで、複数の「影響バージョン」を持つ課題をインポートできます。

修正バージョン

個別の列に各バージョンを入力することで、複数の "修正バージョン" を持つ課題をインポートできます。

コメント本文

単独の列に各コメントを入力することで、複数のコメントを持つ課題をインポートできます。

作成日

CSV インポート ウィザードの 2 番目の手順で指定した日付形式を使用してください。

更新日

CSV インポート ウィザードの 2 番目の手順で指定した日付形式を使用してください。

期日

CSV インポート ウィザードの 2 番目の手順で指定した日付形式を使用してください。

課題タイプ

CSV ファイルで指定されていない場合、インポートされた課題には、Jira システムの課題タイプ フィールド値の定義で指定された既定 (1 番目) の課題タイプが設定されます。インポート処理中に新しい Jira 値を作成することもできます。

ラベル

以下の方法で複数のラベルが付いた課題をインポートできます。

  • 各ラベルを別の列に入力する
  • すべてのラベルを 1 列に含め、スペースで区切る

優先度

CSV ファイルで指定されていない場合、インポートされた課題には、Jira システムの優先度フィールド値の定義で指定された既定 (1 番目) の優先度が設定されます。インポート処理中に新しい Jira 値を作成することもできます。

ソリューション

CSV ファイルで指定されていない場合、インポートされた課題には、Jira システムの解決状況フィールド値の定義で指定された既定 (1 番目) の解決状況が設定されます。インポート処理中に新しい Jira 値を作成することもできます。

役立つヒントとして、未解決の課題を取り扱う方法も参照してください。

ステータス

Jira の既存のワークフロー ステータスにのみマッピングできます。CSV ファイルでステータスが指定されていない場合、インポートされた課題には、Jira システムで指定されている既定 (1 番目) のステータスが設定されます。

初期見積り

このフィールドの値は、秒数で指定する必要があります。

残余見積り

このフィールドの値は、秒数で指定する必要があります。

消費時間

このフィールドの値は、秒数で指定する必要があります。

ユーザー

担当者または報告者フィールドの任意の値から、インポーターに Jira ユーザーを自動で作成させることも可能です。

  • ユーザーは、Jira のアクティブなアカウントとして作成されます。ユーザーは Jira への初回のログイン時にパスワードをメールで通知してもらう必要があります。
  • 実名を持たないユーザーは、メール アドレス (ログイン名) の "@" 文字の前の部分を Jira でのフルネームとして使用します。
  • 外部のユーザー管理機能を使用している場合、インポートのプロセスで Jira ユーザーを作成することはできません。代わりに、作成が必要な新規ユーザーの一覧がインポーターによって提供されます。インポートを開始する前に外部のユーザー リポジトリでユーザーを作成する必要があります。
  • ユーザー数に制限のあるライセンス (例: パーソナル ライセンス) で、必要なユーザー数が制限を超える場合、インポートは停止されます。作成できないユーザーの一覧を示すページが表示されます。
  • 担当者および報告者がマッピングされない場合、ユーザー名は作成されません。
ウォッチャーウォッチャーに指定されたユーザーが CSV ファイルに含まれているが、Jira には存在しない場合、このユーザーはインポートされません。特定の課題のウォッチャーとしてインポートする前に、ユーザーを Jira で利用可能にしておく必要があります。

その他のフィールド

他のフィールドをインポートする場合は、特定の Jira カスタム フィールドへのマッピングを行うことができます。Jira にカスタム フィールドが存在していない場合、インポーターは自動的にカスタム フィールドを作成します。カスタム フィールドが日付フィールドの場合、CSV インポーター ウィザードの 2 番目の手順で指定した日付形式を使用してください。

Importing issues in bulk

The Bulk issues import feature allows non-administrative users to import issues to Jira. External system import, which is described above, is available only for Jira Administrators.

With Bulk issues import, you should also import issues from a CSV file. But the entry point and steps to run Bulk issues import differ from External system import.

The Bulk issues import functionality has the following restrictions:

Prepare the CSV file with your Jira issues as described here. To import the file:

  1. Select Issues > Import issues from CSV.

  2. Select the CSV file that you want to import.
  3. Leave the Use an existing configuration file checkbox cleared if you don’t have a configuration file or if you want to create a new configuration file. In this case, Jira will create the configuration file that you can use for further imports. If you select the checkbox, you should upload the existing configuration file.
  4. Select the Next button.
  5. Fill in the fields. Select the project where you want to import the issues, file encoding type, delimiter, and date format. If the CSV file uses a different separator, specify the character in the Delimiter field instead of a comma. If the separator is a tab, specify it as /t.
  6. Select the Next button.
  7. Map the fields in the CSV file to the issue fields in the selected project. If you want to map a specific field value in the CSV file to a specific Jira field value, select the Map field value checkbox.

    You must map at least one field in the CSV file to the Jira Summary field because each Jira issue must have a summary. If, instead of the Jira field for mapping, you see the “Don’t map this field” note, it means that Jira can’t provide the right mapping for the field from the CSV file. To solve this issue, see Missing fields for mapping when importing issues through CSV in Jira


  8. Select the Next button.

  9. If you selected the Map field value checkbox for some fields, you should map the values of these fields from the CSV file to the specific values of corresponding Jira issue fields. For example, you may want to map the CSV field value “Feature Request” to the Jira issue type’s field value “New Feature”.

  10. If you want to check your configuration for errors or warnings before running the import, select Validate. If needed, you can download the detailed log of the validation.

  11. If needed, save the configuration for further use. For example, you may want to use the same field or value mappings for the next imports.

  12. Select Begin Import when you’re[ms1] [DS2]  sure of the configuration.

You’ve successfully bulk-imported your issues to Jira! If you have any questions or problems, contact Atlassian support. If you’re a Jira Administrator, we recommend using the External system import to avoid inconsistencies and errors.

最終更新日 2022 年 5 月 6 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.