イシューをCSVにエクスポート
- GitLab Starter 9.0で導入されました。
- GitLab 12.10でGitLab Coreに移行しました。
イシューはGitLabからCSV形式でエクスポートでき、デフォルトの通知メールに添付ファイルとして送信されます。
概要
イシューをCSVにエクスポートすると、あなたとあなたのチームは、イシューから収集したすべてのデータを カンマ区切り値(CSV) ファイルにエクスポートできます。
CSVは、あるプログラムが他のプログラムの通常の出力を読みこむことができない場合に、データを転送する便利な方法です。 参考
CSVファイルは、プロッターや、Microsoft Excel、Open Office Calc、Google Spreadsheetsなどの表計算ソフトで使用できます。
ユースケース
イシューをCSVにエクスポートする数多くのユースケースとして次のようなものがあります。
- イシューのスナップショットを作成してオフラインで分析したり、GitLabを利用していない他のチームとのコミュニケーションができます。
- CSVデータからの図・グラフ・チャートの作成
- 監査や共有のためにデータを他の形式で提示する
- イシューをGitLab以外のシステムにインポートする
- 時間軸に沿って複数のスナップショットを作成し、長期的なイシューのデータ分析
- 長期的なデータを利用して、イシューに寄せられた関連するフィードバックを収集し、実際の指標に基づいて製品を改善する。
どのイシューを取り込むかの選択
プロジェクトを選択した後、イシューのページでは、検索バーや[すべて]/[オープン]/[クローズ]タブを使用して、エクスポートするイシューを絞り込むことができます。 最初のページに表示されていないイシューも含め、絞り込まれたすべてのイシューがエクスポートされます。
書き出しのためのイシュー数とメールアドレスを確認し、その後メールの作成が開始されます。
ソート
エクスポートされたイシューは常に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となっています。 この制限に達した場合は、オープンイシューとクローズイシューを別々にエクスポートするなどして、エクスポート前に検索対象を絞り込むことをお勧めします。