- タスクを見る
- タスクの作成
- 既存のタスクをイシューに追加
- タスクの編集
- タスクをイシューに昇格させる
- タスクをイシューから削除するには
- タスクの削除
- タスクの並べ替え
- タスクにユーザーを割り当てる
- タスクにラベルを割り当て
- 開始日と期限の設定
- マイルストーンへのタスクの追加
- タスクの重みを設定
- イテレーションへのタスクの追加
- タスクシステムノートを表示
- コメントとスレッド
- タスクリファレンスのコピー
- タスクのメールアドレスをコピー
- 機密タスク
- 2カラムレイアウト
タスク
- GitLab 14.5 で
work_itemsというフラグで導入されました。デフォルトでは無効になっています。- GitLab 15.0で導入されたタスクの作成、編集、削除。
- GitLab.comで有効になり、GitLab 15.3で自己管理。
既知の制限：
最新のアップデートについては、タスクロードマップをご覧ください。
フラグ: セルフマネジメント GitLab では、デフォルトでこの機能が利用可能です。この機能を隠すには、管理者がwork_itemsという機能フラグを無効にします。GitLab.comでは、この機能は利用可能です。
タスクを使用して、イシューをクローズするために必要なステップを追跡します。
イシューを計画する際には、技術的な要件や完了に必要なステップを把握し、分解する方法が必要です。関連するタスクを持つイシューはより明確に定義されるため、より正確な課題の重み付けと完了基準を提供できます。
タスクはワークアイテムの一種であり、GitLabのデフォルトのイシュータイプへのステップです。イシューとエピックをワークアイテムにマイグレーションし、カスタムワークアイテムタイプを追加するロードマップについては、エピック 6033またはPlan direction ページを参照してください。
タスクを見る
イシューのタスクセクションでタスクを表示します。
Type = taskのイシューリストをフィルタリングすることもできます。
イシューからタスクを選択すると、そのタスクがダイアログウィンドウで開きます。新しいブラウザ・タブで開くタスクを選択するか、イシュー・リストからタスクを選択すると、タスクは全ページ表示で開きます。
タスクの作成
前提条件：
- 少なくともプロジェクトのレポーターロールを持っているか、プロジェクトが公開されている必要があります。
タスクを作成するには
- イシューの説明の[タスク]セクションで、[追加]を選択します。
- 新規タスクを選択します。
- タスクのタイトルを入力します。
- タスクの作成を選択します。
タスクリスト項目から
GitLab 15.9 で導入されました。
前提条件：
- 少なくともプロジェクトのレポーターロールを持っている必要があります。
タスクリスト項目を含むイシューの説明で
- タスクリスト項目にカーソルを合わせ、オプションメニュー({ellipsis_v}) を選択します。
- タスクに変換］を選択します。
イシューの説明からタスク・リスト項目が削除され、その内容からタスク・ウィジェットにタスクが作成されます。ネストされたタスク・リスト項目は、ネストされたレベル上に移動します。
既存のタスクをイシューに追加
GitLab 15.6で導入されました。
前提条件：
- 少なくともプロジェクトのゲストロールを持っているか、プロジェクトが公開されている必要があります。
タスクを追加するには
- イシューの説明の[タスク]セクションで、[追加]を選択します。
- 既存のタスク]を選択します。
- タイトルでタスクを検索します。
- イシューに追加するタスクを1つまたは複数選択します。
- タスクを追加]を選択します。
タスクの編集
前提条件：
- 少なくともプロジェクトのレポーターロールを持っている必要があります。
タスクを編集するには
- イシューの説明の[タスク]セクションで、編集したいタスクを選択します。タスク・ウィンドウが開きます。
- オプションタイトルを編集するには、タイトルを選択して変更します。
- オプション。説明を編集するには、編集アイコン（{鉛筆}）を選択して変更を加え、「保存」を選択します。
- 閉じるアイコン({close}) を選択します。
リッチテキストエディタの使用
フラグ: セルフマネジメントのGitLabでは、デフォルトではリッチテキスト機能は利用できません。グループごとに利用できるようにするには、管理者にwork_items_mvcという機能フラグを有効にしてもらうよう依頼してください。GitLab.comでは、この機能は利用できません。この機能はまだ本番環境では使用できません。
タスクの説明を編集するには、リッチテキストエディタを使います。
前提条件：
- 少なくともプロジェクトのレポーターロールを持っている必要があります。
タスクの説明を編集するには
- タスクセクションで、編集したいタスクのタイトルを選択します。タスクウィンドウが開きます。
- 説明] の横にある編集アイコン({鉛筆}) を選択します。説明テキストボックスが表示されます。
- テキストボックスの上で、[リッチテキスト] を選択します。
- 変更を加え、保存を選択します。
タスクをイシューに昇格させる
GitLab 16.1 で導入されました。
前提条件：
- 少なくともプロジェクトのレポーターロールを持っている必要があります。
タスクをイシューに昇格させるには、/promote_to issue クイックアクションを使用します。
タスクをイシューから削除するには
前提条件：
- 少なくともプロジェクトのレポーターロールを持っている必要があります。
イシューからタスクを削除できます。タスクは削除されませんが、2つのタスクは接続されなくなります。再び関連付けることはできません。
イシューからタスクを削除するには
- イシューの説明のタスクセクションで、削除したいタスクの横にあるオプションメニュー（{ellipsis_v}）を選択します。
- タスクの削除］を選択します。
タスクの削除
前提条件：
- 以下のいずれかである必要があります：
- タスクの作成者であり、少なくともプロジェクトのゲストロールを持っていること。
- プロジェクトのオーナーロールを持っていること。
タスクを削除するには
- イシューの説明の[タスク]セクションで、編集したいタスクを選択します。
- タスクウィンドウのオプションメニュー（{ellipsis_v}）で、タスクの削除を選択します。
- OK］を選択します。
タスクの並べ替え
GitLab 16.0 で導入されました。
前提条件：
- 少なくともプロジェクトのレポーターロールを持っている必要があります。
デフォルトでは、タスクは作成日順に並んでいます。順番を変更するには、ドラッグしてください。
タスクにユーザーを割り当てる
GitLab 15.4で導入されました。
タスクの責任者を示すために、ユーザーを割り当てることができます。
GitLab Freeのユーザーは1つのタスクに1人のユーザーを割り当てることができます。GitLab PremiumとUltimateのユーザーは、一つのタスクに複数のユーザーを割り当てることができます。イシューの複数の担当者もご覧ください。
前提条件：
- 少なくともプロジェクトのレポーターロールを持っている必要があります。
タスクの担当者を変更するには：
- イシューの説明の[タスク]セクションで、編集したいタスクのタイトルを選択します。タスク・ウィンドウが開きます。
- 担当者]の横にある[担当者の追加]を選択します。
- ドロップダウンリストから、担当者として追加するユーザーを選択します。
- ドロップダウン・リスト以外の領域を選択します。
タスクにラベルを割り当て
GitLab 15.5 で導入されました。
前提条件：
- 少なくともプロジェクトのレポーターロールを持っている必要があります。
タスクにラベルを追加するには
- イシューの説明の[タスク]セクションで、編集したいタスクのタイトルを選択します。タスク・ウィンドウが開きます。
- ラベル] の横にある [ラベルの追加] を選択します。
- ドロップダウンリストから、追加するラベルを選択します。
- ドロップダウン・リスト以外の領域を選択します。
開始日と期限の設定
- GitLab 15.4 で
work_items_mvc_2というフラグで導入されました。デフォルトでは無効になっています。- GitLab15.5でGitLab.comで有効になり、自己管理。
タスクに開始日と期限を設定できます。
前提条件：
- 少なくともプロジェクトのレポーターロールを持っている必要があります。
タスクに開始日と期限日を設定することで、いつ作業を開始し、いつ終了すべきかを示すことができます。
期限を設定するには
- イシューの説明の[タスク]セクションで、編集したいタスクのタイトルを選択します。タスク・ウィンドウが開きます。
- タスクにすでに期限がある場合は、[期限]の横にある期限を選択します。そうでない場合は、[期限を追加] を選択します。
- 日付ピッカーで、希望する期日を選択します。
開始日を設定するには
- イシューの説明の[タスク]セクションで、編集したいタスクのタイトルを選択します。タスク・ウィンドウが開きます。
- タスクにすでに開始日がある場合は、[開始日] の横にある開始日を選択します。そうでない場合は、[開始日を追加] を選択します。
-
日付ピッカーで、希望する期日を選択します。
期日は開始日と同じかそれ以降でなければなりません。開始日を期限日より後に選択した場合、期限日は同じ日に変更されます。
マイルストーンへのタスクの追加
- GitLab 15.5 で
work_items_mvc_2というフラグで導入されました。デフォルトでは無効。- GitLab 15.7で
work_items_mvcという機能フラグに移動。デフォルトで無効。- GitLab.comでは有効、GitLab 15.7では自己管理。
マイルストーンにタスクを追加できます。タスクを表示するとマイルストーンのタイトルが表示されます。既にマイルストーンに属しているイシューに対してタスクを作成した場合、新しいタスクはマイルストーンを継承します。
前提条件：
- 少なくともプロジェクトのレポーターロールを持っている必要があります。
マイルストーンにタスクを追加するには：
- イシューの説明の[タスク]セクションで、編集したいタスクのタイトルを選択します。タスク・ウィンドウが開きます。
- マイルストーン]の横にある[マイルストーンに追加]を選択します。タスクがすでにマイルストーンに属している場合、ドロップダウンリストには現在のマイルストーンが表示されます。
- ドロップダウンリストから、タスクに関連付けるマイルストーンを選択します。
タスクの重みを設定
GitLab 15.3 で導入されました。
前提条件：
- 少なくともプロジェクトのレポーターロールを持っている必要があります。
各タスクにウェイトを設定し、必要な作業量を表示することができます。この値はタスクを表示するときのみ表示されます。
タスクのイシューを設定するには
- イシューの説明の[タスク]セクションで、編集したいタスクのタイトルを選択します。タスク・ウィンドウが開きます。
- 重量]の横に正の整数を入力します。
- 閉じるアイコン({close}) を選択します。
イテレーションへのタスクの追加
- GitLab 15.5 で
work_items_mvc_2というフラグで導入されました。デフォルトでは無効です。- GitLab 15.7で
work_items_mvcという機能フラグに移動。デフォルトで無効。- GitLab.comでは有効、GitLab 15.7では自己管理。
フラグ: セルフマネジメントのGitLabでは、デフォルトでこの機能が利用可能です。この機能を隠すには、管理者がwork_items_mvc という機能フラグを無効にします。GitLab.comでは、この機能は利用可能です。
イテレーションにタスクを追加できます。イテレーションのタイトルと期間は、タスクを表示するときだけ見ることができます。
前提条件：
- 少なくともプロジェクトのレポーターロールを持っている必要があります。
イテレーションにタスクを追加するには
- イシューの説明の[タスク]セクションで、編集したいタスクのタイトルを選択します。タスク・ウィンドウが開きます。
- 反復]の横にある[反復に追加]を選択します。
- ドロップダウンリストから、タスクに関連付けるイテレーションを選択します。
タスクシステムノートを表示
タスクに関連する全てのシステムノートを見ることができます。デフォルトでは古い順にソートされています。いつでもソート順を新しい順に変更することができます。セッションをまたいで記憶されるデフォルトの「すべてのアクティビティ」に加えて、「コメントのみ」と「履歴のみ」でアクティビティをフィルタリングすることもできます。
コメントとスレッド
タスクにコメントを追加したり、スレッドに返信することができます。
タスクリファレンスのコピー
GitLab 16.1 で導入されました。
GitLabの他の場所でタスクを参照するには、完全なURLか、namespace/project-name#123のような短い参照を使います。namespace はグループかユーザー名です。
タスクの参照をクリップボードにコピーするには
- 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
- プラン > イシューを選択し、タスクを選択して表示します。
- 右上隅で垂直の省略記号({ellipsis_v}) を選択し、[参照のコピー] を選択します。
これでリファレンスを別の説明やコメントに貼り付けることができます。
タスクの参照についての詳細はGitLab-Flavored Markdown を参照してください。
タスクのメールアドレスをコピー
GitLab 16.1 で導入されました。
メールを送ることで、タスクにコメントを作成することができます。このアドレスにメールを送ると、メール本文を含むコメントが作成されます。
メール送信によるコメントの作成および必要な設定の詳細については、メール送信によるコメントの返信を参照してください。
タスクのメールアドレスをコピーするには
- 左のサイドバーで「検索」または「移動」を選択してあなたのプロジェクトを検索します。
- プラン > イシューを選択し、課題を選択して表示します。
- 右上隅で垂直の省略記号（{ellipsis_v}）を選択し、「タスクのメールアドレスをコピー」を選択します。
機密タスク
GitLab 15.3 で導入されました。
機密タスクは、プロジェクトのメンバーで十分な権限を持つ人だけが見ることができるタスクです。機密タスクを使うことで、セキュリティの脆弱性を非公開にしたり、驚きが外部に漏れるのを防ぐことができます。
機密タスクの作成
デフォルトでは、タスクは公開されています。タスクを作成または編集するときに、機密扱いにすることができます。
前提条件：
- 少なくともプロジェクトのレポーターロールを持っている必要があります。
- タスクに機密ではない親イシューがあり、そのイシューを機密扱いにしたい場合、まずすべての子タスクを機密扱いにする必要があります。機密のイシューは機密の子だけを持つことができます。
新しいタスクで
新しいタスクを作成するとき、テキストエリアのすぐ下にあるチェックボックスはタスクを機密扱いにするために利用できます。
そのチェックボックスにチェックを入れて、タスクを作成するを選択してください。
既存のタスク
既存のタスクの機密性を変更するには
- タスクを開きます。
- 右上隅で、垂直省略記号({ellipsis_v}) を選択します。
- 機密保持を有効にする」を選択します。
機密タスクの閲覧者
タスクが機密扱いになった場合、少なくともプロジェクトのレポーターロールを持つユーザーのみがタスクにアクセスできます。ゲストまたは最小ロールを持つユーザーは、変更前にアクティブに参加していたとしても、タスクにアクセスできません。
ただし、ゲストロールを持つユーザーは機密タスクを作成できますが、自分で作成したものしか閲覧できません。
ゲストロールまたは非会員のユーザーは、タスクに割り当てられている場合、機密タスクを読むことができます。ゲストユーザーまたは非メンバーが機密タスクから割り当てを解除されると、そのタスクは閲覧できなくなります。
機密タスクは、必要な権限を持たないユーザーの検索結果では非表示になります。
機密タスクのインジケータ
機密扱いのタスクは通常のタスクとは視覚的に異なる点がいくつかあります。タスクがリストされている場合、機密とマークされたタスクの横に機密({eye-slash}) アイコンが表示されます。
十分な権限がない場合、機密タスクを見ることはできません。
同様に、タスクの中にいても、パンくずのすぐ隣に機密({eye-slash}) アイコンが表示されます。
通常タスクから機密タスクへの変更、またはその逆は、タスクのコメントにシステムノートで表示されます：
- {例えば｝ジョー・ガルシアは5分前にイシューを機密扱いにしました。
- 目Jo Garciaさんが問題を非公開にしました。
2カラムレイアウト
GitLab 16.2 で
work_items_mvc_2というフラグで導入されました。デフォルトでは無効になっています。
フラグ: セルフマネジメントのGitLabでは、デフォルトではこの機能は利用できません。利用可能にするには、管理者がwork_items_mvc_2という機能フラグを有効にします。GitLab.comでは、この機能は利用できません。この機能はまだ本番環境では使用できません。
有効にすると、タスクはイシューと同じような二列のレイアウトになります。左側に説明とスレッド、右側にラベルや担当者などの属性が表示されます。
