What is a 'field configuration'?

A 'field configuration' defines the behaviour of all fields available in your JIRA installation, including JIRA's own 'fixed'/'built in' fields (known as 'system' fields) and custom fields.

各フィールドについて、フィールドの設定を指定します:

  • 説明は、課題編集の際のフィールドの下に表示される文面を指定します。
  • フィールドの非表示/表示 の設定
  • フィールドの 必須 (フィールドの値を指定するための検証するか) / 任意 の設定
  • (テキストフィールドのみ) レンダラー 使用する

When defining field behaviour for one or more JIRA projects and the fields used by the issue types in these projects, you typically start by adding one or more new field configurations (see below). You then begin modifying the behaviour of individual fields in these new field configurations.

(tick) A new field configuration should be added for each project and issue type combination which requires specific fields to be present and/or fields that express unique behaviour.

You can then associate each new field configuration with a different issue type through a 'field configuration scheme'. A field configuration scheme can then be associated with one or more projects.

This process of association gives you the flexibility of defining field behaviour on a per project, per issue type basis. For more information, please see the Overview Diagram.

On this page:

複数のフィールド設定の管理

別のプロジェクト課題タイプで使用するための複数のフィールド設定をすることができます。

既定のフィールド設定について

When JIRA is installed, the Default Field Configuration is created automatically. All new projects are associated with this configuration. This configuration is also used for projects that are not associated with a Field Configuration Scheme.

(info) It is not possible to delete the Default Field Configuration.

フィールド設定の追加

  1. Log in as a user with the JIRA Administrators global permission.
  2. Select Administration > Issues > Fields > Field Configurations (tab) to open the View Field Configurations page, which lists all your field configurations:
    (tick) Keyboard shortcut: g + g + start typing field configurations
  3. 新しいフィールド設定スキームを追加するボタンをクリックし、新しいフィールド設定スキームを追加するダイアログ ボックスを開きます。
  4. フィールド設定を追加するダイアログ ボックスにすべての情報を入力します:

フィールド設定の編集

  1. Log in as a user with the JIRA Administrators  global permission.
  2. Select Administration > Issues > Fields > Field Configurations (tab) to open the View Field Configurations page (above).
    (tick) Keyboard shortcut: g + g + start typing field configurations
  3. 編集したいフィールド設定の隣にある編集リンクをクリックします。
  4. フィールド設定の編集ページで、フィールド設定の名前説明を編集します。

(info) Please note: The Default Field Configuration cannot be edited.

フィールド設定の削除

  1. Log in as a user with the JIRA Administrators global permission.
  2. Select Administration > Issues > Fields > Field Configurations (tab) to open the View Field Configurations page (above).
    (tick) Keyboard shortcut: g + g + start typing field configurations
  3. Click the Delete link next to the field configuration you wish to delete.
    (info) You will be prompted to confirm this operation.

(info) 注意:

フィールド設定のコピー

  1. Log in as a user with the JIRA Administrators global permission.
  2. Select Administration > Issues > Fields > Field Configurations (tab) to open the View Field Configurations page (above).
    (tick) Keyboard shortcut: g + g + start typing field configurations
  3. コピーしたいフィールド設定の隣にあるコピーリンクをクリックします。
  4. On the Copy Field Configuration page, specify the Name and Description for the field configuration to be copied.
    (info) The (initial) field settings between the original and copied field configurations will be identical.

(info) Please Note: a newly created field configuration will not take effect until you:

  1. Associate your new field configuration to one or more issue types.
  2. Associate that field configuration with one or more projects.

See Associating Field Behaviour with Issue Types for more information.

Modifying field behaviour

To modify the behaviour of fields in JIRA, you need to modify the field configurations that those fields have been defined in.

To modify the behaviour of a set of fields in a field configuration:

  1. Log in as a user with the JIRA Administrators global permission.
  2. Select Administration > Issues > Fields > Field Configurations (tab) to open the View Field Configurations page (above), which lists all field configurations defined in your JIRA installation.
    (tick) Keyboard shortcut: g + g + start typing field configurations
  3. Locate the field configuration of interest and click the Configure link to open the View Field Configuration page (below), which lists all system and custom fields in your JIRA installation for that field configuration.
    (info) Please Note:
  4. In the Operations  column, you can perform the following actions for any field:

(info) Please Note: a newly created field configuration will not take effect until you:

  1. Associate your new field configuration to one or more issue types and then
  2. Associate that field configuration with one or more projects.

See Associating Field Behaviour with Issue Types for more information.

課題の説明の編集

Fields can be given descriptions to better identify the meaning of the field. These descriptions are typically displayed under the fields they are associated through JIRA's user interface, for example, when creating an issue or editing it:

Screenshot: Sample description text shown beneath the 'Assignee' field

To edit the description of a field:

  1. Follow the first three steps above (in Modifying field behaviour) to access the field configuration whose field's description you wish to edit.
  2. フィールドの説明の追加や変更をしたい場合は、フィールドの隣にある編集 リンクをクリックします。
  3. 更新ボタンをクリックして変更を保存します。

フィールドの表示/非表示

If your organisation or project has no use for a particular field, you have the option to hide it. Hiding a field will ensure that the the field does not appear on any screens (i.e. issue operation screens, workflow transition screens) where the field configuration applies.

(info) 注意:

To hide or show a field:

  1. Follow the first three steps above (in Modifying field behaviour) to access the field configuration whose fields you wish to hide or show.
  2. 次のいずれかを行います。

フィールドの必須、任意の設定

Certain fields within your organisation may be compulsory for issues. In this case you can set a field to be required, so that JIRA validates that the field has been given a value whenever an issue is edited. If a required field has not been given a value, JIRA will return an error informing the user that the field should be filled, e.g.:

Screenshot: Sample validation of the 'Fix Version/s' field

To make a field required or optional:

  1. Follow the first three steps above (in Modifying field behaviour) to access the field configuration whose fields you wish to hide or show.
    (info) When viewing a field configuration (see above), fields which are already required have that indication next to their name.
  2. 次のいずれかを行います。

(info) 注意:

フィールドのレンダラーを変更する

Before you change the renderer for a specific field, please read Configuring Renderers, paying particular attention to the Implications for JIRA operations section.

To change the renderer for a specific field:

  1. Follow the first three steps above (in Modifying field behaviour) to access the field configuration whose field's renderer you wish to change.
    (info) When viewing a field configuration (see above), the Name column indicates which renderers are currently enabled for all renderable fields, with the current renderer shown in brackets immediately below its field name.
  2. Click the Renderers link for the field you want to change. This will take you to a page where you will have the option to select a renderer from all configured and available renderers:
  3. As shown above, this page will warn you if there are issues that will be affected by the change. If no issues will be affected then the warning does not show. From this page, choose the renderer you wish to use and click Update. You will be presented with a confirmation page:

(info) Changing the renderer only affects how a JIRA field's content is displayed or how a user interacts with a multi-select field — it does not affect the issue data that exists in the system. Hence, you can therefore toggle between renderer types safely.