Issue Picker Admin Configuration
- 1 Issue Picker Administration view
- 2 Issue Picker Edit Options
- 2.1 Name
- 2.2 Description
- 2.3 JQL to limit search options
- 2.4 Limit field options to current project
- 2.5 Use App-Permissions
- 2.6 Allow to select multiple Issues
- 2.7 Add an Issue Link towards the selected Issue
- 2.8 Delete all Issue Links of selected Type when Issue is unselected from Issue Picker
- 2.9 Show status of selected Issues
- 2.10 Show Issue Key of selected Issues
- 2.11 Show Issue Count during edit
Issue Picker Administration view
The Issue Picker Admin Page can be found in the Apps section of the Jira top menu under Manage Your Apps. Select Issue Picker Administration in the left sidebar.
In the Administration view you see a list of the Issue Picker fields that exist in your instance.
The create button allows to add an Issue Picker custom field:
When adding or editing an Issue Picker field, you have the following options to configure how your Issue Picker works:
Issue Picker Edit Options
Name
Enter a name for your custom field. This cannot be changed when editing an existing Issue Picker. This can be changed in the Jira interface for editing custom fields: [yourinstance].atlassian.net/secure/admin/ViewCustomFields.jspa
Description
Enter a description for the custom field. This cannot be changed when editing an existing Issue Picker. This can be changed in the Jira interface for editing custom fields: [yourinstance].atlassian.net/secure/admin/ViewCustomFields.jspa
JQL to limit search options
Issues that are returned by the JQL query entered here will be shown as options in the Issue Picker drop-down. Please check that you are entering a valid JQL query (i.e. paste it into the native issue search). We a working on an automatic validation feature here.
Please use single ticks 'text' when referring to field values.
Limit field options to current project
When enabled the JQL is only applied to the project in which an Issue is created / edited. This allows to use a single Issue Picker field and context, even when the dropdown values should be project-specific.
Use App-Permissions
By default each Marketplace app is assigned a technical user that belongs to the project role atlassian-addons-project-access. If this setting is enabled, Issue Picker uses the technical user to run the JQL query and link issues (if enabled). If it is disabled the permissions of the logged-in user performing the action is used.
This settings allows to show Issues in the drop-down to which the end-user does not have access to (i.e. does not have Browse permission in the project the issues belong to). This is possible on purpose to make use cases possible where Admins create issues to show as selectable items which should not be accessible to end-users outside of the Issue Picker dropdown.
Only enable this setting if the described use-case fits your needs and JQL queries are set accordingly. Enabling otherwise might reveal Issue Summaries for users, which are not intended to see them. Contact support if you have questions.
Allow to select multiple Issues
Switches the Issue Picker Field between multi- and single select.
Add an Issue Link towards the selected Issue
When this setting is enabled, a Jira-native link of the selected link type is created between the current Issue and the selected Issue(s), after an Issue is selected in the Issue picker field.
This setting is not concerned with removing links when Issues are removed from the Issue Picker field (see below)!
Delete all Issue Links of selected Type when Issue is unselected from Issue Picker
When this setting is enabled, all Issue Links of the selected type (and link direction) are deleted when the Issue Picker field is saved. This deletes all links, no matter if they were created by Issue Picker or manually.
It makes sense to enable this in conjunction with the Add Link setting above, so that links remain set for the currently selected Issue.
We aim to improve the auto-linking feature, so that in the future only links that have been un-selected in Issue Picker will be removed. Stay tuned.
Show status of selected Issues
If this setting is enabled, the Status lozenge is shown next to selected Issues.
Show Issue Key of selected Issues
If this setting is enabled, the Issue Key is shown next to selected Issues.
Show Issue Count during edit
If this setting is enabled, the number if Issues that fit the JQL filter is shown below the drop-down when editing the value of an Issue Picker field (in the Edit Issue or create Issue view).