How the Issue Picker Works from an End User's Perspective

Learn how end users interact with VIP.LEAN Issue Pickers in Jira Cloud. Covers when the picker is displayed, how issues are listed, and how to use the search function.

1. How Do End Users Pick Issues?

Required Jira Role: Jira Software User

1.1 When Is the Issue Picker Displayed for End Users?

The end user can utilize the Issue Picker under the following conditions:

  1. The Issue Picker is included in the create and/or transition and/or edit screen.
  2. The end user has permissions to create and edit the specific work item type.

To use the Issue Picker correctly in the transition screen, please activate the New Work Transition Experience.

__wf_reserved_inherit

1.2 How the Relevant Issues Are Listed in the Issue Picker

The list of issues that the end user can select is dynamically generated by the app:

  1. The app executes the Filter JQL as an admin and retrieves a list of issues.
  2. This list can be limited to the current project if configured accordingly.
  3. Initially, only the first batch of issues retrieved is displayed (subject to Atlassian's limitations).
  4. To view additional issues, the end user must click 'more'.

We assume that no end user will scroll through thousands of options. In such cases, the end user will likely use the search function to narrow down the results. Therefore, we have decided not to retrieve all options and provide a paging function (the behavior is similar to the standard field Fix Version/s). Fetching an extensive list of options could result in significant waiting times, especially when the option list is extensive.

__wf_reserved_inherit

1.3 How Can the End User Use the Search Function?

The end user can enter any text to narrow down the list of listed work items:

  1. Summary Search: The app searches for the entered text in the Summary field to retrieve a subset of the listed work items.
__wf_reserved_inherit
  1. Key Search: The app also searches for exact work item keys (a forecast search is planned to list STORY-1, STORY-10 through STORY-19 when STORY-1 is entered).
__wf_reserved_inherit

The search function of the app is based on the native search function of Atlassian, utilizing the JQL syntax. Therefore, the capabilities and limits are the same.

Jump to: