CSVからのイシューインポート

以下の列を含むCSVファイルをアップロードすることで、プロジェクトにイシューをインポートできます：

名前必須ですか？説明
title {チェックサークル｝はいイシューのタイトル
description {チェックサークル｝はいイシューの説明。
due_date {点線円｝いいえ YYYY-MM-DD フォーマットでのイシュー期限。GitLab 15.2 で導入されました。

他のカラムのデータはインポートされません。

description フィールドを使用して、イシューに他のデータを追加するクイックアクションを埋め込むことができます。例えば、ラベル、担当者、マイルストーンなどです。

また、イシューを移動することもできます。イシューを移動すると、より多くのデータが保存されます。

CSVファイルをアップロードしたユーザーは、インポートされたissueの作成者として設定されます。

イシューをインポートするには、少なくともプロジェクトの開発者ロールを持っている必要があります。

インポートの準備

  • いくつかのイシューだけを含むテストファイルをインポートすることを検討してください。GitLab APIを使わずに大きなインポートを元に戻す方法はありません。
  • CSVファイルがファイルフォーマットの要件を満たしていることを確認してください。

ファイルのインポート

イシューをインポートします：

  1. プロジェクトのイシュー・リスト・ページに移動します。
  2. プロジェクトにイシューがあるかどうかによって、インポート機能を開きます：
    • プロジェクトに既存のイシューがある場合：右上の一括編集の横にあるアクション（{ellipsis_v}）>CSVインポートを選択します。
    • プロジェクトにイシューがない：ページの中央で、CSVインポートを選択します。
  3. インポートしたいファイルを選択し、イシューのインポートを選択します。

ファイルはバックグラウンドで処理され、インポート完了後に通知メールが送信されます。

CSVファイル形式

イシューをインポートするために、GitLabはCSVファイルが特定のフォーマットであることを要求します：

要素フォーマット
ヘッダー行CSV ファイルには以下のヘッダを含める必要があります：title とdescription。ヘッダーの大文字と小文字は関係ありません。
カラム title,description,due_date 以外のカラムのデータはインポートされません。
セパレータ列の区切り文字はヘッダー行から検出されます。使用可能な区切り文字は、カンマ (,) 、セミコロン (;) 、タブ (\t) です。行区切り文字はCRLF またはLFのいずれかです。
ダブルクォート文字ダブルクォート（"）文字はフィールドを引用符で囲むために使用され、フィールド内で列の区切り文字を使用することができます（以下のサンプルCSVデータの3行目を参照）"。引用符で囲まれたフィールドに"二重引用符（"）を挿入するには、二重引用符を2つ続けて使用します（""）。
データ行ヘッダー行に続く行は、同じカラム・オーダーを使用する必要があります。イシューのタイトルは必須ですが、説明は任意です。

フィールドに特殊文字（, や\nなど）や複数行がある場合（クイック・アクションを使用する場合など）、その文字をダブルクォーテーション（" ）で囲んでください。

クイックアクションを使用する場合も同様です：

  • 各アクションは独立した行でなければなりません。
  • /label や/milestoneのようなクイックアクションの場合、ラベルやマイルストーンがすでにプロジェクトに存在している必要があります。
  • イシューを割り当てるユーザーは、プロジェクトのメンバーである必要があります。

サンプルCSVデータ

title,description,due_date
My Issue Title,My Issue Description,2022-06-28
Another Title,"A description, with a comma",
"One More Title","One More Description",
An Issue with Quick Actions,"Hey can we change the frontend?

/assign @sjones
/label ~frontend ~documentation",

ファイルサイズ

GitLabインスタンスがどのようにホストされているかによって制限が異なります：

  • セルフマネージド：GitLabインスタンスの設定値Max Attachment Size 。
  • GitLab SaaS：GitLab.comでは10MBに設定されています。