How to Use Issue Pickers in Automation Rules

Use VIP.LEAN Issue Picker fields in Jira Automation: set, add and copy work item keys, use attributes of picked work items, and let the app keep Jira links in sync.

1. How an Issue Picker Stores Its Value

Required Jira Role: Jira Administrator

An Issue Picker field stores a list of work item keys, for example ["RISK-198", "RISK-204"]. This is also true for single-select pickers; they use one key.

Your rules need the field ID. You find it in the Issue Picker editor under Field â€ș Field ID, for example customfield_10096. The examples below use customfield_10096; replace it with your own field ID.

2. Set Work Item Keys

Required Jira Role: Jira Administrator

Use the action Edit work item and enter the JSON under More options â€ș Additional fields.

2.1 Set Specific Keys

One work item:

{ "fields": { "customfield_10096": ["RISK-1"] } }

Several work items (multi-select only):

{ "fields": { "customfield_10096": ["RISK-1", "RISK-2"] } }

2.2 Add a Key and Keep the Current Ones

{ "fields": { "customfield_10096": [{{#issue.customfield_10096}}"{{.}}",{{/}}"RISK-100"] } }

The field does not remove duplicates. If the key may already be in the field, add a condition first, for example the smart value condition {{issue.customfield_10096}} does not contain RISK-100.

2.3 Copy Keys from Another Issue Picker

{ "fields": { "customfield_10096": [{{#issue.customfield_10123}}"{{.}}"{{^last}},{{/}}{{/}}] } }

â„č Links follow automatically

If the Issue Picker has a Link type, the app also creates and deletes the Jira links for changes made by Automation rules or the REST API, and for values set when a work item is created. This happens in the background a few seconds later. Removing a key from the field deletes the matching link.

3. Use Attributes of Picked Work Items

Required Jira Role: Jira Administrator

To work with fields of the picked work items, look them up first:

  • Action Lookup work items with the JQL key in ({{issue.customfield_10096}})
  • Then use the result, for example to copy the assignee of the first picked work item: {{lookupIssues.first.assignee.accountId}}

4. Fill the Field from Existing Links

Required Jira Role: Jira Administrator

For new links you need no rule: turn on Add field value if link is added in the Links section of the Issue Picker, and the field follows links created in Jira.

For links that already exist, use the app's Auto-fill (see How to Auto-Fill Issue Pickers Based on Existing Links), or a rule:

  • Action Lookup work items with the JQL issue in linkedIssues("{{issue.key}}", "has risk")
  • Action Edit work item with { "fields": { "customfield_10096": [{{#lookupIssues}}"{{key}}"{{^last}},{{/}}{{/}}] } }

This replaces the current value of the field.

â„č Notes

Use your own field IDs and link type names. The app does not check keys written by rules, so they must belong to existing work items. Test a new rule on a single work item and check the audit log. For list smart values, see Atlassian's documentation on smart values and Lookup work items.

Jump to: