Skip to main content
Skip table of contents

Dependencies on the issue context

The dependencies detailed in this page are specific to connected custom fields.

When fetching data from an external source, it can be useful to only retrieve data that is relevant to the current issue, even if it is still being created.

To do that, Elements Connect allows you to reference specific variables and attributes when setting up your query, which can be used to create dependencies to other Jira fields in the same context. This context can be the issue view, or even the issue creation screen.

Configuration

Before being able to use this type of dependency, you need to authorize it on your Jira instance for specific projects and issue types.

This can be done be following these short configurations steps.

1/ Go to Elements Connect in your instance

2/ Open the Settings page in the top menu

image-20240920-131627.png

3/ Use the “Projects” option to select the projects where you want to enable the option, and click on the Add button when your selection is done (you can use the “All projects” option to do it faster!)

image-20240920-131823.png

By default, all the issue types within a project are automatically selected. You can remove them if you don’t want the feature to be enabled in specific cases.

4/ Click on the Save button.

That’s it! Now you can create dependencies between connected custom fields and other fields in the creation screen or the main issue view of your Jira issues.

Supported fields

The table below lists all the fields that can be referenced in your queries, as well as the attributes you can use for these fields.

Field type

Available attributes

Value returned

Summary

$issue.summary

Summary of the current issue

Issue type

$issuetype

Name of the current issue type

Priority

$issue.priority

Priority of the issue

Assignee

$issue.assignee.emailAddress

Email of the assignee on the issue

$issue.assignee.accountId

Atlassian account ID of the assignee of the issue

Reporter

$issue.reporter.emailAddress

Email of the reporter on the issue

$issue.reporter.accountId

Atlassian account ID of the reporter of the issue

Select List (single choice)

$issue.customfield_xxxxx

Displayed value of the option selected in the select list

Text Field (single line)

$issue.customfield_xxxxx

Raw text value

Usage

You can use these attributes to create dependencies in your connected custom fields queries to other Jira fields.

For example, you may want to create a dynamic query in a REST endpoint that returns only the data based on the issue type of your current issue.

API request

CODE
{BaseURL}/search?jql=issuetype="$issuetype"

In this request to the local Jira API, all the issues with the same issue type as the current issue are retrieved.

Known limitations

Value not selected in the connected custom field after a refresh

If you are using a connected custom field with a dependency, the option selected in the custom field will be automatically unselected if the value of the parent field changes.

For example, let’s say your connected custom field has a dependency to the summary of your issue, and that you have selected an option in your custom field.
If the value of the summary is updated, the options of your connected custom field will be automatically refreshed. Even if the value that was selected remains a valid option, it will not be selected anymore and you will have to select it once more manually.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.