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

Data Center は、Cloud 以外で提供しているアトラシアンの主力アプリです。アプリの Server バージョンのサポートは終了しました。

別のプロジェクト管理ツールから移行する場合、データをカンマ区切り値 (CSV) ファイルにエクスポートし、そのファイルを Jira Cloud アプリにインポートできます。 CSV ファイルは表形式データを表すテキストファイルで、表形式データを処理するほとんどのアプリでサポートされています。

推奨データサイズ

大規模なプロジェクトをインポートする場合は、大規模な CSV ファイルのデータを小規模なバッチに分割して個別にインポートすることをお勧めします。これにより、パフォーマンスの問題が軽減され、インポート速度を最適化できます。また、オフピーク時にインポートすることで、パフォーマンスの問題を回避できます。

Recommended number of work items per file	1500 作業項目
インポートにかかる推定時間	約 1 時間 (これはデータと設定のサイズと複雑さによっても異なります)

CSV ファイルを準備する

新しい Jira インポートエクスペリエンスを試す

A new, faster import experience is available for moving data from third-party apps such as Asana and Notion into Jira business or software spaces. Read about the new Jira import experience

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

すべてのフィールドがカンマで区切られている
すべてのコンテンツ (カンマと改行を含む) は引用符で囲まれます

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

CSV ファイルの要件

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

CSV ファイルのインポートウィザードは、CSV ファイルの見出し行を使用して、ファイルの 2 行目以降のデータを Jira のフィールドにどのようにマッピングするかを決定します。CSV のすべての列ヘッダーが、Jira スペースに存在するフィールドキーと一致することを確認します。

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

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

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

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

Summary, Assignee, Reporter, Work Type, Description, Priority
"Test work item", bob@example.com, bob@example.com, 1, ,

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

Summary, Assignee, Reporter, Work Type, Description, Priority
"Test work item", bob@example.com, bob@example.com, 1

CSV ファイルの構造

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

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

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

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

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

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

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

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

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

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

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

例:

WorkType, Summary, FixVersion, FixVersion, FixVersion, Component, Component
bug, "First work item", v1, , , Component1,
bug, "Second work item", v2, , , Component1, Component2
bug, "Third work item", v1, v2, v3, Component1,

上記の例では、2 番目の作業項目のコンポーネントフィールドと 3 番目の作業項目の修正バージョンフィールドによって、インポート後に関連するフィールドに複数の値が生成されます。

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

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

Assignee, Summary, Description, Attachment, Comment
bob@example.com, "Work item 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;<Atlassian account ID>; This comment works"
bob@example.com, "CSV attachment import with timestamp,author and filename", "Please check the attached image below.", "01/01/2012 13:10;<Atlassian account ID>;image.png;file://image-name.png", "01/01/2012 10:10;<Atlassian account ID>; This comment works"

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

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

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

親/子関係の構築

親/子関係を指定することで、インポートされた作業項目の階層を作成できます。

CSV ファイルに、「作業項目 ID」、「作業タイプ」、「親」という見出しの付いた 3 つの列を追加します。
CSV の各作業項目の [Work item ID (作業項目 ID)] 列に一意の (連続した) 番号が付けられていることを確認します
"親" 列で、作業項目の一意の "作業項目 ID" 番号を参照します
CSV では、ファイル内のサブタスクまたは子作業項目の前に親作業項目が表示される必要があります
You should also double-check that the parent issue keys referenced in your CSV exist in the same file or in the space

Refer to CSV import parent-child mapping for more details and examples of the required mappings.

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.

WorkType, Summary, FixVersion, FixVersion, FixVersion, Component, Component, Work item ID, Parent, Reporter
Bug, "First work item", v1, , , Component1, , 1, , abcde-12345-fedcba
Story, "Second work item", v2, , , Component1, Component2, 2, 5, fedcb-12345-edcba
Bug, "Third work item", v1, v2, v3, Component1, , 3, , abcde-12345-fedcba
Sub-task, "Fourth work item", v1, v2, , Component2, , , 2, fedcb-12345-edcba
Epic, "Fifth work item", v1, v2, v3, Component1, , 5, , abcde-12345-fedcba

If you’re importing data for multiple spaces, you’ll be able to create cross-space parent and child relationships in your CSV file.

Importing work items into multiple Jira spaces

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

Adding two columns to your CSV file with the headings "Space name" and "Space key"
Ensuring that every work item represented in your CSV file contains the name and key in these columns for the corresponding Jira spaces

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

この例では、CSV ファイルの " スペース名" フィールドと " スペースキー" フィールドを Jira の対応する "スペース名 " フィールドと "スペースキー" フィールドに一致させている場合、1 番目と 2 番目の作業項目は "Sample" スペース ( スペースキーは "SAMP") にインポートされ、3 番目の作業項目は "Example" スペース ( スペースキーは "EXAM") にインポートされます:

WorkType, Summary, Space Name, Space Key
bug, "First work item", Sample, SAMP
bug, "Second work item", Sample, SAMP
task, "Third work item", Example, EXAM

未解決の作業タイプの処理方法

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

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

[解決状況]、[優先度]、[作業タイプ]、および [ステータス] フィールドでは、次の項目を選択できます。

空白としてインポート - これによって、そのフィールドのJira 値は空白になります。未解決の作業項目をインポートする場合は、[解決状況] フィールドのフィールドマッピングを作成し、値を [未解決] から [空としてインポート] に変更する必要があります。
マッピングなし - これは CSV ファイルの値をそのままインポートしようとするものです。フィールド値がその値をサポートしていないJira フィールドにマッピングされている場合は、インポートが失敗するので注意してください。[ステータス] と [作業タイプ] へのフィールドマッピングでは、 "空白としてインポート" を選択した場合、既定値が使用されます。

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

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

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

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

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

Summary,Multi Select,Multi Select,Multi Select
Sample work item,Value 1,Value 2,Value 3

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

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

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

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

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

既存の作業項目の更新

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:

Work item 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!>>,

CSV ファイルのインポート

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

ファイルのアップロード

> [システム] の順に選択します。
[インポートとエクスポート] セクションで、[外部システムのインポート] > [CSV] の順にクリックします。
1. 新しいインポートエクスペリエンスが表示される場合は [ 旧エクスペリエンスに切り替える] を選択して、CSV ファイルインポートウィザードに進みます。
CSV ソースファイルを選択します。
設定ファイルがない場合や、新しい設定ファイルを作成する場合は、既存の設定ファイルの使用チェックボックスは選択しないでください。設定ファイルは、CSV ファイルの見出し行の列名と JIRA サイトのフィールド間のマッピングを指定します。CSV インポートプロセスの最後に、次回からの CSV インポートで使用できる設定ファイルが JIRA によって作成されます。
詳細設定セクションを展開してファイルのエンコード (既定では UTF-8) および CSV 区切り記号を変更します。CSV ファイルでコンマ以外の別の区切り文字を使用する場合、CSV 区切り記号フィールドでその文字を指定します。
[次へ] を選択します。

Set up space mappings

すべての作業項目を 1 つ (新規または既存) の Jira スペースにインポートするか、複数の Jira スペースにインポートするかを選択します。このステップを実施するには、以下を入力します。
1. Import to Jira space - You can choose Select a space if you're importing all work items into a single Jira space. Start typing the name or key of a space that already exists in Jira. Or create a new one from the sidebar by selecting the plus icon (). Note that new spaces require a name, key, and lead.
  
  If you want to import work items into multiple Jira spaces, choose Defined in CSV. Make sure that every work item in your CSV file includes space name and key data.
2. 新しいユーザー用のメールサフィックス - CSV ファイルで指定され、インポート中に Jira に追加される新規ユーザー用のメールアドレスのドメインを入力します。
  - Date format in import file - Specify the date format used in your CSV file using syntax that complies with the Java SimpleDateFormat.
[次へ] を選択します。

Check if the selected space contains the same work items with the same key as the ones in the CSV file. Otherwise, Jira will import the work items to the selected space and give them new keys.

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

In the Import column, check each CSV Field (determined by your CSV file's header row) that you want to import into your chosen Jira space. Note that at least one of the selected fields must contain data for the Summary field. If your CSV file contains more than one of the same field name in its header row, the CSV import process will combine these into a single field marked with .
CSV ファイルで定義したフィールド (前のステップで選択した各 CSVフィールド) に一致させたい Jira フィールドを、[Jira フィールド] 列から選択します。次の手順に進むには、サマリーフィールドを選択する必要があります。インポートプロセスで集約された CSV フィールドに対しては、複数の値をサポートする Jira フィールドのみ選択できます。
CSV ファイルのフィールドの値を Jira にインポートされる前に変更する場合、該当のフィールドの横にある [フィールドの値のマッピング] チェックボックスを選択します。
[次へ] を選択します。

CSV ファイルがコメント付きの Jira Service Management スペースで構成されていて [Jiraフィールド] 列の [コメント本文] にマッピングされている場合は、CSV インポート後にインポートファイルのすべてのコメントが公開されます。

CSV フィールドと Jira フィールドのマッチングに関する詳細については、以下の「CSV データを Jira フィールドにインポートするためのヒント」をご参照ください。

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

We don't support mapping company-managed work types to team-managed work types. To avoid incomplete or incorrect mappings, we've removed the ability to create a new work type or map the work type as is when you import data to a team-managed space. You'll have to map the work type to an already existing work type.

前のステップで選択した各 CSV ファイルフィールド値に Jira フィールド値を指定します。値をそのままインポートする場合は空欄のままにしておきます。
新しい優先度または解決状況の値を Jira に作成するには、該当するフィールドの横にある [Add new... (新規追加)] をクリックします。
CSV データを Jira にインポートする準備ができたら、[インポート開始] を選択します。
インポート中、詳細なログをダウンロードして処理の詳細な情報を表示することができます。また、同様の設定で別の CSV ファイルをインポートする必要がある場合は、このインポートの設定を保存することができます。

If you have any questions or encounter any problems, please contact Atlassian support.

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

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

Jira フィールド	インポート時の注意
スペース	CSV data is imported on a per-space basis. You can specify an existing Jira space or let the importer automatically create a new space for you at time of import.
要約	これは唯一の必須フィールドです。
作業項目キー	インポートされた作業項目の作業項目キーを設定できます。所定のキーを持つ作業項目が Jira にすでに存在する場合は、代わりにそのキーが更新されます。
Component	個別の列に各コンポーネントを入力することで、複数のコンポーネントを持つ作業項目をインポートできます。
影響バージョン	You can import work items with multiple "Affects Version" values by entering each version in a separate column.
Fix Version (修正バージョン)	You can import work items with multiple "Fix Version" values by entering each version in a separate column.
コメント本文	個別の列に各コメントを入力することで、複数のコメントを持つ作業項目をインポートできます。
作成日	CSV インポートウィザードの 2 番目の手順で指定した日付形式を使用してください。
更新日	CSV インポートウィザードの 2 番目の手順で指定した日付形式を使用してください。
期限	CSV インポートウィザードの 2 番目の手順で指定した日付形式を使用してください。
作業タイプ	If not specified in your CSV file, imported work items will be given the default (i.e. first) Work Type as specified in your Jira site.
Work item rank	作業項目のランクは保持されないため、ソフトウェアスペースボードの手動によるランク付けはすべて失われます。
ラベル	You can import work items with multiple labels by entering each label in a separate column.
優先度	CSV ファイルでステータスが指定されていない場合、インポートされた作業項目には、Jira システムで指定されている既定 (1 番目) の1 番目）優先度が設定されます。インポート処理中にオンザフライで新しい JIRA 値を作成することもできます。
ソリューション	CSV ファイルでステータスが指定されていない場合、インポートされた作業項目には、Jira システムで指定されている既定 (1 番目) の1 番目）の解決状況が設定されます。インポート処理中にオンザフライで新しい JIRA 値を作成することもできます。役立つヒントについては、「未解決の作業項目の取り扱い方法」を参照してください。
ステータス	Jira の既存のワークフローステータスにのみマッピングできます。CSV ファイルでステータスが指定されていない場合、インポートされた作業項目には、Jira システムで指定されている既定 (1 番目) のステータスが設定されます。
初期見積 (Original Estimate)	このフィールドの値は、秒数で指定する必要があります。
残余見積 (Remaining Estimate)	このフィールドの値は、秒数で指定する必要があります。
所要時間 (Time Spent)	このフィールドの値は、秒数で指定する必要があります。
ユーザー	サポート対象のユーザータイプメールアドレス Atlassian アカウント ID ユーザーを作成担当者または報告者フィールドの値として、インポーターに Jira ユーザーを自動で作成させることも可能です。ユーザーは、Jira のアクティブなアカウントとして作成されます。ユーザーは Jira への初回のログイン時にパスワードをメールで通知してもらう必要があります。実名でないユーザーは、メールアドレス (ログイン名) の "@" 文字の前の部分を Jira でのフルネームとして取得します。外部のユーザー管理機能を使用している場合、インポートのプロセスで Jira ユーザーを作成することはできません。代わりに、作成が必要な新規ユーザーの一覧がインポーターによって提供されます。インポートを開始する前に外部のユーザーリポジトリでユーザーを作成する必要があります。ユーザー数制限付きライセンス（例: パーソナルライセンス）で、必要なユーザー数が制限数を超える場合、インポートは停止されます。作成できないユーザーのリストを示すページが表示されます。担当者および報告者がマッピングされない場合、ユーザーは作成されません。ユーザーの更新 Jira Service Management のポータルのみの顧客のデータの挙動は、ほかのユーザーアカウントデータとは異なります。ポータルのみの顧客のデータがインポートデータと宛先サイトとで異なる場合、宛先サイトのデータが使用されます。
ウォッチャー	If you have users specified as Watchers in your CSV file, and these users do not exist in Jira, they will not be imported. A user must be available in Jira before you can import them as a watcher on a specific work items.
その他のフィールド	その他のフィールドをインポートする場合は、特定の Jira カスタムフィールドへのマッピングを行うことができます。Jira にカスタムフィールドが存在しない場合、インポーターによってカスタムフィールドが自動的に作成されます。カスタムフィールドが日付フィールドの場合、CSV インポーターウィザードの 2 番目の手順で指定した日付形式を使用してください。

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

正確ではなかった明確ではなかった関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問