Apps documentation
Extension for Jira Service Management
Cloud Server/Data Center
Extension for Jira Service Management

Cloud

Server/Data Center

Documentation
FAQ
Release notes
Articles & Videos
Last updated May 8, 2024

Global configuration

Warning

Before you start, log in as a user with the Jira Administrators global permission.

Note
  • Global configuration of Dynamic Forms is automatically shown in the project configuration.
  • Remember to add the fields to the issue screen and to the request type.
  • Related fields must be optional in Jira. You can set them as required in the configuration of Dynamic Forms.
  • To check your settings, go to:
    Project Settings > Request Types > Edit fields > Add a field.
  • Remember to configure both Related and Master fields in the Request Type.

Steps

To set configuration:

  1. Go to Jira Administration > Manage apps.
  2. Select Dynamic Forms from the menu in the Extension for Jira Service Management section.
  3. Click Create Dynamic Forms.
Info
To add the existing Dynamic Forms file, click Import Dynamic Forms.
Jira Service Management custom forms - Configuration
Jira Service Management custom forms - Configuration
  1. The Add Field/Custom field to configuration dialog box appears. Select Field/Custom field for configuration. You can also Create new custom field.
Note
  • To learn about the fields that can be used in configuration, check Supported fields.
  • It’s also possible to use Assets object field as a master field. To learn more, navigate to Compatibility.
Tip
To create a new custom field and use it for configuration, you can click Create new custom field or navigate to Jira Administration > Issues > Custom fields.
  1. Click Add.

    Adding Jira Service Management custom fields and system fields to Dynamic Forms
    Adding Jira Service Management custom fields and system fields to Dynamic Forms

    Selected field/custom field is added to the list.
    Note

    Click the link to create new custom field. You will be redirected to Jira Administration > Issues > Custom field.

  2. Turn on the toggle to make configuration available in the global context.

  3. Select Context and configure the following:

    • Option: Select the option which will be a trigger for Dynamic Forms.

      Note

      Fields available in the Option are related to the previous chosen field/custom field.
      Change them by going to Jira Administration > Issues > Custom fields.

    • Related field: Select the field/custom field which will be shown after selecting the option (defined in the Option).

      Tip

      To add a new related field, click Select related field to start typing and press Enter to confirm.

      Note

      All Jira fields and standard custom field types are supported. They are added to the configuration with a context named Default Configuration Scheme for …, which is created automatically when you add a new custom field to Jira. From version 6.0.5 the following fields provided by Elements Connect are supported: Live Text, Live User, Snapshot Date, Snapshot Datetime, Snapshot Text.

    • Required: Turn on the toggle to make the field/custom field (defined in the Related field) required.

    • Default value: Turn on the toggle to keep default value from the field/custom field (defined in the Related field).

    • Actions: Click the trash icon to remove selected fields.

Jira Service Management custom forms - Configuration
Jira Service Management custom forms - Configuration
Warning

If you turn off the Dynamic Forms toggle, it will become inactive on all the related projects except of the ones that have their own project configuration enabled. The configuration will be saved as a draft.

Result

A global configuration of Dynamic Forms is added.

More options

To see more options, click the three dot icons on the right side of the table:

  • Clear configuration: Clear all related fields with their settings and start building configuration from scratch.
  • Delete configuration: Delete a configuration for selected field/custom field. It will be removed from the list in the left sidebar.
Jira Service Management custom forms - Configuration
Jira Service Management custom forms - Configuration

Add a new global configuration

Steps

To add a new global configuration of Dynamic Forms:

  1. Click the plus icon in the left sidebar.
    Jira Service Management custom forms - Configuration of Dynamic Forms
    Jira Service Management custom forms - Configuration of Dynamic Forms

    The Add Field/Custom field to configuration dialog box appears.
  2. Follow Add a first configuration from step 4.

Convert a global configuration into project configuration

Steps

To convert global configuration into project configuration and make any changes, go to the appropriate project.

  1. Click here in the description.
    Converting a global configuration into the project configuration with Extension for Jira Service Management
    Converting a global configuration into the project configuration with Extension for Jira Service Management

    The Go to project configuration dialog box appears.
  2. Select project from the list.
    Note
    This list stores only service projects.
  3. Click Go.
    Extension for Jira Service Management - converting to service project configuration
    Extension for Jira Service Management - converting to service project configuration

Result

The global configuration is converted into the project configuration.

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.