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

When migrating from another project management tool, you can export data to a comma-separated value (CSV) file and then import that file into your Jira Cloud applications. CSV files are text files representing tabulated data and are supported by most applications that handle tabulated data. 

推奨データ サイズ

大規模なプロジェクトをインポートする際は、データを分割してパフォーマンスの問題を軽減し、最適なインポート速度を確保することをお勧めします。

Prepare your CSV file

Jira にインポートできる CSV ファイルを作成する場合は、次の点をご確認ください。

• すべてのフィールドがカンマで区切られている

• すべてのコンテンツ (カンマと改行を含む) は引用符で囲まれます。

CSV ファイルの要件

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

CSV ファイルのインポート ウィザードは、CSV ファイルの見出し行を使用して、ファイルの 2 行目以降のデータを Jira のフィールドにどのようにマッピングするかを決定します。

見出し行には句読点を含まないようにします (各列を区切るコンマは除く)。これを行わない場合、インポーターが正しく機能しない可能性があります。

見出し行には要約データの列が含まれている必要があります。

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

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

しかし、以下は無効です。

CSV ファイルの構造

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

CSV ファイルで二重引用符 (") を使用して、複数行にまたがるデータを囲みます。たとえば、Jira では以下を単一レコードを持つ有効な CSV ファイルとして扱います。

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

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

二重引用符を文字どおり扱うには、もう 1 つ二重引用符を追加することができます。

...これをインポートすると、次のように Jira に保存されます。

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

複数の値を許可する単一の Jira フィールド (修正対象バージョン、影響バージョン、コンポーネント、ラベルなど) には複数の値をインポートできます。これを行うには、同じフィールドにインポートしたいそれぞれの値について、CSV ファイルで同じ列名を指定する必要があります。指定される列名の数は、マッピングされるフィールドに集約される値の最大数と一致している必要があります。

例:

In the above example, the Component field of the second work item and the Fix Version field of the third work item will generate multiple values in the relevant field after importing.

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

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

添付ファイルの URL では HTTP と HTTPS プロトコルがサポートされ、Jira Cloud サイトがアクセス可能な場所であればどこにでも配置できます。

お使いの Atlassian アカウント ID がわからない場合は、Jira Could サイトにログインし、ページの右上隅にあるアバターをクリックして [プロファイル] に移動してください。[プロファイル] ページの URL の最後の部分がお使いの Atlassian アカウント ID です。

例: https://<yoursitename>.atlassian.net/jira/people/<Your Atlassian account ID>

親/子関係の構築

You can create a hierarchy of imported work items by specifying their parent / child relationships:

• Add three columns to you CSV file with the headings: “Work item ID”, “Work type”, and “Parent”

• Ensure each work item in your CSV is given a unique (sequential) number in the "Work item ID" column

• Reference the unique "Work item ID" number of a work item in the “Parent” column

• The parent work items must exist above the child work items in the file

詳細と必要なマッピングの例については、「 CSV インポートの親子マッピング 」を参照してください。

In the following example, the fourth work item will be a child of the second work item if you match the "Work item ID" and “Parent” fields in your CSV file to the corresponding Work item and Parent fields in Jira. Similarly, the second work item will be the child of the fifth work item as the “Work item ID” and “Parent” fields are matched.

Importing work items into multiple Jira projects

You can import work items from your CSV file into different Jira projects by:

• CSV ファイルに見出し "プロジェクト名" および "プロジェクト キー" の 2 つの列を追加

• Ensuring that every work item represented in your CSV file contains the name and key in these columns for the corresponding Jira projects

The project name and key data is the minimum Jira project data required for importing work items from a CSV file into specific Jira projects.

In this example, the first and second work items will be imported into the "Sample" project (with project key "SAMP") and the third work items will be imported into the "Example" project (with project key "EXAM") if you match the "Project Name" and "Project Key" fields in your CSV file to the corresponding Project name and Project key fields in Jira:

How to handle unresolved work types

For fields mapping to Resolution, Priority, and Work Type, you'll see a list with the available values in Jira. Create values that do not exist in Jira by clicking the green plus symbol.

また、ステータスにマッピングするフィールドの利用可能な値のリストも表示されます。ただし、新しいステータス値を作成することはできません。

For the Resolution, Priority, Work Type, and Status fields, you can choose the following:

• Import as blank — this causes the Jira value to be blank for that field. If you are importing unresolved work items, you should create a field mapping for the Resolution field and change the value from "Unresolved" to "Import as blank".

• No mapping — this attempts to import the value in the CSV file as is. Note that the import will fail if a field value is mapped to a Jira field that doesn't support that value. Fields mapping to Status and Work Type will use the default value when "Import as blank" is also selected.

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

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

消費時間の追跡には秒を使用する必要があることに注意してください。

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

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

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

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

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

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

Updating existing work items

To update existing work items, your CSV file needs to contain a column that maps to Work Item Key. If a work item exists for a given key, it will be updated.

In this example, the second row will create work item TT-1, while the third row will set the number of votes to 7 and add two labels, and the fourth row will change the summary. In the next row, work item TT-2 will be created with two labels. The last row removes labels with the <<!clear!>> special marker:

CSV ファイルのインポート

CSV ファイルの準備ができたら、Jira 管理者として Jira Cloud サイトにログインし、インポート プロセスを開始します。

ファイルのアップロード

1. Choose , then System.

2. [インポートとエクスポート] セクションで、[外部システムのインポート] > [CSV] の順にクリックします。

   1. 新しいインポート エクスペリエンスが表示される場合は [ 旧エクスペリエンスに切り替える] を選択して、CSV ファイル インポート ウィザードに進みます。

3. CSV ソース ファイルを選択します。 

4. 設定ファイルがない場合や、新しい設定ファイルを作成する場合は、既存の設定ファイルの使用チェックボックスは選択しないでください。設定ファイルは、CSV ファイルの見出し行の列名と JIRA サイトのフィールド間のマッピングを指定します。CSV インポートプロセスの最後に、次回からの CSV インポートで使用できる設定ファイルが JIRA によって作成されます。 

5. 詳細設定セクションを展開してファイルのエンコード (既定では UTF-8) および CSV 区切り記号を変更します。CSV ファイルでコンマ以外の別の区切り文字を使用する場合、CSV 区切り記号フィールドでその文字を指定します。

6. Select Next.

プロジェクトのマッピングのセットアップ

1. Choose to import all work items into one (new or existing) Jira project or into multiple Jira projects. To complete this step, fill in the following:

   1. Import to Jira Project - You can choose Select a project if you're importing all work items into a single Jira project. Start typing the name or key of a project that already exists in Jira. Or create a new one from the sidebar by selecting the plus icon (). Note that new projects require a name, key, and lead.
      
      If you want to import work items into multiple Jira projects, choose Defined in CSV. Make sure that every work item in your CSV file includes project name and key data.

   2. 新しいユーザー用のメール サフィックス - CSV ファイルで指定され、インポート中に Jira に追加される新規ユーザー用のメール アドレスのドメインを入力します。

      • インポート ファイルの日付形式 - CSV ファイルで使用される日付形式を指定します。Java SimpleDateFormat に準拠した構文を使用します。

2. Select Next.

フィールドのマッピングのセットアップ

1. [インポート] 列で、選択した Jira プロジェクトにインポートする各 CSV フィールド (CSV ファイルの見出し行によって決定) にチェックを入れます。選択したフィールドのうち 1 つ以上に [要約] フィールドのデータが含まれている必要があります。CSV ファイルで見出し行に同じフィールド名が複数含まれている場合、CSV インポート プロセスではこれらを 1 つのフィールドに結合して でマークします。

2. CSV ファイルで定義したフィールド (前のステップで選択した各 CSVフィールド) に一致させたい Jira フィールドを、[Jira フィールド] 列から選択します。次の手順に進むには、サマリー フィールドを選択する必要があります。インポート プロセスで集約された CSV フィールドに対しては、複数の値をサポートする Jira フィールドのみ選択できます。 

3. CSV ファイルのフィールドの値を Jira にインポートされる前に変更する場合、該当のフィールドの横にある [フィールドの値のマッピング] チェックボックスを選択します。 

4. Select Next.

フィールド値のマッピングのセットアップ

1. 前のステップで選択した各 CSV ファイル フィールド値に Jira フィールド値を指定します。値をそのままインポートする場合は空欄のままにしておきます。 

2. 新しい優先度または解決状況の値を Jira に作成するには、該当するフィールドの横にある [Add new... (新規追加)] をクリックします。 

3. Select Begin Import when you are ready to begin importing your CSV data into Jira. 

4. インポート中、詳細なログをダウンロードして処理の詳細な情報を表示することができます。また、同様の設定で別の CSV ファイルをインポートする必要がある場合は、このインポートの設定を保存することができます。 

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

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