Dynamic JQL placeholder
- Tomislav Nikolic
The currentIssue() placeholder can be used to reference a field value from the current issue. To reference a field, put it’s name or ID in the function argument:
This placeholder will be substituted in the edit mode of the field. Because the function doesn’t actually exist and Jira doesn’t know how to parse it, it won’t be possible to preview the number of issues found by it in the configuration (it will show 0).
Below are a few examples of what can be done using JQL placeholders:
System field “reporter”
Only issues by the same reporter are shown.
System field “project”
Only issues from the same project as the current issue will be shown.
System field “labels”
Only issues where the labels match one of the labels in the current issue.
Single select custom field
Only issues having the same value of a custom field as the current one will be shown.
Reference other Linksy fields
Linksy fields are supported by default in the placeholder
Use multiple placeholders in one query
Multiple placeholders can be combined into one query
Build a cascding structure by referencing other fields
With dynamic JQL, it’s possible to use Linksy to create a cascading structure, where one Linksy field depends on one or more Linksy or other fields
Fields that return an array need to be wrapped in round brackets and compared with the JQL operator IN;
eg. (currentIssue(“labels“)) becomes (label1, label2)
That is because Linksy will convert the array values to a comma-separated list but won’t add the brackets on its own.
Currently, it’s not possible to reference a specific element in the field like currentIssue(“customfield_10101.data[0].name”)
If you need this feature please let us know by suggesting it in our service desk portal.
Create issue and transition screens
Linksy depends on Jira UI modifications to support dynamic JQL placeholder replacement in “Global Issue Create” screen and the new issue transition experience.
Linksy won’t modify your fields and UI modifications are used only to get the values of the fields from the form.
Jira UI modifications are supported in the following project types, and so should dynamic JQL placeholders:
Global issue create
company-managed and team-managed Jira Software
company-managed and team-managed Jira Work Management
Issue transition
company-managed Jira Software
At the time of writing, Jira Software Management projects don’t appear to be supported.
Additionally, not all fields are supported by UI modifications: here is a list of all supported fields per screen.
In the Issue View however, Linksy doesn’t depend on UI modifications and should work for any project type.
Linksy fields are also exempt from the project type limitations; one Linksy field can reference another without depending on UI modifications support.
In case the currentIssue() placeholder interferes with the ticket creation process, there is an option to enable an alternative JQL filter specifically to be used in the Create issue screen.