カスタムフィールド
- プラン: Premium、Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed
カスタムフィールドは、特定の計画ニーズに合致する、イシューやエピックなどの作業アイテムに専門的な情報を追加します。グループのカスタムフィールドを設定して、ビジネス価値、リスク評価、優先順位付け、またはチーム属性などのデータポイントを追跡します。これらのフィールドは、グループ、そのサブグループ、およびプロジェクトのすべての作業アイテムに表示されます。
カスタムフィールドは、チームがワークフロー全体で情報を記録およびレポートする方法を標準化するのに役立ちます。この標準化により、プロジェクト間での一貫性が生まれ、より強力なフィルタリングおよびレポート機能がサポートされます。さまざまなデータ要件と計画シナリオに対応するために、様々なフィールドタイプから選択します:
- シングルセレクト
- マルチセレクト
- 数値
- テキスト
グループのカスタムフィールドを設定する
トップレベルグループのカスタムフィールドを設定して、そのグループ、そのサブグループ、およびプロジェクトの作業アイテムで利用できるようにします。
カスタムフィールドを作成する
チームが追跡する必要がある特定の情報を取得するために、カスタムフィールドを作成します。組織の要件に合わせてワークフローを調整することで、1つ以上の作業アイテムタイプに対して各フィールドを設定できます。
以下の制限事項に留意してください:
- トップレベルグループには、最大で50個のアクティブなカスタムフィールドを設定できます。
- 作業アイテムタイプには、最大10個のカスタムフィールドを割り当てできます。
前提条件:
- グループのメンテナーロールまたはオーナーロールを持っている必要があります。
カスタムフィールドを作成するには:
- 上部のバーで、検索または移動先を選択して、グループを見つけます。このグループはトップレベルにある必要があります。
- 設定 > 作業アイテムを選択します。
- フィールドを作成するを選択します。
- フィールドに入力します:
タイプで、フィールドのタイプを選択します:
- シングルセレクト
- マルチセレクト
- 数値
- テキストフィールド
フィールドを作成した後、フィールドタイプは変更できません。
以下の項目で使用で、このフィールドを適用する作業アイテムタイプを選択します。
オプションで、選択可能なオプションを入力します。シングルセレクトまたはマルチセレクトフィールドには、最大50個の選択オプションを設定できます。
- 各オプションの左側にあるグリップアイコン ( ) をドラッグして、オプションを並べ替えます。
- 複数のオプションを一度に追加するには、入力を選択して、1行に1つのアイテムを貼り付けます。
- Saveを選択します。
カスタムフィールドを編集する
組織のニーズの変化を反映するために、既存のカスタムフィールドを編集します。フィールド名、適用される作業アイテムタイプ、および利用可能なオプションを、既存のデータを失うことなく変更できます。
前提条件:
- グループのメンテナーロールまたはオーナーロールを持っている必要があります。
カスタムフィールドを編集するには:
- 上部のバーで、検索または移動先を選択して、グループを見つけます。このグループはトップレベルにある必要があります。
- 設定 > 作業アイテムを選択します。
- 編集したいフィールドの隣にある編集
<field name>( ) を選択します。 - いずれかのフィールドを変更します。
- Updateを選択します。
カスタムフィールドをアーカイブする
不要になったカスタムフィールドを、その履歴データを保持したままアーカイブします。アーカイブすると、フィールドが設定されていたすべての作業アイテムからそのフィールドが削除されます。
前提条件:
- グループのメンテナーロールまたはオーナーロールを持っている必要があります。
カスタムフィールドをアーカイブするには:
- 上部のバーで、検索または移動先を選択して、グループを見つけます。このグループはトップレベルにある必要があります。
- 設定 > 作業アイテムを選択します。
- アーカイブしたいフィールドの隣にあるアーカイブ
<field name>( ) を選択します。
カスタムフィールドのアーカイブを解除する
以前にアーカイブされたカスタムフィールドを、再度使用する必要がある場合に復元します。このフィールドに値が設定されていた作業アイテムは、フィールドがアーカイブされる前の値を保持します。
前提条件:
- グループのメンテナーロールまたはオーナーロールを持っている必要があります。
カスタムフィールドのアーカイブを解除するには:
- 上部のバーで、検索または移動先を選択して、グループを見つけます。このグループはトップレベルにある必要があります。
- 設定 > 作業アイテムを選択します。
- アーカイブ済みタブを選択して、アーカイブされたフィールドを一覧表示します。
- アーカイブ解除したいフィールドの隣にあるアーカイブ解除
<field name>( ) を選択します。
作業アイテムのカスタムフィールド値を設定する
グループ用に設定されたカスタムフィールドを使用して、作業アイテムに関連情報を追加します。
前提条件:
- 作業アイテムのプロジェクトまたはグループに対して、プランナー、レポーター、デベロッパー、メンテナー、またはオーナーのロールを持っている必要があります。
- ゲストロールをお持ちの場合、カスタムフィールドは作業アイテムの作成時にのみ設定できます。
- 作業アイテムに移動します。
- 右サイドバーで、編集したいカスタムフィールドのセクションを見つけ、編集を選択します。
- 希望する値を入力または選択します。
- テキストフィールド値は最大1024文字です。
- フィールドの外側の任意の領域を選択します。
フィールドタイプ選択ガイド
カスタムフィールドを作成する際は、追跡したいデータの種類に合ったフィールドタイプを選択します。適切なフィールドタイプはデータ品質を向上させ、レポートをより効果的にします。
シングルセレクトフィールド
シングルセレクトフィールドは、次の場合に使用します:
- ユーザーが事前定義されたリストから正確に1つのオプションを選択する必要がある場合。
- オプションが相互に排他的な場合。
- 一貫性を強制し、自由形式の入力を防止したい場合。
シングルセレクトフィールドは、次の用途に適しています:
- 優先度指標(例:
High、Medium、Low) - カテゴリ割り当て
- チーム割り当て
- 承認ステータス
- 優先度レベル
マルチセレクトフィールド
マルチセレクトフィールドは、次の場合に使用します:
- 複数の値が同時に適用される可能性がある場合。
- オーバーラップする属性を追跡する必要がある場合。
- アイテムが複数のカテゴリに属する可能性がある場合。
マルチセレクトフィールドは、次の用途に適しています:
- タグまたはラベル
- 必要なスキル
- 影響を受けるコンポーネント
- ステークホルダーグループ
- 機能の能力
数値フィールド
数値フィールドは、次の場合に使用します:
- 定量的なデータを収集する必要がある場合。
- 計算または集計を実行したい場合。
- 情報が数値的に並べ替え可能である必要がある場合。
数値フィールドは、次の用途に適しています:
- コスト見積もり
- 時間見積もり
- ビジネス価値スコア
- ランキングまたは優先順位スコア
- 完了率
テキストフィールド
テキストフィールドは、次の場合に使用します:
- 事前定義されたカテゴリに合致しない固有の情報を取得する必要がある場合。
- データが非常に変動しやすい場合。
- コンテキストまたは詳細情報を提供する必要がある場合。
テキストフィールドは、次の用途に適しています:
- 追加のコンテキスト
- 外部参照ID
- 連絡先情報
- 短いメモまたはコメント
- URLまたはリンク
カスタムフィールドの命名規則
カスタムフィールドの一貫した命名規則は、それらを理解しやすく、使いやすくします。適切なフィールド名は、採用とデータ品質を向上させます。
一般的なガイドライン
- 名前は簡潔で記述的にします。
- 組織が理解できる、明確で具体的な言語を使用します。
- 大文字小文字の表記(タイトルケースを推奨)を一貫させます。
- 広く理解されていない限り、略語の使用は避けてください。
- 該当する場合は、測定単位を含めます。
シングルセレクトおよびマルチセレクトフィールドの命名
カテゴリ名から始め、その後に記述子を続けます。例:
Riskの代わりにRisk LevelSegmentの代わりにCustomer SegmentPhaseの代わりにDevelopment PhaseStatusの代わりにApproval Status
数値フィールドの命名
フィールド名に測定単位を含めます。例:
Pointsの代わりにEffort PointsBudgetの代わりにBudget Estimate ($)Timeの代わりにImplementation Time (days)Valueの代わりにBusiness Value Score
テキストフィールドの命名
入力すべき情報を明確に示します。例:
Referenceの代わりにExternal Reference IDNotesの代わりにImplementation NotesSourceの代わりにRequirements Source
チーム固有のプレフィックス
複数のチームが同じGitLabインスタンスを使用する場合、混乱を避けるためにチームプレフィックスの追加を検討してください:
DEV: Sprint PriorityQA: Test EnvironmentUX: Design StatusPM: Market Segment
このアプローチは、チームが自分の作業に関連するフィールドを迅速に特定するのに役立ちます。