カスタム フィールドの追加
カスタムフィールドタイプ
When creating a new custom field, you should first set a type of this field. The type indicates how your custom field will display and function, as well as what values it can accept.
The following table lists a wide array of custom field types that Jira provides to cover various use cases of what information must be present in issues and how.
By default, you’re offered to select from standard field types when adding a new custom field. To open the full list of the custom field types, select All in the dialog window.
| Custom field type | 説明 |
|---|---|
JIRA CORE custom field types | |
Checkboxes STANDARD | Allows selecting multiple values from the list. Checkboxes is one of the custom field types for which you should create options. Tell me how |
Date picker STANDARD | Allows selecting a date |
Date time picker STANDARD | Allows selecting a date and time |
Labels STANDARD | Allows adding labels to issues to facilitate issue categorization and search |
Number field STANDARD | Stores and validates a floating point number |
Radio buttons STANDARD | Allows selecting on value from the list. Radio buttons is one of the custom field types for which you should create options. Tell me how |
Select list (cascading) STANDARD | Allows selecting values based on their parent-child relation. Select list (cascading) is one of the custom field types for which you should create options. Tell me how |
Select list (multiple choices) STANDARD | Allows selecting multiple values from the list. Select list (multiple choices) is one of the custom field types for which you should create options. Tell me how |
Select list (single choice) STANDARD | Allows selecting one value from the list |
Text field (multi-line) STANDARD | Creates an unlimited text area where a user can enter a long text with many lines |
Text field (single line) STANDARD | Creates a text box where a user can enter a one-line text, no longer than 255 characters including spaces |
URL field STANDARD | Allows entering one URL |
User picker (single user) STANDARD | Allows selecting one user |
Group picker (multiple groups) ADVANCED | Allows selecting multiple user groups |
Group picker (single group) ADVANCED | Allows selecting one user group |
Project picker (single project) ADVANCED | Allows selecting one project that the user can view in Jira |
Text field (read only) ADVANCED | Creates a read-only text label for setting values programmatically. A value can contain no more than 255 characters, including spaces. |
User picker (multiple users) ADVANCED | Allows selecting multiple users |
Version picker (multiple versions) ADVANCED | Allows selecting multiple versions |
Version picker (single version) ADVANCED | Allows selecting one version |
JIRA SOFTWARE ONLY custom field types | |
Global rank ADVANCED | Jira Software automatically creates the Rank custom field of this type. The Rank field allows you to assess the importance or urgency of your issues and prioritize them, move them across sprints, or group sub-tasks under particular parent issues. Learn more about ranking |
Hidden job switch ADVANCED | Sets a hidden switch programmatically to choose whether or not to create a Perforce job. |
Jira released version history ADVANCED | Allows setting a custom release version |
Job checkbox ADVANCED | Creates a checkbox to choose whether or not to create a Perforce job. |
Original story points ADVANCED | Stores the original number of story points assigned to an issue before the work on it is started |
新しいカスタム フィールドの作成
カスタム フィールドを作成するには、次のようにします。
- 画面右上で [管理
] > [課題] の順に選択します。
Under Fields (the left-side panel), select Custom fields.
[カスタム フィールドを追加] を選択します。
[フィールド タイプの選択] モーダル ダイアログで [すべて] を選択し、使用可能なすべてのフィールド タイプを表示できるようにします。
フィールド タイプを選択し、[次へ] を選択します。たとえば、[チェックボックス] フィールド タイプを選択します。
Configure the field by entering its name, description, and options if required. Select Next.
You’ll see the Name as the custom field's title when entering and retrieving information on issues. You’ll see the Description beneath the field when creating new issues and editing existing issues, but not when browsing issues.フィールドのコンテキストを設定します。
- カスタム フィールドを適用する必要があるプロジェクトを選択します。
- [作成] を選択します。
これで、新しいカスタム フィールドを課題画面に関連付け、課題にフィールドを追加できるようになりました。詳細情報
カスタム フィールドの課題画面への関連付け
カスタム フィールドを作成すると、[画面] ページが表示されます。画面の詳細
ここで、カスタム フィールドが表示される課題画面を選択できます。たとえば、[既定の画面] や [課題解決画面] などに表示できます。
フィールドを画面に関連付けるには、目的の画面の横にあるチェックボックスをオンにして、[更新] を選択します。
カスタム フィールドは、これを有効にしたすべての課題画面で使用できるようになります。ここでどの画面も選択しなければ、課題の作成または編集するときにカスタム フィールドは表示されません。
既存の関連付けの編集
カスタム フィールドと選択した画面の関連付けはいつでも編集できます。この操作を行うには、次の手順に従います。
- 画面右上で [管理] > [課題] の順に選択します。
Under Fields (the left-side panel), select Field configurations.
フィールド設定を選択します。
リスト内からカスタム フィールドを見つけて、[画面] を選択します。
関連付けを変更し、[更新] を選択します。
画面との関連性に関係なく、カスタム フィールドを既存の課題に追加することもできます。
カスタム フィールドを課題に直接追加する
カスタム フィールドが課題画面に関連付けられていなくても、特定のタイプの既存の課題にこのフィールドを追加できます。これを行う前に、目的の課題タイプのフィールドが有効になっていることを確認してください。
課題にフィールドを追加する手順は、次のとおりです。
課題を開きます。
Select Admin > Add field. In the dropdown, select the field you want to see in the issue view.
Select Edit field to set a value for the field immediately.
[送信] を選択します。
次のすべての手順を行うには、Jira 管理者 グローバル権限 を持つユーザーとしてログインする必要があります。
カスタム フィールドは、[詳細] ブロックまたは [課題編集画面] のいずれかに表示されます。フィールドを編集できない場合、変更方法を確認してください。
対応する課題画面との関連付けは、自動的に生成されます。
フィールドは、有効にしたすべてのタイプの全課題で使用できるようになります。たとえば、バグに対してのみ、フィールドが有効になっているとします。この場合、そのフィールドを 1 つのバグに追加するとすぐに、フィールドに設定したコンテキストに応じて、特定のプロジェクトまたはインスタンス全体のすべてのバグにフィールドが表示されるようになります。
ボードまたはバックログ ビューでフィールドを有効にする
Jira 管理メニューからフィールドを追加できます。詳細については、画面のタブとフィールドを設定するを参照してください。
あるいは、課題から直接行うこともできます。たとえば、前のセクションで追加した [課題ラベル] カスタム フィールドを有効にしてみましょう。
ボードまたはバックログ ビューに移動して、既存の課題を編集します。
右上隅にある [フィールドを設定] > [フィールドがありません] を選択し、フィールド ヘルパーを開きます。
カスタム フィールドの名前を入力します。この場合は、「Issue label」と入力します。
フィールドのステータスや、フィールドが表示されない理由の詳細、およびフィールドの設定を更新する方法が表示されます。
"課題ラベルの設定" ページから、プロジェクトと課題タイプ スコープのフィールド設定を更新します。 詳細は「カスタム フィールド コンテキストの設定」をご確認ください。
- [OP: Scrum Bug Screen' Screen configuration (OP: スクラムバグ画面の画面設定)] ページから、フィールド画面の設定を更新します。詳細については、「課題ビューの設定」の「追加したフィールドを課題ビューで編集可能にする」セクションを参照してください。
カスタム フィールドが追加される課題タイプを変更する
カスタム フィールドを追加した課題タイプはいつでも変更できます。たとえば、フィールドはバグにのみ追加できますが、すべてのタイプの課題にそれを追加したいとします。
課題タイプを変更するには、以下のようにします。
- 画面右上で [管理] > [課題] の順に選択します。
Under Fields (the left-side panel), select Custom fields.
リスト内からフィールドを見つけて、[アクション] で [設定] を選択します。
On the page with configurations, select Edit configuration.
- Go to Choose applicable issue types and select Any issue type.
フィールドは、すべてのタイプの課題に追加できます。対応する課題画面との関連付けは、自動的に生成されます。
次のステップ
フィールドのコンテキストを変更する場合は、「カスタム フィールドの設定」を参照してください。
You can also find more custom fields from apps on the Atlassian Marketplace (for example, the Jira Toolkit).
独自のカスタム フィールド タイプを構築するには、Jira 開発者向けドキュメントのチュートリアルを参照してください。
Jira でカスタム フィールドを使用する機会をさらに見つけるには、Atlassian Marketplace から以下のいずれかのアプリを試してみてください。
Projectrak – Project Tracking for Jira: 各プロジェクトのニーズに応じて、Jira プロジェクトのフィールドを追加、管理、カスタマイズします。
Power Custom Fields：カスタム フィールド内で、数式、スクリプト、計算済みのフィールド、およびカスタム メッセージを使用します。
Elements Connect – 外部データ フィールド: 任意のデータ ソースを入力できるカスタム フィールドを作成します。
Dynamic Forms for Jira：動的フォームを使用して、明確で関連性があり、ナビゲートしやすい課題画面を作成します。
Reindexing Jira
Changes to custom fields affect Jira search index. After you make changes to any settings, you'll get the following message in the Administration view:
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
The message means that configuration changes have been made to Jira but haven't yet been reflected in the search index. Until Jira search index has been rebuilt, some search queries from Jira might return incorrect results.
To avoid any discrepancies, you should rebuild Jira search index.
If you want to know after what actions with custom fields you need to re-index Jira, check Reindexing in Jira after configuring an instance for tips.
Learn more about other major configuration changes when Jira reindex is required