設定可能な作業アイテムタイプ
- プラン: Premium、Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
計画ワークフローに合わせて作業アイテムタイプをカスタマイズします。名前とアイコンを持つ新しいタイプを作成し、どのタイプをプロジェクトで利用可能にするかを制御します。A作業アイテムタイプ設定は、すべてのプロジェクトにカスケードされます。
新しいタイプはプロジェクトレベルでのみ利用可能です。それらのウィジェットと階層制限は、イシューのそれらと一致します。新しいタイプをカスタムフィールドとステータスライフサイクルに関連付けることができます。保存済みビューとイシューボードで作業アイテムタイプ別にフィルタリングすることもできます。
制限と命名規則
GitLabが提供するタイプを含め、トップレベルグループまたは組織には最大40の作業アイテムタイプを設定できます。タイプ名はネームスペースまたは組織内で一意であり、48文字以下である必要があります。タイプは、アーカイブ済みおよび無効なタイプを含め、別のタイプと名前を共有することはできません。脆弱性、マージリクエスト、コミット、パイプライン、アラート、レビュー、差分、レポート、SHAは使用できない予約名です。
タイプ名を変更すると（たとえば、FeatureをEnhancementに変更）、元の名前は新しいタイプに利用可能になります。その名前が使用されていない場合、タイプを元の名前に戻すことができます。
作業アイテムタイプの状態
各作業アイテムタイプには、次のいずれかの状態があります:
| State | 説明 |
|---|---|
| 有効 | デフォルトの状態です。このタイプは作業アイテムを作成するために利用可能であり、フィルターに表示されます。 |
| 無効 | このタイプは新しい作業アイテムを作成するために使用できず、フィルターに表示されません。無効なタイプの名前変更やアイコンの変更は引き続き可能です。そのタイプの既存の作業アイテムは影響を受けません。 |
| アーカイブ済み | このタイプは、すべてのリスト、フィルター、および作成フローから削除されます。アーカイブされたタイプは、トップレベルグループまたは組織レベルでのみ表示およびアーカイブ解除できます。アーカイブされたタイプの名前を変更したり、アイコンを変更したりすることはできません。 |
| ロック済み | このタイプは特定のGitLab機能に関連付けられており、名前の変更、無効化、またはアーカイブはできません。たとえば、チケット、インシデント、エピック、タスクタイプはロックされています。 |
エピックはプロジェクトレベルでは作業アイテムタイプとして表示されますが、エピックはグループレベルでのみ利用可能であるため、プロジェクトでは無効になっています。
作業アイテムタイプの作成
特定の作業カテゴリを表す名前とアイコンを持つ作業アイテムタイプを作成します。
前提条件:
- GitLab.comの場合: トップレベルグループのメンテナーロール以上が必要です。
- GitLab Self-Managed: インスタンス管理者または組織オーナーである必要があります。
作業アイテムタイプを作成するには:
- 作業アイテム設定に移動します:
- GitLab.comの場合: 上部のバーで検索または移動先を選択し、トップレベルグループを見つけます。左サイドバーで、設定 > 作業アイテムを選択します。
- GitLab Self-Managed: 右上隅で、管理者を選択します。左サイドバーで、設定 > 作業アイテムを選択します。
- 作業アイテムタイプセクションで、新しいタイプを選択します。
- タイプの名前を入力します。
- アイコンを選択します。
- 保存を選択します。
作業アイテムタイプを編集
既存の作業アイテムタイプの名前またはアイコンを更新します。
前提条件:
- GitLab.comの場合: トップレベルグループのメンテナーロール以上が必要です。
- GitLab Self-Managed: インスタンス管理者または組織オーナーである必要があります。
- タイプはロックまたはアーカイブされていない必要があります。
作業アイテムタイプを編集するには:
- 作業アイテム設定に移動します:
- GitLab.comの場合: 上部のバーで検索または移動先を選択し、トップレベルグループを見つけます。左サイドバーで、設定 > 作業アイテムを選択します。
- GitLab Self-Managed: 右上隅で、管理者を選択します。左サイドバーで、設定 > 作業アイテムを選択します。
- 作業アイテムタイプセクションで、編集するタイプを見つけます。
- 名前とアイコンの編集を選択します。
- 名前、アイコン、またはその両方を更新します。
- 保存を選択します。
特定のGitLab機能に関連付けられているタイプは編集できません。たとえば、チケット、インシデント、エピック、タスクタイプはロックされており、名前を変更したり、アイコンを変更したりすることはできません。
作業アイテムタイプをアーカイブ
作業アイテムタイプをアーカイブして、すべてのリスト、フィルター、および作成フローから削除します。アーカイブされたタイプはシステムに残され、そのタイプの既存の作業アイテムは影響を受けません。
前提条件:
- GitLab.comの場合: トップレベルグループのメンテナーロール以上が必要です。
- GitLab Self-Managed: インスタンス管理者または組織オーナーである必要があります。
作業アイテムタイプをアーカイブするには:
- 作業アイテム設定に移動します:
- GitLab.comの場合: 上部のバーで検索または移動先を選択し、トップレベルグループを見つけます。左サイドバーで、設定 > 作業アイテムを選択します。
- GitLab Self-Managed: 右上隅で、管理者を選択します。左サイドバーで、設定 > 作業アイテムを選択します。
- 作業アイテムタイプセクションで、アーカイブするタイプを見つけます。
- アーカイブを選択します。
- 確認ダイアログで、アーカイブを選択します。
アーカイブされたタイプは、トップレベルグループまたは組織レベルのアーカイブ済みタブでのみ表示されます。サブグループまたはプロジェクトレベルでは表示されません。
作業アイテムタイプのアーカイブ解除
アーカイブされた作業アイテムタイプを復元すると、再び利用可能になります。
前提条件:
- GitLab.comの場合: トップレベルグループのメンテナーロール以上が必要です。
- GitLab Self-Managed: インスタンス管理者または組織オーナーである必要があります。
- アクティブなタイプの総数は、最大40未満である必要があります。
作業アイテムタイプをアーカイブ解除するには:
- 作業アイテム設定に移動します:
- GitLab.comの場合: 上部のバーで検索または移動先を選択し、トップレベルグループを見つけます。左サイドバーで、設定 > 作業アイテムを選択します。
- GitLab Self-Managed: 右上隅で、管理者を選択します。左サイドバーで、設定 > 作業アイテムを選択します。
- 作業アイテムタイプセクションで、アーカイブ済みタブを選択します。
- 復元するタイプを見つけます。
- アーカイブ解除を選択します。
- 確認ダイアログで、アーカイブ解除を選択します。
タイプの利用可能性の制御
プロジェクトで利用可能な作業アイテムタイプを制御します。タイプの利用可能性には3つのレイヤーがあります:
- プロジェクトでタイプのカスタマイズ: プロジェクトがタイプの利用可能性をカスタマイズできるようにするか、阻止するかを決定するトップレベルグループまたは組織のスイッチです。デフォルトでは無効になっています。
- Per-type availability for all projects: すべての子孫プロジェクトで特定のタイプを有効または無効にします。
- Per-project availability: 個々のプロジェクトは、独自のスコープでタイプを有効または無効にできます。
プロジェクトでのタイプのカスタマイズを許可する
プロジェクトが利用可能なタイプをカスタマイズする機能を制御します。
前提条件:
- GitLab.comの場合: トップレベルグループのメンテナーロール以上が必要です。
- GitLab Self-Managed: インスタンス管理者または組織オーナーである必要があります。
タイプのカスタマイズを切替するには:
- 作業アイテム設定に移動します:
- GitLab.comの場合: 上部のバーで検索または移動先を選択し、トップレベルグループを見つけます。左サイドバーで、設定 > 作業アイテムを選択します。
- GitLab Self-Managed: 右上隅で、管理者を選択します。左サイドバーで、設定 > 作業アイテムを選択します。
- プロジェクトでタイプのカスタマイズセクションで、有効または無効を選択します。
タイプのカスタマイズを無効にすると、以前の表示レベルの設定に関係なく、すべてのプロジェクトですべてのタイプが有効として扱われます。プロジェクトごとのオーバーライドは保持されますが、無視されます。タイプのカスタマイズを再有効化すると、以前の設定が復元されます。
全てのプロジェクトでタイプを有効または無効にする
すべての子孫プロジェクトで一度に特定のタイプの利用可能性を制御します。これにより、そのタイプのプロジェクトごとのオーバーライドがすべて削除されます。
前提条件:
- GitLab.comの場合: トップレベルグループのメンテナーロール以上が必要です。
- GitLab Self-Managed: インスタンス管理者または組織オーナーである必要があります。
すべてのプロジェクトでタイプを有効または無効にするには:
- 作業アイテム設定に移動します:
- GitLab.comの場合: 上部のバーで検索または移動先を選択し、トップレベルグループを見つけます。左サイドバーで、設定 > 作業アイテムを選択します。
- GitLab Self-Managed: 右上隅で、管理者を選択します。左サイドバーで、設定 > 作業アイテムを選択します。
- 作業アイテムタイプセクションで、タイプを見つけます。
- タイプアクションメニューから、全てのプロジェクトで有効または全てのプロジェクトで無効を選択します。
プロジェクトでタイプを有効または無効にする
特定のプロジェクトで利用可能なタイプを制御します。
前提条件:
- プロジェクトのメンテナーロール以上が必要です。
プロジェクトでタイプを有効または無効にするには:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左サイドバーで、設定 > 作業アイテムを選択します。
- 有効な作業アイテムタイプセクションで、タイプを見つけます。
- タイプをオンまたはオフに切替えます。
プロジェクトでタイプを無効にすると、そのプロジェクトで新しい作業アイテムを作成するためにタイプを使用できなくなります。そのタイプの既存の作業アイテムは影響を受けません。