正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

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

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

次の列を含むCSV（カンマ区切り値）ファイルをアップロードして、イシューをプロジェクトにインポートできます:

名前必須説明
titlecheck-circle 対応イシューのタイトル。
descriptioncheck-circle 対応イシューの説明。
due_datedotted-circle 対象外YYYY-MM-DD形式のイシューの期日。
milestonedotted-circle 対象外イシューのマイルストーンのタイトル。GitLab 16.7で導入されました。
typedotted-circle 対象外イシューのタイプ。GitLab 18.4で導入されました。

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

descriptionフィールドを使用して、クイックアクションを埋め込み、他のデータをイシューに追加できます。たとえば、ラベル、アサイン、およびマイルストーンなどです。

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

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

イシューをインポートするには、プロジェクトのプランナーロールまたは少なくともデベロッパーロールが必要です。

インポートの準備

  • いくつかのイシューのみを含むテストファイルのインポートを検討してください。GitLab APIを使用せずに大規模なインポートを元に戻す方法はありません。
  • CSVファイルがファイル形式の要件を満たしていることを確認してください。
  • CSVにマイルストーンヘッダーが含まれている場合は、ファイル内の一意のマイルストーンタイトルがすべて、プロジェクトまたはその親グループにすでに存在することを確認してください。

ファイルをインポート

イシューをインポートするには:

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

ファイルはバックグラウンドで処理され、エラーが検出された場合、またはインポートが完了すると、通知メールが送信されます。

CSVファイル形式

イシューをインポートするには、GitLabでCSVファイルに特定の形式が必要です。

GitLabで表示した場合にインポートされたファイルの表示方法に影響を与える可能性のあるCSV解析要件については、CSV解析に関する考慮事項を参照してください。

要素形式
ヘッダー行CSVファイルには、次のヘッダーを含める必要があります：titleおよびdescription。ヘッダーの大文字と小文字は区別されません。
列title、description、due_date、milestone、type以外の列のデータはインポートされません。
区切り文字列の区切り文字は、ヘッダー行から検出されます。サポートされている区切り文字は、カンマ（,）、セミコロン（;）、およびタブ（\t）です。行の区切り文字は、CRLFまたはLFのいずれかです。
二重引用符二重引用符（"）文字は、フィールドを引用符で囲むために使用され、フィールドで列の区切り文字を使用できるようになります（以下のサンプルCSVデータの3行目を参照）。引用符で囲まれたフィールドに二重引用符（"）を挿入するには、2つの二重引用符文字を連続して使用します（""）。
データ行ヘッダー行の後、後続の行は同じ列の順序を使用する必要があります。イシューのタイトルは必須ですが、説明はオプションです。

フィールドに特殊文字（たとえば、,または\n）または複数行がある場合（たとえば、クイックアクションを使用する場合）、文字を二重引用符（"）で囲みます。

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

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

CSVデータのサンプル:

title,description,due_date,milestone
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",
An issue with milestone,"My milestone is created",,v1.0

ファイルサイズ

制限は、GitLabインスタンスのホスト方法によって異なります:

  • GitLab Self-Managed: GitLabインスタンスのMax Attachment Sizeの設定値によって設定されます。
  • GitLab SaaS: GitLab.comでは、10MBに設定されています。