How to save and track time in Jira Software? Watch our joint webinar with Tempo!

Dynamic Forms for Jira

Jira Server
HOSTING
Last updated Dec 10, 2018

Dynamic Forms

This page provides information on how to configure Dynamic Forms.

Dynamic fields feature allows to create conditions which field/custom field should be displayed after selecting an option in the previous field/custom field.

Warning

To set a configuration, log in as a user with Jira Administrators global permission.

Prerequisites

Before you start add new custom fields to Jira which are provided by Dynamic Forms:

  • Deviniti Dynamic Forms for Jira - Dynamic Cascading Select,
  • Deviniti Dynamic Forms for Jira - Dynamic Checkboxes,
  • Deviniti Dynamic Forms for Jira - Dynamic Multiselect,
  • Deviniti Dynamic Forms for Jira - Dynamic Radio Buttons,
  • Deviniti Dynamic Forms for Jira - Dynamic Select.

Steps

  1. Go to Jira Administration > Issues.
  2. Select Custom fields from the menu in the Fields section.
  3. Click Add custom field.
  4. Select Deviniti Dynamic Forms for Jira - Dynamic custom field from the list (in the advanced section).
  5. Click Next.

    Dynamic Forms
    Dynamic Custom Fields in Jira

  6. Configure the selection criteria for the field: Name and Description (optional).

  7. Click Create.

  8. Select the checkboxes of the screens on which this custom field will be displayed.

  9. Click Update.

Result

Deviniti Dynamic Forms for Jira - Dynamic custom field is added to Jira.

Add a new configuration

Steps

To add a configuration of Dynamic Forms:

  1. Go to Jira Administration > Add-ons.
  2. Select Dynamic Forms from the menu in the Dynamic Forms for Jira section.
  3. Click Create Dynamic Forms.
    Warning

    Supported custom fields: Dynamic Cascading Select, Dynamic Checkboxes, Dynamic Multiselect, Dynamic Radio Buttons, Dynamic Select, Select Options Mapper.


    Add Dynamic Forms configuration in Jira
    Add Dynamic Forms configuration in Jira
  4. Select field/custom field from the drop down list and click Add.
    Add Dynamic Forms configuration in Jira
    Dynamic Forms configuration in Jira

  5. Click ••• > Details to display more options.
    Add Dynamic Forms configuration in Jira
    Add Dynamic Forms configuration

    a. Empty value: When this option is enabled, None (=empty) value can be selected. To make it disabled, set the state of switch to off. Empty value will not be shown on the list.
    b. Autocomplete: Define if the field should be selectable. If you set the state of switch to on, the field will be a text box, which will filter the items.
    c. Remember last value: When this option is enabled, last value of field is saved in case of changing the value of dynamic custom field. Remembered value works on the current Create Issue screen, when Dynamic Form reappears. This option affects also Jira Custom Fields Default Value. It means that if Remember Last Value toggle is on, Default Value will appear in target field. To make it disabled, set the state of switch to off. Previous field’s values will be cleaned.
    d. Field width: Define the field width in pixels. If this field is empty, the default value of field width will be set.
    Dynamic Forms details in Jira
    Configure Dynamic Forms details in Jira

  6. In the table on the bottom of the screen, there are:
    Dynamic Forms details in Jira
    Configure Dynamic Forms in Jira

    a. Option: Select the option which will be a trigger for Dynamic Forms.
    b.
    Related fields
    : Select the field / custom field which will show up after selecting the option (defined in the Option).
    Info
    Before you start configuring Related fields, see the list of supported fields.
    Note
    Dynamic fields can be nested only three times (fourth level must be a field/custom field). You can increase this number. Read more in Deep Nesting section.
    Tip
    You can also set Priority, Issue Links and Attachment as related field.

    c. Required: Set the state of switch to on to make the field / custom field (defined in the Related field) required.
    d. Actions: Click the pencil icon to set: Tooltip message and Required validation message for language which you want. Click the trash icon to remove settings of selected option.
    Tip
    To add a new related field, click Select related field to start typing and press Enter to confirm.

  7. After clicking the pencil icon, the configuration dialog box appears. Click Save to confirm changes.
    Dynamic Forms in Jira
    Configure Dynamic Forms in Jira
    Note
    If field is not required, a required validation message tab is blocked.

Result

A new configuration of Dynamic Forms is added to Jira.

Tip
If you want to use dynamic forms on the Customer Portal, use Extension for Jira Service Desk app.

Default Value

Default value feature is no longer supported by Dynamic Forms for Jira app. It means that you won’t be able to set Default Value in Dynamic Forms configuration. However Dynamic Forms fields are Jira custom fields and can have a default value configured from Jira level. Read more about setting Default value here.

Info

If your field has a default value, proper notification will appear in Dynamic Forms configuration.

Dynamic Forms in Jira
Configure Dynamic Forms in Jira

Deep Nesting

This section provides information about nesting Dynamic Fields.

In default configuration you can build only three levels of Dynamic Fields in Dynamic Forms structure. Deep nesting toggle allows to increase that number. When this option is enabled, it’s possible to create unlimited amount of levels of Dynamic Forms configuration.

Steps

  1. Go to Jira Administration > Add-ons.
  2. Select Settings from the menu in Dynamic Forms section.
  3. Set the state of Deep Nesting switch to on.
    Dynamic Custom Fields in Jira deep nesting
    Dynamic Custom Fields in Jira deep nesting
    Note
    When Deep nesting is disabled you can only nest Jira custom fields.

Result

You can nest Dynamic Fields in Dynamic Forms without limitation.

Next steps

To make sure that everything works properly, go to the Create Issue screen, choose an option you configured and check if a related field shows up.

Warning
Remember to add all configured fields and custom fields to the screen.

Need help?
If you can’t find the answer you need in our documentation, raise a support request*.
* Include as much information as possible to help our support team resolve your issue faster.