Issue Selection

Enter the following information:

  • Remote Server: defaults to Default Local. You can select a Remote Jira Server once you have successfully configured it under the Admin Page Remote Servers

  • JQL: Enter a JQL query to limit the scope of the provided issues in the custom field's pull-down menu.

    In the JQL query, you can use variables in replacement syntax, e.g. $!fieldHelper.getValueAsString("components").

    Using this syntax, you can also query for metadata provided by the catworkx Project Metadata app.


    Use the "Test JQL" button to see the Issue Picker results for a specific issue.

    The Field Helper methods fieldHelper.getValueAsString()and $fieldHelper.getValueAsListOfString() are used to request values of system and custom fields within the JQL query. You also can request the value of other Issue Picker fields here and build cascading Issue Pickers.

    If you request another Issue Picker field, the current value of this Issue Picker field—as shown on the Edit screen—is used to initialize the dependent Issue Picker field. For other system and custom field types, the last saved value of the field is used.

    If you use Botron Configuration Manager for Jira, field IDs in the JQL will be correctly exported/imported in two cases: instances of cf[12345] and instances of customfield_12345 will be supported.

  • JQL User: (Optional) Enter a user account that is used to perform the JQL search.
  • Run search as Reporter: Check this option to perform a JQL search as the reporter user. Otherwise the current user is used.

  • Only if logged-in user is in group: Select one or more user groups that are allowed to run a search as reporter user.

    This option is evaluated if the "Run search as Reporter" option is checked.

    This feature is typically useful for Jira Service Desk agents.

  • Only if logged-in user is in project role: Select one or more project roles that are allowed to run a search as reporter user.

    This feature is typically useful for Jira Service Desk agents.

    This option is evaluated if the "Run search as Reporter" option is checked.

  • Only run search as reporter user if the logged-in user is in one of these project roles. A user only has to be member of either a group (see above) or a project role in order to gain this permission.
  • Selection Mode: Select if a single issue, multiple issues or no issues can be selected in the picker. Your selection determines the way, the custom field is displayed on the screens.
  • Popup Dialog: Select to add a "plus" icon next to a multi select Issue Picker field.

    When the icon is clicked, a dialog is displayed to help query issues.
  • Autoselect single value: Select if an option should be selected automatically, if it is the only one available.