In general, the pool of issues available for selection is determined by the field’s context.
Further down, it can be narrowed down by additional filtering using a JQL query.
Apart from the default JQL syntax, we provide custom JQL functions to allow even more control of the results.
Issue in relation
This JQL function helps find all your issues within certain relations. It would be best to explain the function's logic using an example.
An employee profile issue has an Advanced Link field ‘Hardware’. It is required to configure selectable issues for this field.
The options available for selection should be displayed only if they are selected in another Advanced Link field ‘Assets'.
The JQL for such scope will appear as follows:
issue in relation("issuetype = Hardware", "Organisation - Assets", "level1")
This expression will return all the issues that are selected in the advanced link fields ‘Organisation - Assets’, both outward and inward. An additional parameter "issuetype = Hardware" has been added to narrow down the issues. "level1" parameter indicates that only issues selected directly in the field will be returned.
Overall, the issue in relation to function has the following structure:
issue in relation("JQL filter", "Advanced Link name", "Link level")
where the 3 parameters are interpreted as:
"Advanced Link name" (required)- full name of the Advanced Link configuration
"Link level" (required) - currently extends to levels 1 & 2. When querying for level 2, the query will also return issues linked to issues from level 1.
"JQL filter" (optional) is applied to the issues additionally
Currently ‘issues in relation’ does not support the ‘not’ JQL operator.
This function is applicable only in the Advanced link configuration. It can not be used for JQL search.