CSV インポーターで作業項目を作成する

Comma-separated value (CSV) files are text files that represent tabulated data, and are supported by most systems that handle tabulated data, such as spreadsheets and databases. The CSV importer allows you to import data from external systems that can export their data in a tabulated format. It also allows you to create your own CSV file to perform bulk work item creation and updates.

CSV ファイルを準備する

You can base the structure of your CSV file off the default Microsoft Excel CSV format. Fields should be separated by commas, and any content that must be treated literally (such as commas, new lines, and carriage returns) should be enclosed in quotes. Microsoft Excel and OpenOffice automatically quote values in cells, so there is no need to quote these values manually. 

CSV ファイルの要件

• CSV files must be well-formed.

• Each CSV file must possess a heading row with a summary column. The header row is used to determine how to map data from the CSV file's 2nd row and beyond to fields in your project's work items. The header row should avoid containing any punctuation (apart from the commas separating each column) or the importer may not work correctly.

• 空の列値に対して、コンマは省略できません。たとえば、次に示す 2 番目のスニペットでは、空の "説明" フィールドと "優先度" フィールドのコンマが省略されていますが、これは許可されていません。

以下は有効な例です。

次の例は有効ではありません。

CSV ファイルのデータを構造化する方法

複数行にまたがるデータ

複数行にまたがるデータを取り込むには、CSV ファイルで二重引用符 (") を使用します。たとえば、インポート時に、Jira は以下を単一レコードの有効な CSV ファイルとして扱います。

文字通りに扱われる必要がある特殊文字

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

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

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

Once imported, will be stored in Jira as:

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

Aggregating multiple values into a single field

You can import multiple values into a 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 field. The number of column names specified must match the maximum number of values to be aggregated into the mapped field. For example:

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 appropriate fields upon import.

添付ファイル

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 インスタンスが必ずアクセスできる任意の場所を設定できます。 

Importing data into multiple projects

You can import work items from your CSV file into different projects through a CSV file import. To do this, add two columns to your CSV file with the "Project Name" and "Project Key" headings.

Make sure that every work item in your CSV file has a project name and project key in the relevant column. The project name and project key are the minimum project data required for importing work items from a CSV file into specific projects.

In the following example, the first and second work items will be imported into the 'Sample' project (with project key 'SAMP'), while the third work item will be imported into the 'Example' project (with project key 'EXAM'):

作業ログ エントリー

CSV ファイルには作業ログ エントリーを含めることができます。経過時間の追跡には秒を使用します。例:

複数選択のカスタム フィールド

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

カスケード選択カスタム フィールド

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

Select List (cascading) custom fields cannot be imported using this method. You can track the suggestion here: JRACLOUD-34202. Instead, Jira administrators can use the method in Settings (), then System, then External System Import to import Select List (cascading) fields. 

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

1. Select Filters in the sidebar, then select Search work items.

2. Select More ( ••• ), then Import work items from CSV. 

3. インポートする CSV ソース ファイルを選択します。[設定ファイルがない場合または新しい設定ファイルを作成する場合] を選択し、[既存の設定ファイルを使用する] オプションは選択しないようにします。設定ファイルは、CSV ファイルの見出し行の列名と Jira インストールのフィールド間のマッピングを指定します。インポート プロセスの最後に設定ファイルを作成するオプションがあります。 

4. Select Next and fill in the required information. If your CSV file uses a different separator character other than a comma, specify that character in the CSV Delimiter field. If the separator is a tab, this can be entered using the format "/t".

5. Select Next and map the column headers of your CSV file to the fields in your selected project. If you want to select specific Jira field values to map specific CSV values to, check the Map field value option. You must map a CSV field to the summary field, as all work items created must have a summary. 

6. Select Next one more time and select which CSV field values selected in the previous step you want to map to specific field values. For example, you might want to map the CSV field value of "Feature Request" to the Jira work type field value "New Feature".

7. Select Begin Import when you are ready to begin importing your CSV data into Jira. If you want to check for any errors or warnings, click Validate before beginning your import. If you want to import another CSV file with similar settings (e.g. similar field value mappings), you can save the configuration by downloaded a CSV configuration file. 

注意点

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

• インポートに問題が発生したときや、プロセスについて詳細が必要な場合は、詳細ログをダウンロードできます。

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

Below are some helpful tips when importing data from your CSV file into specific fields:

If you have any questions or encounter any problems during the CSV import process, please contact Atlassian support.