Apps documentation
Dynamic Forms for Jira
Dynamic Forms for Jira
Version 6.x
Version 5.x and older
FAQ
Release notes
Last updated Nov 15, 2021

Connecting a data source

Learn how to display information from you data source in a Bundled Fields' subfield

Once you’ve created a data source, you need to connect it to Bundled Fields in order to display the external data in Jira.

Prepare the custom field

This configuration works for the following types of subfields:

  • Text Field (single line)
  • Text Field (multi-line)
Tip

Read about connecting a Select List (single choice) in the Synchronizing options chapter.

Steps

To connect a data source do a Text Field subfield:

  1. Go to Jira Administration > Manage apps.
  2. Select Bundled Fields from the Dynamic Forms app navigation.
  3. Select the Bundled Fields custom field or create a new one.
  4. Prepare the trigger subfield that will activate your data source. (When users fill it in on the Create or Edit screen, it will automatically fill in the other subfields with values from your data source).
  5. Prepare the subfields that will receive the data from the data source.
  6. Open the three dots menu of the trigger subfield.
  7. Click Connect data source.
Dynamic Forms for Jira - Bundled Fields Data Sources: Prepare the custom field
Dynamic Forms for Jira - Bundled Fields Data Sources: Prepare the custom field
Tip

To learn more about configuring the Bundled Fields custom field, see Bundled Fields Configuration.

Result

A dialog window for mapping subfields appears.

Map the data to subfields

Steps

  1. Choose the Event to specify when to retrieve the data from your data source:
    • Currently we support only the On change event.
  2. Choose one of your data sources.
  3. Select the type of input parameters. You can choose between these two types:
    • Subflied
    • Constant
  4. Define the value of input parameters:
    • If you’ve chosen Subfield, select the subfield from the list.
    • If you’ve chosen Constant, type in the value for the constant.
Note
Input parameters determine how to activate your data source on the Create and Edit screens. Filling in these fields with the chosen input value will retrieve the external data into subfields that you will define in the next step.
  1. Choose the subfields that should receive values from your defined JSON paths.
  2. Click Save.
  3. Remember to save the changes to Bundled Fields.
Dynamic Forms for Jira - Bundled Fields Data Sources: Prepare the custom field
Dynamic Forms for Jira - Bundled Fields Data Sources: Prepare the custom field

Result

Your data source is connected to the chosen subfields. A server icon is displayed next to subfields connected to a data source:

Dynamic Forms for Jira - Bundled Fields Data Sources: Connected subfield
Dynamic Forms for Jira - Bundled Fields Data Sources: Connected subfield

Displaying the data source on the Create and Edit screens

Your Bundled Fields custom field is now configured to display information from your data source. When users will fill in the trigger subfield, the other subfields will be filled with values of your chosen JSON paths.

Dynamic Forms for Jira - Bundled Fields Data Sources: Display data on the Create and Edit screen
Dynamic Forms for Jira - Bundled Fields Data Sources: Display data on the Create and Edit screen
Tip

Remember to add your Bundled Fields custom field to the target screens.

Next steps

Need help?

If you can’t find the answer you need in our documentation, raise a support request.