カスタム フィールドの追加

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

カスタム フィールドを作成して、既定のシステム フィールドでは提供されない情報を収集できます。開始する前に、カスタム フィールドの作成に関するヒントを読んで、フィールドの数が多すぎるために Jira インスタンスが混乱してしまわないようにしてください

カスタム フィールドは、常にオプションのフィールドです。つまり、既存の課題を変更せずに新しいカスタム フィールドを作成できます。既存の課題では、既定の値がそれに定義されていても、新しいカスタム フィールドに値は入りません。

カスタム フィールドを変更したら、Jira のインデックスを再作成する必要があります。

次のすべての手順を行うには、Jira 管理者 グローバル権限 を持つユーザーとしてログインする必要があります。

カスタム フィールド作成のヒント

カスタム フィールドの作成と管理に関するヒントをいくつか紹介します。

カスタム フィールドの数を制限する

Jira 内で定義するカスタム フィールドの数に注意してください。1,000 個以上の場合は多すぎるため、Jira のパフォーマンスに影響を及ぼす可能性があります。問題の詳細については、以下で確認してください。

フィールド コンテンツを組み合わせる

何らかの情報をフィールドに忘れずに入力してもらいたい場合は、既定値としてテキスト テンプレートを使用した複数行のカスタム テキスト フィールドの使用を検討してください。Atlassian Marketplace には、そのような機能を提供するアプリがあります。

フィールド名の重複を避ける

新しいカスタム フィールドに、既存のカスタム フィールドと同じ名前を付けないでください。カスタム フィールドを作成する前に、同じ名前のカスタム フィールドが既に存在していないか、必ず確認してください。 

同じ名前のカスタム フィールドを作成すると、ユーザーが JQL 検索で正しいフィールドを選択しにくくなります。 

また、既定の Jira フィールドと同じ名前のカスタム フィールドを作成しないでください。たとえば、「Status」フィールドが 2 つあると (既定フィールドとカスタム フィールド)、検索や課題管理に支障をきたします。 

可能な限り汎用的な名前を使用する

後で別の場所で再利用できるように、カスタム フィールドには具体的ではない名前を付けてください。たとえば、フィールドの名前を「マーケティング目的」にするのではなく、「目的」にして、フィールドが使用される Jira プロジェクトが一覧表示されるフィールド設定に説明を入力します。

On this page:

カスタムフィールドタイプ

新しいカスタム フィールドを作成するときは、まずそのフィールドのタイプを設定する必要があります。タイプでは、カスタム フィールドの表示方法、機能、使用できる値を選択します。

次の表は、課題に含める必要がある情報とその方法に関するさまざまなユース ケースに対応できるように Jira に用意されている各種カスタム フィールド タイプを示しています。

既定では、新しいカスタム フィールドを追加するときに、標準フィールド タイプから選択するように求められます。カスタム フィールド タイプの全リストを開くには、ダイアログ ウィンドウで [すべて] を選択します。

カスタム フィールド タイプ説明

JIRA CORE のカスタム フィールド タイプ

チェックボックス (標準)

リストから複数の値を選択できます。

チェックボックスは、オプションを作成する必要があるカスタム フィールド タイプの 1 つです。詳細を見る

日付ピッカー (標準)

日付を選択できます

日時ピッカー (標準)

日付と時刻を選択できます

ラベル (標準)

課題の分類と検索を容易にするため、課題にラベルを追加できます

数値フィールド (標準)

浮動小数点数を格納して検証します

ラジオ ボタン (標準)

リストから 1 つの値を選択できます。

ラジオ ボタンは、オプションを作成する必要があるカスタム フィールド タイプの 1 つです。詳細を見る

選択リスト (カスケード) (標準)

親子関係に基づいて値を選択できます。

選択リスト (カスケード) は、オプションを作成する必要があるカスタム フィールド タイプの 1 つです。詳細を見る

選択リスト (複数選択) (標準)

リストから複数の値を選択できます。

選択リスト (複数選択) は、オプションを作成する必要があるカスタム フィールド タイプの 1 つです。詳細を見る

選択リスト (単一選択) (標準)

リストから 1 つの値を選択できます

テキスト フィールド (複数行) (標準)

ユーザーが何行もの長いテキストを入力できる無制限のテキスト領域を作成します

テキスト フィールド (単一行) (標準)

ユーザーがスペースを含めて 255 文字以内で 1 行のテキストを入力できるテキスト ボックスを作成します

URL フィールド (標準)

1 つの URL を入力できます

ユーザー ピッカー (単一ユーザー) (標準)

1 人のユーザーを選択できます

グループ ピッカー (複数グループ) (詳細)

複数のユーザー グループを選択できます

グループ ピッカー (単一グループ) (詳細

1 つのユーザー グループを選択できます

プロジェクト ピッカー (単一プロジェクト) (詳細)

ユーザーが Jira で表示できる 1 つのプロジェクトを選択できます

テキスト フィールド (読み取り専用) (詳細)

プログラムで値を設定するための読み取り専用のテキスト ラベルを作成します。値には、スペースを含めて 255 文字までしか含められません。

ユーザー ピッカー (複数ユーザー) (詳細)

複数のユーザーを選択できます

バージョン ピッカー (複数バージョン) (詳細)

複数のバージョンを選択できます

バージョン ピッカー (単一バージョン) (詳細)

1 つのバージョンを選択できます

JIRA SOFTWARE 専用のカスタム フィールド タイプ

グローバル ランク (詳細)

Jira Software では、このタイプのランク カスタム フィールドが自動的に作成されます。ランク フィールドでは、課題の重要性や緊急性を評価して優先順位を付けたり、課題をスプリント間で移動したり、特定の親課題の下にサブタスクをグループ化したりできます。ランキングの詳細を見る

非表示ジョブ スイッチ (詳細)

プログラムで非表示スイッチを設定して、Perforce ジョブを作成するかどうかを選択します。

Jira リリース済みバージョン履歴 (詳細)

カスタム リリース バージョンを設定できます

ジョブ チェックボックス (詳細)

Perforce ジョブを作成するかどうかを選択するチェックボックスを作成します。

元のストーリー ポイント (詳細)

課題の作業が開始される前にその課題に割り当てられた元のストーリー ポイント数を格納します

新しいカスタム フィールドの作成

カスタム フィールドを作成するには、次のようにします。

  1. 画面右上で [管理] > [課題] の順に選択します。

  2. [フィールド] (左側のパネル) で、[カスタム フィールド] を選択します。

  3. [カスタム フィールドを追加] を選択します。

  4. [フィールド タイプの選択] モーダル ダイアログで [すべて] を選択し、使用可能なすべてのフィールド タイプを表示できるようにします。

  5. フィールド タイプを選択し、[次へ] を選択します。たとえば、[チェックボックス] フィールド タイプを選択します。

  6. フィールドの名前、説明、および必要に応じてオプションを入力し、フィールドを構成します。[次へ] を選択します。

    課題の情報を入力および取得するときに、カスタム フィールドのタイトルとして [名前] が表示されます。新しい課題を入力するときや既存の課題を編集するときに、このフィールドの下に [説明] が表示されますが、問題を参照するときには表示されません。

  7. フィールドのコンテキストを設定します。

    コンテキストとは

    カスタム フィールドのコンテキストは、同じフィールドの異なる設定です。複数のコンテキストを構成すると、異なるプロジェクトに対して異なる既定値やオプションを使用したり、特定の課題タイプまたはプロジェクトにのみフィールドを適用したりすることができます。一般に、パフォーマンスの観点から、カスタム フィールドを実際に使用するプロジェクトのみにカスタム フィールドの適用を制限することをお勧めします。コンテキストは後で構成できます。

    構成方法については、カスタム フィールド コンテキストの設定を参照してください。

  8. カスタム フィールドを適用する必要があるプロジェクトを選択します。

  9. [作成] を選択します。

これで、新しいカスタム フィールドを課題画面に関連付け、課題にフィールドを追加できるようになりました。詳細情報

カスタム フィールドの課題画面への関連付け

カスタム フィールドを作成すると、[画面] ページが表示されます画面の詳細

ここで、カスタム フィールドが表示される課題画面を選択できます。たとえば、[既定の画面] や [課題解決画面] などに表示できます。

フィールドを画面に関連付けるには、目的の画面の横にあるチェックボックスをオンにして、[更新] を選択します。 

カスタム フィールドは、これを有効にしたすべての課題画面で使用できるようになります。ここでどの画面も選択しなければ、課題の作成または編集するときにカスタム フィールドは表示されません。

既存の関連付けの編集

カスタム フィールドと選択した画面の関連付けはいつでも編集できます。この操作を行うには、次の手順に従います。

  1. 画面右上で [管理] > [課題] の順に選択します。

  2. [フィールド] (左側のパネル) で、[フィールド設定] を選択します。

  3. フィールド設定を選択します。

  4. リスト内からカスタム フィールドを見つけて、[画面] を選択します。

  5. 関連付けを変更し、[更新] を選択します。

画面との関連性に関係なく、カスタム フィールドを既存の課題に追加することもできます。

カスタム フィールドを課題に直接追加する

カスタム フィールドが課題画面に関連付けられていなくても、特定のタイプの既存の課題にこのフィールドを追加できます。これを行う前に、目的の課題タイプのフィールドが有効になっていることを確認してください。 

課題にフィールドを追加する手順は、次のとおりです。

  1. 課題を開きます。

  2. [管理] > [フィールドを追加] の順に選択します。ドロップダウンで、課題ビューに表示するフィールドを選択します。

  3. フィールドの値を即時に設定するには、[フィールドを編集] を選択します。
  4. [送信] を選択します。

次のすべての手順を行うには、Jira 管理者 グローバル権限 を持つユーザーとしてログインする必要があります。

カスタム フィールドは、[詳細] ブロックまたは [課題編集画面] のいずれかに表示されます。フィールドを編集できない場合、変更方法を確認してください

対応する課題画面との関連付けは、自動的に生成されます。

フィールドは、有効にしたすべてのタイプの全課題で使用できるようになります。たとえば、バグに対してのみ、フィールドが有効になっているとします。この場合、そのフィールドを 1 つのバグに追加するとすぐに、フィールドに設定したコンテキストに応じて、特定のプロジェクトまたはインスタンス全体のすべてのバグにフィールドが表示されるようになります。 

ボードまたはバックログ ビューでフィールドを有効にする

Jira 管理メニューからフィールドを追加できます。詳細については、画面のタブとフィールドを設定するを参照してください。

あるいは、課題から直接行うこともできます。たとえば、前のセクションで追加した [課題ラベル] カスタム フィールドを有効にしてみましょう。

  1. ボードまたはバックログ ビューに移動して、既存の課題を編集します。

  2. 右上隅にある [フィールドを設定> [フィールドがありませんを選択し、フィールド ヘルパーを開きます。

  3. カスタム フィールドの名前を入力します。この場合は、「Issue label」と入力します。

  4. フィールドのステータスや、フィールドが表示されない理由の詳細、およびフィールドの設定を更新する方法が表示されます。

  5. "課題ラベルの設定" ページから、プロジェクトと課題タイプ スコープのフィールド設定を更新します。 詳細は「カスタム フィールド コンテキストの設定」をご確認ください。

  6. "OP: スクラム バグ画面の画面設定" ページから、フィールド画面の設定を更新します。詳細は「課題ビューの設定」の「追加したフィールドを課題ビューで編集可能にするセクションをご参照ください。

カスタム フィールドが追加される課題タイプを変更する

カスタム フィールドを追加した課題タイプはいつでも変更できます。たとえば、フィールドはバグにのみ追加できますが、すべてのタイプの課題にそれを追加したいとします。

課題タイプを変更するには、以下のようにします。

  1. 画面右上で [管理] > [課題] の順に選択します。

  2. [フィールド] (左側のパネル) で、[カスタム フィールド] を選択します。

  3. リスト内からフィールドを見つけて、[アクション] で [設定] を選択します。

  4. 設定を含むページで、[設定の編集] を選択します。

  5. [適用する課題タイプの選択] に移動し、[任意の課題タイプ] を選択します。

カスタム フィールドの編集方法に関する詳細を確認する

フィールドは、すべてのタイプの課題に追加できます。対応する課題画面との関連付けは、自動的に生成されます。

次のステップ

フィールドのコンテキストを変更する場合は、「カスタム フィールドの設定」を参照してください。 

また、Atlassian Marketplace にあるアプリ (例: Jira Toolkit) から、さらにカスタム フィールドを見つけることもできます。

独自のカスタム フィールド タイプを構築するには、Jira 開発者向けドキュメントチュートリアルを参照してください。

tip/resting Created with Sketch.

Jira でカスタム フィールドを使用する機会をさらに見つけるには、Atlassian Marketplace から以下のいずれかのアプリを試してみてください。  

Jira のインデックスを再作成する

カスタム フィールドへの変更は Jira 検索インデックスに影響します。設定を変更すると、管理ビューに次のメッセージが表示されます。

We recommend that you perform a re-index, as configuration changes were made to 'SECTION' by USER at TIME. If you have other changes to make, complete them first so that you don't perform multiple re-indexes

このメッセージは、Jira に対する設定変更は実施されたが検索インデックスにはその変更が反映されていないことを意味します。Jira の検索インデックスが再構築されるまで、Jira からの検索クエリは正しくない結果を返す場合があります。 

不一致を避けるには、Jira 検索インデックスを再構築する必要があります。

カスタム フィールドでどのアクションを実行した後に Jira のインデックスを再作成する必要があるかについては、「インスタンスを設定した後に Jira でインデックスを再作成する」でヒントをご確認ください。

Jira のインデックス再作成が必要な場合について、その他の主要な設定変更に関する詳細をご確認ください。

最終更新日 2023 年 4 月 24 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.