イシューをCSVにエクスポート

イシューはGitLabからCSV形式でエクスポートでき、デフォルトの通知メールに添付ファイルとして送信されます。

概要

イシューをCSVにエクスポートすると、あなたとあなたのチームは、イシューから収集したすべてのデータを カンマ区切り値(CSV) ファイルにエクスポートできます。

CSVは、あるプログラムが他のプログラムの通常の出力を読みこむことができない場合に、データを転送する便利な方法です。 参考

CSVファイルは、プロッターや、Microsoft Excel、Open Office Calc、Google Spreadsheetsなどの表計算ソフトで使用できます。

ユースケース

イシューをCSVにエクスポートする数多くのユースケースとして次のようなものがあります。

  • イシューのスナップショットを作成してオフラインで分析したり、GitLabを利用していない他のチームとのコミュニケーションができます。
  • CSVデータからの図・グラフ・チャートの作成
  • 監査や共有のためにデータを他の形式で提示する
  • イシューをGitLab以外のシステムにインポートする
  • 時間軸に沿って複数のスナップショットを作成し、長期的なイシューのデータ分析
  • 長期的なデータを利用して、イシューに寄せられた関連するフィードバックを収集し、実際の指標に基づいて製品を改善する。

どのイシューを取り込むかの選択

プロジェクトを選択した後、イシューのページでは、検索バーや［すべて］／［オープン］／［クローズ］タブを使用して、エクスポートするイシューを絞り込むことができます。 最初のページに表示されていないイシューも含め、絞り込まれたすべてのイシューがエクスポートされます。

CSV export button

書き出しのためのイシュー数とメールアドレスを確認し、その後メールの作成が開始されます。

CSV export modal dialog

ソート

エクスポートされたイシューは常にIssue IDでソートされます。

フォーマット

Time EstimateとTime Spentカラムは、GitLab Starter 10.0で導入されました。

WeightとLockedカラムはGitLab Starter 10.8で導入されました。

データは、カラムの区切り文字としてカンマを使用し、必要に応じて" 、行を区切るために改行を使用してエンコードされます。最初の行はヘッダーとなり、値の説明とともに以下の表に記載されています：

カラム 説明
Issue ID イシューiid
URL GitLab上のイシューへのリンク
タイトル イシューtitle
State Open またはClosed
説明 イシューdescription
Author イシュー作成者のフルネーム
Author Username 作成者のユーザー名。@ シンボルは省略。
Assignee イシューの担当者のフルネーム
Assignee Username 作成者のユーザー名。@ シンボルは省略。
Confidential Yes またはNo
Locked Yes またはNo
Due Date 書式YYYY-MM-DD
作成日時(UTC) 書式YYYY-MM-DD HH:MM:SS
更新日時(UTC) 書式YYYY-MM-DD HH:MM:SS
Milestone イシューのマイルストーンのタイトル
Weight イシューのウェイト
ラベル で結合されたラベルのタイトルです。,
Time Estimate 見積時間（単位：秒)
Time Spent 実績時間（秒)
Epic ID 親エピックのID 12.7で導入
Epic Title 親エピックのタイトル 12.7で紹介

制限事項

  • グループのイシュー一覧からは、イシューをCSVにエクスポートできません。
  • イシューは電子メールの添付ファイルとして送信されるため、エクスポートできるデータ量には制限があります。 現在、この制限は、さまざまな電子メール・プロバイダで正常に配信されるように15MBとなっています。 この制限に達した場合は、オープンイシューとクローズイシューを別々にエクスポートするなどして、エクスポート前に検索対象を絞り込むことをお勧めします。