Configuring a Custom Field

カスタムフィールドを表示する

To view the custom fields in your JIRA system:

1. Log in as a user with the JIRA Administrators global permission.
2. Choose > Issues. Select Fields > Custom Fields to open the Custom Fields page.
   Keyboard shortcut: g + g + start typing custom fields

カスタムフィールドの編集

Editing a custom field allows you to change its Name (label), Description (Help text) and Search Template.

カスタム フィールドを編集する方法は以下のとおりです。

1. カスタム ページに移動して希望するカスタム フィールドを見つけ、歯車アイコン >編集を選択します。
   • 名前は、ユーザーに表示されるときに、カスタム フィールドの左に表示されるラベルです。

   • The Description is the Help text that appears below the custom field when it is displayed in the Simple Search column.

   • Search Templates are responsible for indexing a custom field as well as making it searchable via Simple Search and Advanced Search (note that custom fields are not searchable via Quick Search). Every custom field type has a preconfigured search template, but you may select a different template using this procedure.

2. 必要に応じてフィールドを変更し、更新をクリックします。

カスタム フィールドの設定

The custom field context – also known as custom field configuration scheme is not related to the field configuration scheme – specifies the following for the custom field:

• 既定値
• オプション
• 既定値とオプションを適用する課題タイプとプロジェクト

You can create multiple contexts if you need to associate different default values and options with particular projects or issue types.

各カスタムフィールドには、カスタムフィールドを追加したときに自動的に作成された「既定構成スキーム:」という名前のコンテキストがあります。

コンテキスト

To change the project(s) and issue type(s) to which a given Default Value and Options apply:

1. カスタムページに移動して希望するカスタムフィールドを見つけ、歯車アイコン >設定を選択します。
2. 「既定の構成スキーム...」という名前のコンテキストを見つけて、構成の編集リンクをクリックします。
3. Under Choose applicable issue types, select the issue type(s) to which you want this Default Value and Options to apply. You can select any issue types if you wish.
4. Under Choose applicable contexts, select the project(s) to which you want this Default Value and Options to apply. Note that this will apply to only issues with the selected issue type(s) as above.

新しいコンテキストの追加

新しいコンテキストを追加することで、課題タイプとプロジェクトのさまざまな組合せに対し、異なるカスタムフィールドを構成できます。

新しいコンテキストを追加するには、次の手順を実行します。

1. カスタムページに移動して希望するカスタムフィールドを見つけ、歯車アイコン >設定を選択します。
2. 「新しいコンテキストの追加」リンクをクリックします。「設定スキームコンテキストの追加」ページが表示されます (以下を参照)。
   
   • 「設定スキームコンテキストの追加」から、新しいコンテキストの「ラベル」と「説明」を追加します。これらは、管理目的でのみ使用され、エンドユーザーには表示されません。
   • Under 'Choose applicable issue types', select the issue type(s) to which you want this Default Value and Options to apply. You can select Any issue types if you wish.
   • Under 'Choose applicable contexts', select the project(s) to which you want this Default Value and Options to apply. Note that this will apply to only issues with the selected issue type(s) as above.

カスタムコンテキストには、JIRA プロジェクトごとに 1 つのコンテキストのみを持たせることができます。そのため、同じプロジェクト内の異なる課題タイプに複数のコンテキストを持たせることができます。

既定値

To edit the default value that a custom field contains when it is first displayed to a user:

1. カスタムページに移動して希望するカスタムフィールドを見つけ、歯車アイコン >設定を選択します。
2. 関連コンテキストを探し (通常は 1 つで、「既定の設定スキーム」などという名前になります)、右側の列の「 既定値の編集」リンクをクリックします。「カスタムフィールドの既定の設定」ページが表示され、カスタムフィールドタイプ特有となります。
   
   • (For a Select List or Multi-Select List) Select the appropriate default value from the drop-down list.
     To clear the default of a select field, click on the current default so it is no longer highlighted and then save, as described here: Unable to De-select Default Value for Multi Select Custom Field.
   • (For a Cascading Select List) Select the appropriate default values from the drop-down lists (one for each level).
   • (For a Date field) Specify a date, or tick the check-box to make the current date the default.
   • (For other types of fields) Type the appropriate default values from the drop-down lists (one for each level).
     Certain types of custom fields, such as calculated custom fields, may not allow for defaults to be selected and will not have the Edit Default Value link.

オプション

次のタイプのカスタムフィールドにオプションの値を指定できます。

• リストの選択
• 複数選択リスト
• Cascading selects lists
• ラジオ ボタン
• 複数チェックボックス

オプション値を追加、削除、並べ替え、オプションをアルファベット順に並べ替え、またはテキストを編集できます。また、オプション値に HTML を使用することもできます。完全なタグのペアを使用し、HTML が正しく表示されることを確認してください。

These options are case insensitive, so when using a select or multi-select list for a notification scheme, JIRA-ADMINISTRATORS will match the jira-administrators group. This means you cannot have both a JIRA-ADMINSITRATORS and a jira-administrators option, as they have the same name.

To edit a custom field's options:

1. カスタムページに移動して希望するカスタムフィールドを見つけ、歯車アイコン >設定を選択します。
2. 関連コンテキストを探し (通常は 1 つで、「既定の設定スキーム」という名前になります)、右側の列の「オプション」リンクをクリックします。「カスタム フィールド オプションの編集」ページが表示されます (以下を参照)。ここでは、以下のことを実行できます。
   
   • Select from the Edit parent select list drop-down to choose which list to edit. (For a Cascading Select List only)
   • 「アルファベット順に並べ替え」をクリックし、オプションをアルファベット順に並べ替えます。
   • オプションを手動で並べ替えるには、順序列の矢印をクリックするか、数字を指定して移動 ボタンをクリックします。
   • 「編集」をクリックしてオプションのテキストを変更します。
   • 選択できなくなったオプションを非表示にするには、無効化をクリックします。使用中のオプションは削除できません (データの整合性を保つため) が、ビジネス要件の変更にしたがって無効となるオプションに対応するため、新しい課題では利用できないように設定することができます。
   • 「削除」をクリックしてオプションを削除します。(使用されていないオプションのみに使用できます。)

User Filtering

ユーザーピッカーフィールドで利用可能なユーザー数を制限できます。ユーザーは、特定のグループおよび/あるいはプロジェクトロール内のユーザーに制限できます。

To filter the users in a user picker field:

1. カスタムページに移動して希望するカスタムフィールドを見つけ、歯車アイコン >設定を選択します。
2. Click Edit User Filtering.
3. 「グループまたはプロジェクトロールのフィルタリングを有効化」をクリックしてから、ユーザーピッカーを制限するグループやロールを指定します。
   ユーザーピッカーは、選択したグループまたはロール内のユーザーのみを表示します。
4. [保存] をクリックします。

画面の選択

To choose the Screens on which a custom field will appear:

1. カスタム ページに移動して希望するカスタム フィールドを見つけ、歯車アイコン >画面を選択します。
2. Select the check boxes of the screens on which you wish to display this custom field.
   Note that field visibility depends on the field configuration (which is not related to the custom field configuration scheme described above). Refer to Specifying Field Behavior for more information.

カスタムフィールドの翻訳

作成する任意のカスタムフィールドの名前や説明を、別の言語に翻訳できます。選択は、JIRA にインストールされている言語パックからのみ行うことができます。

To translate the field and description of a custom field to another language:

1. Navigate to the Custom Fields page, locate the desired custom field and choose cog icon > Translate.
2. Choose the language pack that this custom field translation will belong to (e.g. French) and enter the translated strings for the Field Name and Description.

カスタム フィールドのトラブルシューティング

JIRA アドミンヘルパーを使用する

JIRA アドミンヘルパーは、カスタムフィールドが画面に表示されない理由を診断するのに役立ちます。このツールは JIRA 管理者のみが使用できます。

To diagnose why a custom field is not showing on the View Issue, Edit Issue or Create Issue screens:

1. フィールドに表示されていない [課題の表示]、[課題の編集]、または [課題の作成] 画面に移動します。
2. 課題を表示中の場合は、その他のアクション > フィールドを探すをクリックします。課題を作成または編集中の場合は、フィールドの設定 > フィールドを探すをクリックします。
3. フィールドの名前を入力します。
4. 送信をクリックします。

Tip: You can also access the 'Where is my field?' dialog via the cog menu for each issue in the issue navigator. 

カスタムフィールドの説明を変更する

フィールド設定で説明を変更しても、カスタムフィールドの説明に対する変更が表示されないとは限りません。

JIRA では、カスタムフィールドの説明を定義でき、フィールド設定の説明が空白の場合、課題を作成または編集するときや、課題ナビゲーターのヘルプテキストとして、元の説明テキストが表示されます。ただし、各フィールド説明に別の説明テキストを定義することもできます。これにより、元のフィールド説明テキストが上書きされます。

たとえば、「マイフィールド」という名前のカスタムフィールドが、「これは私のフィールドです」という説明で定義され、フィールド設定が変更されていなければ、表示されるテキストは期待どおり「これは私のフィールドです」になります。フィールド設定が使用され、カスタムフィールドのフィールド説明が「これは私の素晴らしいフィールドです」と設定されている場合、表示されるテキストは「これは私の素晴らしいフィールドです」になります。