Specifying Field Behavior
フィールドの構成では JIRAのインストールで利用可能なJIRA自身の「固定/ビルトイン」(「システム」フィールドとして知られている) 、カスタムフィールドを含む、すべてのフィールドの動作を定義します。
各フィールドについて、フィールドの設定を指定します:
- 説明は、課題編集の際のフィールドの下に表示される文面を指定します。
- フィールドの非表示/表示 の設定
- フィールドの 必須 (フィールドの値を指定するための検証するか) / 任意 の設定
- (テキストフィールドのみ) レンダラー 使用する
When defining field behavior 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 behavior of individual fields in these new field configurations.
新しいフィールド設定は、表示する特定のフィールドや固有の動作を示すフィールドを必要とするプロジェクトと課題タイプの組み合わせごとに追加します。
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 behavior on a per project, per issue type basis. For more information, please see the Overview Diagram.
複数のフィールド設定の管理
別のプロジェクト課題タイプで使用するための複数のフィールド設定をすることができます。
- Multiple field configurations are organized into Field Configuration Schemes, which associate field configurations with issue types.
- A scheme can then be associated with one or more projects, allowing you to control fields on a per project, per issue type basis. See Associating Field Behavior with Issue Types for details.
既定のフィールド設定について
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.
It is not possible to delete the Default Field Configuration.
フィールド設定の追加
- 「JIRA 管理者」グローバル権限を持つユーザーとしてログインします。
- Choose > Issues. Select Fields > Field Configurations to open the View Field Configurations page, which lists all your field configurations.
Keyboard shortcut: g + g + start typing field configurations
- 新しいフィールド設定スキームを追加するボタンをクリックし、新しいフィールド設定スキームを追加するダイアログ ボックスを開きます。
- フィールド設定を追加するダイアログ ボックスにすべての情報を入力します:
- 名前 — 新しいフィールド設定をうまく説明する短いフレーズを入力します。
- 説明(任意ですが推奨です) — このフィールド設定スキームを使うべき時を1、2行で説明します。
- Click the Add button to add your new field configuration to JIRA. Once you have added your new field configuration, you can then begin modifying the behavior of its fields (below).
You will be taken directly to the View Field Configuration page, where you can modify the behavior of fields in your new field configuration. See Modifying field behavior (from step 4) below for details.
フィールド設定の編集
- Log in as a user with the JIRA Administrators global permission.
- Choose > Issues. Select Fields > Field Configurations to open the View Field Configurations page, which lists all your field configurations.
Keyboard shortcut: g + g + start typing field configurations
- 編集したいフィールド設定の隣にある編集リンクをクリックします。
- フィールド設定の編集ページで、フィールド設定の名前と説明を編集します。
Please note: The Default Field Configuration cannot be edited.
フィールド設定の削除
- 「JIRA 管理者」グローバル権限を持つユーザーとしてログインします。
- Choose > Issues. Select Fields > Field Configurations to open the View Field Configurations page, which lists all your field configurations.
Keyboard shortcut: g + g + start typing field configurations
- Click the Delete link next to the field configuration you wish to delete.
You will be prompted to confirm this operation.
注意:
- 注意: 既定のフィールド設定 は削除することができません。
- フィールド設定スキームと関連付けられていないフィールド設定のみを削除することができます。 1つ以上のフィールド設定スキームに関連付けられたフィールド設定では、削除リンクは利用できません。
フィールド設定のコピー
- 「JIRA 管理者」グローバル権限を持つユーザーとしてログインします。
- Choose > Issues. Select Fields > Field Configurations to open the View Field Configurations page, which lists all your field configurations.
Keyboard shortcut: g + g + start typing field configurations
- コピーしたいフィールド設定の隣にあるコピーリンクをクリックします。
- On the Copy Field Configuration page, specify the Name and Description for the field configuration to be copied.
The (initial) field settings between the original and copied field configurations will be identical.
Please Note: a newly created field configuration will not take effect until you:
See Associating Field Behavior with Issue Types for more information.
フィールドの動作を指定する
JIRAのフィールドの動作を変更するには、それらのフィールドが定義されているフィールドの設定を変更する必要があります。
To modify the behavior of a set of fields in a field configuration:
- 「JIRA 管理者」グローバル権限を持つユーザーとしてログインします。
- Choose > Issues. Select Fields > Field Configurations to open the View Field Configurations page, which lists all your field configurations.
Keyboard shortcut: g + g + start typing field configurations
- Locate the field configuration of interest and click the Configure link to open the View Field Configuration page, which lists all system and custom fields in your JIRA installation for that field configuration.
Please Note:
- 編集のリンクから個々のフィールドではなく、フィールド設定の名前そして説明の編集ができます。
- (JIRA インストールで定義されたすべてのフィールド設定を表示する)フィールド設定の表示ページの既定のフィールド設定では、編集リンクを使用できないことに注意してください。
- [操作] 列では、任意のフィールドに対して以下のアクションを実施できます。
- 編集 — フィールドの説明を編集します。(ヘルプ テキストなど)
- 表示/非表示 — ビューから課題を非表示にするか、表示します。
- 必須/任意 — フィールドを必須(フィールドが編集するときはいつでも値を指定する必要があります)または任意に設定します。
- Renderers — change a field's renderer (see Configuring Renderers for more information).
Please Note: a newly created field configuration will not take effect until you:
- Associate your new field configuration to one or more issue types and then
- フィールド設定を1つ以上のプロジェクトの関連付けます。
See Associating Field Behavior 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:
- 上記(「フィールド動作の変更」セクション)の最初の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.
注意:
- Hiding a field in the field configuration is distinct from not adding a field to a screen. Fields hidden through the field configuration will be hidden in all applicable screens, regardless of whether or not they have been added to the screen.
- For fields that have a default value: If the field is hidden in the field configuration, then it will not receive a value when an issue is created, regardless of whether the field is present on the Create Issue screen(s). (The following fields can have a default value: Resolution , Status , Priority , Issue Type , Security Level and custom fields.)
- フィールドの概要や課題タイプは非表示にはできません。非表示オプションは表示されません。
To hide or show a field:
- 上記(「フィールド動作の変更」セクション)の最初の3つのステップに従って、フィールドを表示または非表示にするフィールド設定にアクセスします。
- 次のいずれかを行います。
- If you no longer want to expose a field through JIRA's user interface, click the Hide link associated with that field.
You can make this field visible again at any time by clicking the Show link.
- If you want to show a field (which is currently hidden) through JIRA's user interface, click the Show link associated with that field.
You can hide this field again at any time by clicking the Hide link.
- If you no longer want to expose a field through JIRA's user interface, click the Hide link associated with that field.
フィールドの必須、任意の設定
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:
- Follow the first three steps above (in Modifying field behavior) to access the field configuration whose fields you wish to hide or show.
When viewing a field configuration (see above), fields which are already required have that indication next to their name.
- 次のいずれかを行います。
- To make a field mandatory when used through JIRA's user interface, click the Required link associated with that field.
The text Required will appear next to the field's name.
- To make a field optional, click the Optional link associated with that field.
The Required text next to the field's name will disappear.
- To make a field mandatory when used through JIRA's user interface, click the Required link associated with that field.
注意:
- 隠されているフィールドを必須に設定することはできません。
- フィールドを 必須 にする場合、フィールドが 課題作成画面 に存在することを確認します。
- Note that you can have different field configurations for different projects and issue types (see Associating field behavior with Issue Types), so you need to ensure that all Required fields are present on the Create Issue screens for all associated projects and issue types (see Associating screens with Projects and Issue Types).
- )を使用して、1つのトランジションにのみフィールドを必須にする機能のリクエストチケットがあります。( JRA- 5783 )よろしければ、その課題のステータスを見てみてください。
フィールドのレンダラーを変更する
JIRA currently ships with the following renderers:
- For text fields:
- The Default Text Renderer, which displays plain text; and
- The Wiki Style Renderer (utilising the Confluence wiki engine), which displays rich text (HTML).
To see how a 'Wiki Style Renderer' field will look when it is displayed to a user, please see Editing Rich-Text Fields.
- For multi-select fields:
- The Autocomplete Renderer, which allows the user to start typing text which is then 'autocompleted', or to select from a dropdown list of options; and
- The Select List Renderer, which simply provides a dropdown list of options.
For custom fields of type Multi Select, only the Select List Renderer is available. Furthermore, when modifying a field configuration, you will not be able to configure a Multi Select custom field's renderer.
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:
- Follow the first three steps above (in Modifying field behavior) to access the field configuration whose field's renderer you wish to change.
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.
- 変更したいフィールドのレンダラーをクリックします。設定の利用可能なすべてのレンダラーからレンダラーを選択するページに移動します。
- このページでは、変更によって課題に影響を受ける可能性がある場合、警告でお知らせします。課題に影響がない場合、警告は表示されません。このページから、使用するレンダラーを選択して更新をクリックします。
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.