Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

...

Jira allows you to add and modify all custom fields, including the SLA Metric field. In the Jira system, you can modify each of

...

the custom fields

...

by changing the following:

  • Name — the label that appears to the left of the custom field when it is displayed to a user. See below. Read more
  • Description — the Help help text that appears below the custom field when it is displayed in the Simple Search column. See below. Read more
  • Search Template — the mechanism for that allows making a the custom field searchable. Seebelow. Read more
  • Default Value — the default value of the custom field when it is first displayed to a user. See below.  Read more
  • Options (for Select and Multi-Select fields only) — the range of values from which a user users can choose. See below.User Filtering (for User Picker fields only) — the set of users from which a user can choose. See below. Read more
  • Context — the combination of a project(s) and issue type(s) for which a given Default Value and Options will apply. See below. Read more
    (info) Tip: You can create multiple Contexts, allowing  that allows you to specify set different Default Values and Options for different combinations of projects and/or issue types.
  • Screens — the screen(s) on which the custom field will appear when an issue is created, edited or transitioned through the workflow. See below Read more (also see Defining a Screen).
  • Renderers — (for certain types of fields only) — see  — see Configuring Renderers and and Specifying Field BehaviorBehaviour.
  • Hide/Show — see Specifying Field BehaviorBehaviour.
  • Required/Optional — see Specifying Field BehaviorBehaviour.

...

Viewing the SLA Metric field

To view the custom fields in your JIRA the SLA Metric field in your Jira system:

  1. Log in as a user with the JIRA Jira Administrators global permission.
  2. Choose Image RemovedImage Added > Issues. Select Fields > Custom Fields to open the Custom Fields page.(info) Tip: Keyboard shortcutg + g + start typing custom fields

 Editing a custom field

...

  1. Select SLA Metric from the list.

Editing the SLA Metric field

Editing the SLA Metric field allows you to change its Name (label), Description (Help text) and Search and Searchh Template.

To edit a custom field:

  1. Navigate to the Custom Custom Fields page (proceed as described above), locate the desired custom SLA Metric field and choose Image RemovedImage Added > Edit:
    • The Name is the label that appears to the left of the custom field when it is displayed to a user.
    • The Description is the Help 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 preconfigured search a predefined search template, but you may select a different template using this procedure.

  2. Modify the fields fileds as desired and click Update.

...

Configuring

...

the SLA Metric field

The custom field context – also known as as the custom field configuration scheme is not related to the field the field configuration scheme –  – it specifies the following options 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.

Each custom field has a context named Default Configuration Scheme for ..., which  which is created automatically when you add your custom field.

...

Context

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

  1. Navigate to the Custom Fields page (proceed as described above), locate the desired custom field and choose Image Removed > Configure.
  2. Locate the context named Default Configuration Scheme for ... and click the Edit Configuration link.
  3. Under Under heading Choose applicable issue types, select the issue type(s) to which you want this Default Default Value
     and Options to
    applybe applied. You can select any Any issue types if you wish.
  4. Under Under heading Choose applicable contexts, select the project(s) to which you want this Default Value and Options to apply to be applied. Note that this will apply only to only issues with the selected issue type(s) as above.

...

Adding a new context

Adding a new context allows you to configure a custom field differently for different combinations of issue types and projects.

To add a new context:

  1. Navigate to the Custom Custom Fields page (proceed as described above), locate the desired custom field and choose Image RemovedImage Added > Configure.
  2. Click the Add new context link. The 'Add configuration scheme context' page will be displayed (see below).
    • Under the heading  'Add configuration scheme context', enter a 'Label' and 'Description' for your new context — these are used for administrative purposes only and will not be shown to your end-users.
    • Under the heading  'Choose Choose applicable issue types', select the issue type(s) to which you want this Default Value and Options to applybe applied. You can select Any issue types if you wish.
    • Under the heading  '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.

...

(info) Tip: A field can only have one context per JIRA project. So you cannot have multiple contexts for different issue types in the same project.

 Default value

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

...

.

...

 

Options

You can specify option values for custom fields of the following types:

  • Select lists
  • Multi select lists
  • Cascading selects lists
  • Radio buttons
  • Multi checkboxes

You can add, remove, re-order, sort the options alphabetically, and edit the text of an option value. You can also have HTML in an option value — be sure to use complete tag pairs, and check that the HTML will display correctly.

(info) 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. Navigate to the Custom Fields page, locate the desired custom field and choose Image Removed > Configure.
  2. Locate the relevant context (there will usually only be one, named 'Default Configuration Scheme for ...'), and click the Options link in the right-hand column. The 'Edit Custom Field Options' page will be displayed (see below). Here you can:
    • Select from the Edit parent select list drop-down to choose which list to edit. (For a Cascading Select List only)
    • Click Sort alphabetically to automatically re-order the options alphabetically.
    • Click the arrows in the Order column, or specify a number and click the Move button, to re-order the options manually.
    • Click Edit to change the text of an option.
    • Click Disable to hide an option so that it is no longer available for selection. Options that have been used cannot be removed (to preserve data integrity), but due to changing business requirements, they may become invalid over time and so you may wish to make them unavailable for new issues.
    • Click Delete to remove an option. (This will only be possible for options that have not been used.)

 User Filtering

You can limit the set of users available in your user picker field. The users can be limited to users in specific groups and/or project roles.

To filter the users in a user picker field:

  1. Navigate to the Custom Fields page, locate the desired custom field and choose Image Removed > Configure.
  2. Click Edit User Filtering.
  3. Click Enable group or project role filtering, then specify the groups and/or roles that you want to limit the user picker to.
    The user picker will only show users that are in the groups and roles selected.
  4. Click Save.

 

 

Choosing screens

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

  1. Navigate to the Custom Fields page (proceed as described above), locate the desired custom field and choose Image RemovedImage Added > Screens.
  2. Select the check boxes checkboxes of the screens on which you wish to display this custom field.
    (info) Note that field visibility depends on the the field configuration (which is not related to the the custom field configuration scheme described above). Refer to Specifying Field Behavior for more information.

 

Translating a

...

field

You can translate the name and description of any custom field that you create into another language. You can select only select from the language packs that are installed in JIRAJira.

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

  1. Navigate to the Custom Fields page (proceed as described above), locate the desired custom field and choose Image RemovedImage Added > Translate.
  2. Choose the language pack that this custom field translation will belong to (e.g. French) and .