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

To-Doリスト

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

あなたのTo-Doリストは、あなたの入力を待っている項目の時系列リストです。これらの項目は、to-do itemsと呼ばれます。

GitLabで行う作業に関連するアクションを追跡するために、To-Doリストを使用できます。他のユーザーがあなたに連絡したり、あなたの注意が必要な場合、To-DoアイテムがTo-Doリストに表示されます。

To-Doリストへのアクセス

To-Doリストにアクセスするには:

左側のサイドバーの上部にあるTo-Doリスト ( task-done ) を選択します。

To-Doリストのフィルター

To-Doリストをフィルタリングするには:

  1. リストの上にあるテキストボックスにカーソルを置きます。
  2. 定義済みのフィルターのいずれかを選択します。
  3. Enterキーを押します。

To-Doリストのソート

To-Doリストをソートするには:

  1. To Doタブの右上隅で、オプションから選択します:

    • おすすめは、作成日と以前にスヌーズされた日付の組み合わせでソートされ、以前にスヌーズされたアイテムが一番上に表示されます。
    • 更新は、アイテムが最後に更新された日付でソートされます。
    • ラベルの優先度は、設定した優先順位でソートします。
  2. オプション。ソート順を選択します。

スヌーズタブと完了タブでは、おすすめはアイテムを作成日のみでソートします。

To-Doアイテムを作成するアクション

この機能の利用可否は、機能フラグによって制御されます。詳細については、履歴を参照してください。

多くのTo-Doアイテムが自動的に作成されます。あなたのTo-DoリストにTo-Doアイテムを追加するアクションの一部:

  • イシューまたはマージリクエストがあなたに割り当てられます。
  • マージリクエストのマージリクエストのレビューがリクエストされます。
  • イシュー、マージリクエスト、またはエピックの説明またはコメントでメンションされます。
  • コミットまたはデザインに関するコメントでメンションされます。
  • あなたのマージリクエストのCI/CDパイプラインが失敗します。
  • オープンマージリクエストは競合のためにマージできず、次のいずれかが該当します:
    • あなたが作成者です。
    • あなたがパイプラインが成功した後で、自動的にマージするようにマージリクエストを設定したユーザーです。
  • マージリクエストがマージトレインから削除され、あなたがそれを追加したユーザーです。
  • あなたがオーナーであるグループまたはプロジェクトに対して、メンバーアクセスリクエストが提起されます。

GitLab 17.8以降では、同じイシューまたはマージリクエストであっても、誰かがあなたにメンションするたびに、新しい通知を受け取ります。

割り当てやレビューリクエストなど、To-Doアイテムを作成する他のアクションでは、同じイシューまたはマージリクエストでそのアクションが複数回発生した場合でも、アクションの種類ごとに1つの通知のみを受信します。

To-Doアイテムは、GitLab通知メール設定の影響を受けません。唯一の例外: 通知がカスタムに設定され、あなたの承認が適格なマージリクエストが作成されましたが選択されている場合、マージリクエストを承認する資格がある場合にTo-Doアイテムを取得します。

To Doアイテムを作成する

To-Doリストに項目を手動で追加できます。

  1. 以下にアクセスします:

    • イシュー
    • マージリクエスト
    • エピック
    • デザイン
    • インシデント
    • 目標または主な成果
    • タスク
  2. 右上隅で、To-Doアイテムを追加 ( todo-add ) を選択します。

他のユーザーにメンションしてTo-Doアイテムを作成する

コードブロックを除く任意の場所で他のユーザーにメンションすることにより、To-Doアイテムを作成できます。1つのメッセージでユーザーを何度もメンションすると、1つのTo-Doアイテムのみが作成されます。

たとえば、次のコメントでは、frankを除くすべてのユーザーに対してTo-Doアイテムが作成されます:

@alice What do you think? cc: @bob

- @carol can you please have a look?

> @dan what do you think?

Hey @erin, this is what they said:

```
Hi, please message @frank :incoming_envelope:
```

To-Doアイテムを完了としてマークするアクション

To-Doアイテムオブジェクト(例えば、イシュー、マージリクエスト、またはエピック)に対するさまざまなアクションは、対応するTo-Doアイテムを完了としてマークします。

To-Doアイテムは、次の場合に完了としてマークされます:

  • 説明またはコメントに絵文字リアクションを追加します。
  • ラベルを追加または削除します。
  • 担当者を変更します。
  • マイルストーンを変更します。
  • To-Doアイテムのオブジェクトを閉じます。
  • コメントを作成します。
  • 説明を編集します。
  • デザインディスカッションスレッドを解決します。
  • プロジェクトまたはグループメンバーシップリクエストを承認または拒否します。

To-Doアイテムは、次の場合には完了としてマークされnot(ません):

  • リンクされたアイテム(リンクされたイシューなど)を追加します。
  • 子エピックまたはタスクなどの子アイテムを追加します。
  • タイムトラッキングを追加。
  • 自分自身を割り当てます。
  • イシューのヘルスステータスを変更します。

他の誰かがイシュー、マージリクエスト、またはエピックを閉じたり、アクションを実行した場合、あなたのTo-Doアイテムは保留中のままになります。

To-Doアイテムを完了としてマーク

To-Doアイテムを手動で完了としてマークできます。

これを行うには、2つの方法があります:

  • Todoリストで、To-Doアイテムの右側にあるTodoを完了 ( check ) を選択します。
  • リソース(例えば、イシューまたはマージリクエスト)の右上隅で、Todoを完了 ( todo-done ) を選択します。

完了したTo-Doアイテムを再度追加する

誤ってTo-Doアイテムを完了としてマークした場合、完了タブから再度追加できます:

  1. 左側のサイドバーの上部にあるTo-Doリスト ( task-done ) を選択します。
  1. 上部にある完了を選択します。
  2. 再度追加するTo-Doアイテムを見つけます。
  3. このTo-Doアイテムの横にある元に戻す redo を選択します。

To-DoアイテムがTo DoリストのTo Doタブに表示されるようになりました。

To-Doアイテムをスヌーズする

To-Doアイテムをスヌーズして、メインのTo-Doリストから一時的に非表示にすることができます。これにより、より緊急性の高いタスクに集中し、後でスヌーズされた項目に戻ることができます。

To-Doアイテムをスヌーズするには:

  1. To-Doリストで、スヌーズするTo-Doアイテムの横にあるスヌーズ( clock )を選択します。
  2. To-Doアイテムを特定の日時にスヌーズする場合は、Until a specific time and dateオプションを選択します。それ以外の場合は、プリセットされたスヌーズ期間のいずれかを選択します:
    • 1時間
    • 今日の後半まで(4時間後)
    • 明日まで(明日の午前8時(現地時間))

スヌーズされたTo-Doアイテムは、メインのTo-Doリストから削除され、別のスヌーズタブに表示されます。

スヌーズ期間が終了すると、To-Doアイテムは自動的にメインのTo-Doリストに戻ります。いつ作成されたかを示すインジケーターが表示されます。

スヌーズされたTo-Doアイテム

スヌーズされたTo-Doアイテムを表示または管理するには:

  1. To-Doリストに移動します。
  2. リストの上部にあるスヌーズタブを選択します。

スヌーズタブから、以下を実行できます:

  • スヌーズされたTo-Doがメインリストに戻るようにスケジュールされている日時を表示します。
  • スヌーズを削除して、アイテムをすぐにメインのTo-Doリストに戻します。
  • スヌーズされたTo-Doを完了としてマークします。

To-Doアイテムの一括編集

To-Doアイテムを一括編集できます:

  • To Doタブ: To-Doアイテムを完了としてマークするか、スヌーズします。
  • スヌーズタブ: To-Doアイテムを完了としてマークするか、削除します。
  • 完了タブ: To-Doアイテムを復元する。

To-Doアイテムを一括編集するには:

  1. To-Doリスト内:
    • 個々のアイテムを選択するには、編集する各アイテムの左側にあるチェックボックスをオンにします。
    • ページ上のすべてのアイテムを選択するには、左上隅にあるすべて選択チェックボックスをオンにします。
  2. 右上隅で、目的のアクションを選択します。

ユーザーのアクセス権が変更された場合にTo-Doリストがどのように影響を受けるか

セキュリティ上の理由から、ユーザーが関連リソースにアクセスできなくなった場合、GitLabはTo-Doアイテムを削除します。たとえば、ユーザーがイシュー、マージリクエスト、エピック、プロジェクト、またはグループにアクセスできなくなった場合、GitLabは関連するTo-Doアイテムを削除します。

このプロセスは、アクセス権の変更後1時間以内に発生します。ユーザーのアクセス権が誤って失効された場合に、データ損失を防ぐために、削除は遅延されます。