Migration from Additional Function to Smart Values

1. Overview

The Additional Function feature has been replaced by a new and enhanced feature called Smart Values
Smart Values provides a more flexible, scalable, and maintainable syntax while delivering equivalent and extended functionality.

To ensure a smooth transition and backward compatibility, existing customer configurations that use Additional Function will continue to be supported. A dedicated compatibility mechanism is provided to interpret and migrate legacy configurations to the new Smart Values syntax.

2. Backward Compatibility

Existing configurations using Additional Function continue to work
No changes are required for current customers
Legacy data is preserved

Additional Function - Constructing the JQL Query LEGACY

In the section Content, we use JQL to construct the search query. The result of this search query is a list of issues that will be displayed in the Smart Issue Panel.

Define your JQL in the JQL field. Advanced JQL features like auto-completion, operators, etc. are available.
The Shared Filters allocates all filters which are shared with the current user and selected project.
Selecting a filter will paste the respective JQL query to the JQL field. You can further edit the query in the JQL field after it has been pasted.
An additional JQL function of type value() was added to perform a dynamic search on issue-specific values. Select any allocated field in the Additional Functions drop-down and a respective value() function will be generated and added to the JQL field automatically. (See more parse “Smart JQL” to “JQL” )

Examples for using the Additional JQL function value()

To construct a search based on any of the issues system fields, select the respective system field.

To perform a search based on current reporter issues, select “Reporter“.
The following query will return all issues that are assigned to the current reporter:

CODE

assignee = value("Reporter_[reporter]")

Whereas the following query will return all issues which have a component in the current issues component list:

CODE

component in value("Component/s_[components]")

To construct a search based on the current issue itself or a search that excludes the current issue, select the system field “Key”.

Get a list of all issues linked with the current issue and use it to create your own customized Issue Links panels such as e.g. “Related Bugs”. The following query will return all bugs that are linked to the current issue:

CODE

issue in linkedIssues(value("Key_[issuekey]")) AND issuetype = Bug

To exclude the current issue from the search result you can add the following to your JQL query:

CODE

key != value("Key_[issuekey]")

To construct a search based on any of the issue's custom fields, select the respective custom field.

To perform a search based on the value in the field “Customer“, select “Customer”.
The following query will return all issues where the custom field “Client” has the same value as the current issues custom field “Customer”:

CODE

Client = value("Customer_[customfield_10021]")