CSV インポーターを使用して作業項目を作成する
カンマ区切り (CSV) ファイルは、表形式のデータを表すテキスト ファイルです。ほとんどのスプレッドシートやデータベース システムが CSV ファイルをサポートしています。
CSV インポーターを使用すると、表形式のデータをエクスポートできる外部システムからデータをインポートできます。また、独自の CSV ファイルを作成して、作業項目の一括作成や更新を実行することもできます。
本ページに記載されている内容を実行するには、次のものが必要です。
ロール: スペース 管理者, アプリ管理者
権限: [作業項目を作成]、[一括変更の実行]
管理者権限のないユーザーは、CSV ファイルを使って 250 件の作業項目をインポートできます。Jira 管理者の場合は、より高度な構成を確認してください。
CSV インポートによる作業項目の一括作成オプションでは、親子階層関係を持つ作業項目をマッピング (例: イニシアチブからエピック、ストーリー、サブタスクにマッピング) することはできません。
階層をマッピングするには、代わりに CSV 外部システム インポートを使用してください。詳細については、「CSV ファイルを使用したデータのインポート」および「CSV インポートの親子マッピング」をご参照ください。
CSV ファイルを準備する
CSV ファイルの構造は、既定の Microsoft Excel CSV 形式に基づいたものにできます。フィールドはカンマで区切る必要があります。リテラルとして扱う必要があるコンテンツ (カンマ、改行、キャリッジ リターンなど) は、引用符で囲む必要があります。Microsoft Excel や OpenOffice では、セルの値が自動的に引用符で囲まれるため、手動で囲む必要はありません。
CSV ファイルの要件
CSV ファイルは整形式である必要があります。
各 CSV ファイルには、[要約] 列を含むヘッダー行が必要です。ヘッダー行は、CSV ファイルのデータをスペースの作業項目のフィールドにマッピングするために使用されます。
ヘッダー行に (列を区切るカンマ以外の) 句読点を含めないでください。句読点が含まれていると、インポーターが正常に動作しない可能性があります。
空の列値に対するカンマを省略しないでください。
有効な例:
Summary, Assignee, Reporter, WorkType, Description, Priority
"Test work item", bob@example.com, bob@example.com, Task,誤った例 (空のフィールドのカンマが欠落している場合):
Summary, Assignee, Reporter, WorkType, Description, Priority
"Test work item", bob@example.com, bob@example.com, 1CSV ファイルのデータを構造化する
複数行にまたがるデータ
複数行にまたがるデータを取り込むには、二重引用符 (") を使用します。次に例を示します。
Summary, Description, Status
"Login fails", "This is on
a new line", Open文字通りに扱われる必要がある特殊文字
特殊文字を文字どおりに扱うには、テキストを二重引用符 (") で囲みます。インポートされると、特殊文字はフィールド データに含まれます。二重引用符自体を含めるには、別の二重引用符で「エスケープ」してください。
例:
"Selecting the ""Add"" button results in a page not found error"次のように保存されます。
Selecting the "Add" button results in a page not found error
複数の値を単一のフィールドに集約する
複数の値を受け入れるフィールド ([修正バージョン]、[コンポーネント]、[ラベル] など) に複数の値をインポートするには、各値に同じ列名を指定します。指定される列名の数は、マッピングされるフィールドに集約される値の最大数と一致している必要があります。
例:
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 インポーターでは、単一の値のみをサポートしているフィールドに集約データをインポートできません。
添付ファイル
[添付ファイル] 列に 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;Admin; 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;bob@example.com;image.png;file://image-name.png", "01/01/2012 10:10;Admin; This comment works"添付ファイルの URL は HTTP または HTTPS を使用している必要があり、Jira インスタンスがアクセスできる場所にある必要があります。
複数のスペースにデータをインポートする
CSV ファイルのインポートを使用して、CSV ファイルから別のスペースに作業項目をインポートできます。これを行うには、CSV ファイルに「スペース名」と「スペース キー」というヘッダーを持つ 2 つの列を追加します。
CSV ファイル内のすべての作業項目の関連する列に、スペースの名前とキーが含まれていることを確認してください。スペース名とスペース キーは、CSV ファイルから特定のスペースに作業項目をインポートするために必要な最小限のデータです。
次の例では、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作業ログ エントリー
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複数選択のカスタム フィールド
複数の値を持つ複数選択カスタム フィールドに値を入力するには、同じヘッダーを持つ複数の列を使用します。次に例を示します。
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選択リスト (カスケード) カスタム フィールドは、この方法ではインポートできません。機能の提案を追跡してください。代わりに、Jira 管理者は [設定] () > [システム] > [外部システム インポート] の順に移動して操作できます。
CSV ファイル インポート ウィザードを実行する
CSV ファイルから作業項目をインポートするには、次の手順に従います。
サイドバーで [フィルター] > [作業項目の検索] の順に選択します。
[その他の操作] (•••) > [Import work items from CSV (CSV から作業項目をインポート)] の順に選択します。
インポートする CSV ファイルを選択します。設定ファイルがない場合は、[既存の設定ファイルを使用する] のチェックを外したままにします。設定ファイルは、CSV ファイルのヘッダー行の列名を Jira のフィールドにマッピングするもので、インポート後に作成できます。
[次へ] を選択して必要な情報を入力します。CSV ファイルで別の区切り文字を使用している場合は、[CSV 区切り文字] フィールドで指定します。区切りが Tab の場合、「/t」という形式で入力できます。
[次へ] を選択し、CSV ファイルの列ヘッダーをスペースのフィールドにマッピングします。CSV フィールドを [要約] フィールドに必ずマッピングする必要があります。特定の Jira フィールド値を特定の CSV 値にマッピングするには、[フィールド値をマッピング] を選択します。
[次へ] を選択し、必要に応じて特定の CSV フィールド値を Jira のフィールド値にマッピングします (たとえば、CSV フィールド値「Feature request」を、Jira の作業タイプ フィールド値「New feature」にマッピングできます)。
[インポートを開始] を選択して、CSV データのインポートを開始します。インポートする前にエラーや警告を確認するには、[検証] を選択します。設定を保存しておけば、次回以降に同様の設定でインポートする際に使用できます。
注意
フィールド値のマッピング時に値を現状のままインポートするには、フィールドを空欄のままにしておくか、フィールド内のコンテンツを消去します。
インポートで問題が発生した場合や、プロセスの詳細情報を確認したい場合は、詳細なログをダウンロードできます。
CSV データを Jira フィールドにインポートするためのヒント
データを CSV ファイルから特定のフィールドにインポートする場合に役立つヒントを以下に示します。
フィールド | インポート時の注意 |
|---|---|
スペース | CSV データはスペース単位でインポートされます。対象として既存のスペースを指定するか、インポーターでインポート時に自動的に新規スペースを作成します。 |
要約 | これは唯一の必須フィールドです。 |
コンポーネント | 個別の列に各コンポーネントを入力することで、複数のコンポーネントを持つ作業項目をインポートできます。 |
影響バージョン | 単独の列に各バージョンを入力することで、複数の「影響を受けたバージョン」を持つ作業項目をインポートできます。 |
修正バージョン | 個別の列に各バージョンを入力することで、複数の「修正バージョン」を持つ作業項目をインポートできます。 |
期限 | CSV インポート ウィザードの 2 番目の手順で指定した日付形式を使用してください。 |
作業タイプ | CSV ファイルでステータスが指定されていない場合、インポートされた作業項目には、Jira のインスタンスで指定された既定の (最初の) 作業タイプに設定されます。作業タイプ フィールド値の定義の詳細をご確認ください。 インポートの過程で、まとめて新しい値を作成することもできます。 |
ラベル | 単独の列に各ラベルを入力することで、複数のラベルを持つ作業項目をインポートできます。 |
優先度 | CSV ファイルでステータスが指定されていない場合、インポートされた作業項目には、Jira システムで指定されている既定 (1 番目) のJira インスタンスで指定された既定の (最初の) 優先度に設定されます。 インポートの過程で、まとめて新しい値を作成することもできます。 |
初期見積 | このフィールドの値は、秒数で指定する必要があります。 |
残余見積 | このフィールドの値は、秒数で指定する必要があります。 |
消費時間 | このフィールドの値は、秒数で指定する必要があります。 |
ユーザー | ユーザーを作成 ユーザー タイプのすべてのシステム フィールドで、以下をサポートしています。
担当者または報告者フィールドの値として、インポーターに Jira ユーザーを自動で作成させることも可能です。
ユーザーの更新 Jira Service Management のポータルのみの顧客データの挙動は、ほかのユーザー アカウント データとは異なります。ポータル限定のカスタマー データがインポートと宛先で異なる場合は、宛先サイトのデータが使用されます。 |
必須フィールド | 必須フィールドを持つスペースにインポートするときは、使用されている作業タイプに関連付けられた [作業項目を作成] 画面にそのフィールドを含める必要があります。フィールド動作の指定に関する詳細をご確認ください。 |
その他のフィールド | その他のフィールドをインポートする場合は、特定の Jira カスタムフィールド へのマッピングを行うことができます。JIRA にカスタムフィールドがまだ存在していない場合、インポーターは自動的にカスタムフィールドを作成します。カスタムフィールが日付フィールドの場合、CSV インポーター ウィザードの 2 番目の手順で指定した日付形式を使用してください。 |
ご不明な点がある、または CSV インポート プロセス中に問題が生じた場合は、アトラシアン サポートにご連絡ください。
この内容はお役に立ちましたか?