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

Custom Fields Overview

To help you tailor JIRA to your organisation's needs, JIRA enables you to add custom fields in addition to the built-in fields. For example, if you needed to capture information about the database that each issue relates to, you could add a custom field called 'Database'.

You can choose the most suitable custom field type (see below) for your purposes. For example, you could choose to create this field as a Free Text Field, in which users can type whatever they wish, or as a Select List, which will force users to select from a list of pre-defined options.

Once you have created a new custom field (see below), you will need to add it to one or more screens so that it is available to users. For more information about how field and screens interrelate, please see Configuring Fields and Screens.

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

On this page:

Custom Field Types

JIRA ships with over 20 custom field types and you can find many more in the Plugin Exchange (e.g. the JIRA Toolkit). A sample of the types are listed as follows:

Custom Field Type	説明
Cascading Select	Multiple select lists where the options for the second select list dynamically updates based on the value of the first
Date Picker	Input field allowing input with a date picker and enforcing valid dates
日付と時刻	A custom field that stores dates with a time component.
フリーテキストフィールド (無制限のテキスト)	Multiple line text-area enabling entry of longer text strings
Group Picker	Choose a user group using a popup picker window.
ラベル	Input field allowing labels to be added an issue. E.g. If you are using GreenHopper, the 'Epics' feature is implemented via a 'Labels' custom field.
Multi Checkboxes	Checkboxes allowing multiple values to be selected
Multi Group Picker	Choose one or more user groups using a popup picker window.
Multi Select	Select list permitting multiple values to be selected
Multi User Picker	Choose one or more users from the user base via a popup picker window.
Number Field	Input field storing and validating numeric (floating point) values
Project Picker	Select list displaying the projects viewable by the user in the system
ラジオボタン	Radio buttons ensuring only one value can be selected
Select List	Single select list with a configurable list of options
Single Version Picker	プロジェクトで利用可能なバージョンから 1 つのバージョンを選択します。
テキストフィールド	Basic single line input field to allow simple text input of less than 255 characters
URL フィールド	Input field that validates a valid URL
User Picker	Choose a user from the user base via a popup picker window.
Version Picker	Choose one or more versions from available versions in the project.

To build your own custom field types, see the tutorial at the JIRA Developer Documentation.

Search Templates

Search Templates are responsible for indexing a custom field as well as making it searchable through the Issue Navigator (note that custom fields are not searchable via QuickSearch). Each of the default custom field types has a related preconfigured search template.

When you create a new custom field (see below) you will need to specify its Search Template.

Custom Field Context

The custom field context allows your custom field to be configured differently for numerous different combinations of issue types and projects. For example, your custom field could have different default values for different projects (and/or issue types).

When you create a new custom field (see below) you will need to either select the applicable issue type(s) and project(s), or define the custom field to be global. You can change this later if required — see Configuring a Custom Field.

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

To create a new field, associate it with a context, and add it to a screen:

Log in as a user with the 'JIRA Administrators' global permission.
Select 'Administration' > 'Issues' > 'Fields' > 'Custom Fields' (tab).
Keyboard shortcut: 'g' + 'g' + start typing 'custom fields'
Click the 'Add Custom Field' link on the presented page and the 'Add Custom Field - Step 1' screen will be displayed.
Select the appropriate 'Field Type' field the list.
Click the 'Next' button and the 'Add Custom Field - Step 2' screen will be displayed.
Fill in the 'Field Name' and 'Field Description'. The Field Name will appear as the custom field's title in both entering and retrieving information on issues. The Field Description is displayed beneath the data entry field when entering new issues and editing existing issues, but not when browsing issues.
Select an appropriate 'Search Template' (see above). Pre-configured search templates are available for each shipped custom field type. A description of each search template will appear next to the select list when you select one.
Select one or any number of 'Issue Types' to which this custom field will be available. Alternatively, select 'Any issue type' to make the custom field available to all Issue Types. You can change this in the future if you need to.
Select the applicable context, that is, the 'Project(s)' to which the custom field will be available. Alternatively, select 'Global context' to make the custom field available to all projects.
- If issue types were chosen, the custom field will only appear for those issue types for the selected project(s).
Click the 'Finish' button.
This will bring you to the screen association page:
Select a screen, or screen tab, on which to display your newly created custom field. You must associate a field with a screen before it will be displayed. New fields will be added to the end of a tab.
Click the 'Update' button. You will return you to the View Custom Fields page, which displays a summary of all custom fields in your JIRA system. You can edit, delete or configure custom fields here. This page is also directly accessible from the menu bar to the left of all Administration pages. For details please see Configuring a Custom Field.