Configuring a Custom Field

Viewing all custom fields

To view all the custom fields in your JIRA system:

1. 「JIRA 管理者」グローバル権限を持つユーザーとしてログインします。
2. Choose the cog icon  at top right of the screen, then choose Issues. Select Fields > Custom Fields to open the 'Custom Fields' page.
   Keyboard shortcut: g + g + start typing custom fields
   From the 'View Custom Fields' page, you can:
   
   • Edit a custom field's 'Name', 'Description' or 'Search Template' — see below.
   • Configure a custom field's 'Options', 'Default Value' or 'Context' — see below.
   • Place a custom field on a particular screen(s) — see below.

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

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

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

1. 「JIRA 管理者」グローバル権限を持つユーザーとしてログインします。
2. Choose the cog icon  at top right of the screen, then choose Issues. Select Fields > Custom Fields to open the 'Custom Fields' page.
   Keyboard shortcut: g + g + start typing custom fields
3. Locate the relevant custom field and choose cog icon > Edit. 
4. 必要に応じてフィールドを変更し、更新をクリックします。
   • The Name is the label that appears to the left of the custom field when it is displayed to a user. You can edit the Name as described above.

   • The Description is the Help text that appears below the custom field when it is displayed in the Simple Search column. You can edit the Description as described above.

     Note that the Help text which appears below the custom field when it is displayed on a screen (ie. when an issue is being created, edited or transitioned through a workflow) is specified via the field configuration — see Specifying Field Behaviour.\

   • 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). Each of the default custom field types has a related preconfigured search template. You can choose a different Search Template as described above.

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

A custom field context (also known as a custom field configuration scheme¹) specifies the Default Value and Options for the custom field, and the issue types and projects to which the Default Value and Options will apply. You can create multiple contexts if you need to associate different Default Values and Options with particular projects or issue types.

Each custom field has a context named "Default Configuration Scheme for ..." which was created automatically by JIRA when you initially added your custom field.

¹ The custom field configuration scheme is not related to the field configuration scheme.

コンテキスト

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

1. 「JIRA 管理者」グローバル権限を持つユーザーとしてログインします。
2. Choose the cog icon  at top right of the screen, then choose Issues. Select Fields > Custom Fields to open the 'Custom Fields' page.
   Keyboard shortcut: 'g' + 'g' + start typing 'custom fields'
3. Locate the relevant custom field and choose cog icon > Configure.
4. Locate the relevant context (there will usually only be one, named 'Default Configuration Scheme for ...') and click the Edit Configuration link.
5. 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.
6. 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. 「JIRA 管理者」グローバル権限を持つユーザーとしてログインします。
2. Choose the cog icon  at top right of the screen, then choose Issues. Select Fields > Custom Fields to open the 'Custom Fields' page.
   Keyboard shortcut: g + g + start typing custom fields
3. Locate the relevant custom field and choose cog icon > Configure.
4. Click the Add new context link . The 'Add configuration scheme context' page will be displayed (see below).
   
   • 「設定スキームコンテキストの追加」から、新しいコンテキストの「ラベル」と「説明」を追加します。これらは、管理目的でのみ使用され、エンドユーザーには表示されません。
   • 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. 「JIRA 管理者」グローバル権限を持つユーザーとしてログインします。
2. Choose the cog icon  at top right of the screen, then choose Issues. Select Fields > Custom Fields to open the 'Custom Fields' page.
   Keyboard shortcut: g + g + start typing custom fields
3. Locate the relevant custom field and choose cog icon > Configure.
4. 関連コンテキストを探し (通常は 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: [ARCHIVED] 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. 「JIRA 管理者」グローバル権限を持つユーザーとしてログインします。
2. Choose the cog icon  at top right of the screen, then choose Issues. Select Fields > Custom Fields to open the 'Custom Fields' page.
   Keyboard shortcut: g + g + start typing custom fields
3. Locate the relevant custom field and choose cog icon > Configure.
4. 関連コンテキストを探し (通常は 1 つで、「既定の設定スキーム」という名前になります)、右側の列の「オプション」リンクをクリックします。「カスタム フィールド オプションの編集」ページが表示されます (以下を参照)。ここでは、以下のことを実行できます。
   
   • Select from the Edit parent select list drop-down to choose which list to edit. (For a Cascading Select List only)
   • 「アルファベット順に並べ替え」をクリックし、オプションをアルファベット順に並べ替えます。
   • オプションを手動で並べ替えるには、順序列の矢印をクリックするか、数字を指定して移動 ボタンをクリックします。
   • 「編集」をクリックしてオプションのテキストを変更します。
   • 選択できなくなったオプションを非表示にするには、無効化をクリックします。使用中のオプションは削除できません (データの整合性を保つため) が、ビジネス要件の変更にしたがって無効となるオプションに対応するため、新しい課題では利用できないように設定することができます。
   • 「削除」をクリックしてオプションを削除します。(使用されていないオプションのみに使用できます。)

画面の選択

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

1. JIRA 管理者グローバル権限を持つユーザーとしてログインします 。
2. Choose the cog icon  at top right of the screen, then choose Issues. Select Fields > Custom Fields to open the 'Custom Fields' page.
   Keyboard shortcut: g + g + start typing custom fields
3. Locate the relevant custom field and click the cog icon > Screens.
4. 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 Behaviour for more information.

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

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

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

1. JIRA 管理者グローバル権限を持つユーザーとしてログインします 。
2. Choose the cog icon  at top right of the screen, then choose Issues. Select Fields > Custom Fields to open the 'Custom Fields' page.
   Keyboard shortcut: g + g + start typing custom fields
3. Locate the relevant custom field and click the cog icon > Translate.
4. 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 アドミンヘルパーを使用する

The JIRA admin helper can help you diagnose why a custom field is not showing on your screens. This tool is only available to JIRA administrators.

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. 

Screenshot: 'Where is my field?' helper for an issue (click to view larger image)