Apps documentation
Extension for Jira Service Management
Cloud Server/Data Center
Extension for Jira Service Management

Cloud

Server/Data Center

Documentation
FAQ
Release notes
Articles & Videos
Last updated May 9, 2022

Bundled Fields Searcher

Learn how to search for issues that contain Bundled Fields

Extension for Jira Service Management provides a dedicated searcher. It allows for searching Jira issues that contain the Bundled Fields custom field. You can build queries using either two or three parameters. The syntax should be built as follows:

  • issue in bundledFieldsEx("", "")
  • issue in bundledFieldsEx("", "", "")
Note

Remember to always put query parameters in straight quotation marks (either " " or ' ').

Queries with two parameters

Use the following syntax to search using two parameters:

issue in bundledFieldsEx("", "")

Examples

Syntax with details Example Description
issue in bundledFieldsEx("customfield_name", "subfield_value") issue in bundledFieldsEx("Address", "Poland") Returns all issues that contain an Address custom field where one subfield value is Poland.
issue in bundledFieldsEx("Address", "") Returns all issues that contain an Address custom field where min. one subfield value is empty.
issue in bundledFieldsEx("customfield_id", "subfield_value") issue in bundledFieldsEx("customfield_10301", "Poland") Returns all issues that contain a custom field with the ID = customfield_10301 (in this case: Address) where one subfield value is Poland.
issue in bundledFieldsEx("customfield_10301", "") Returns all issues that contain a custom field with the ID = customfield_10301 (in this case: Address) where min. one subfield value is empty.
issue in bundledFieldsEx("id", "subfield_value") issue in bundledFieldsEx("10301", "Poland") Returns all issues that contain a custom field with the ID = 10301 (in this case: Address) where one subfield value is Poland.
issue in bundledFieldsEx("10301", "") Returns all issues that contain a custom field with the ID = 10301 (in this case: Address) where min. one subfield value is empty.

Queries with three parameters

Use the following syntax to search using three parameters:

issue in bundledFieldsEx("", "", "")

Examples

Syntax with details Example Description
issue in bundledFieldsEx("customfield_name", "subfield_name", "subfield_value") issue in bundledFieldsEx("Address", "Country", "Poland") Returns all issues that contain an Address custom field with a Country subfield (which value is Poland).
issue in bundledFieldsEx("customfield_name", "subfield_name", "") issue in bundledFieldsEx("Address", "Country", "") Returns all issues that contain an Address custom field where the Country subfield’s value is empty.
issue in bundledFieldsEx("customfield_id", "subfield_name", "subfield_value") issue in bundledFieldsEx("customfield_10301", "Country", "Poland") Returns all issues that contain a custom field with ID = 10301 (in this case: Address) with a Country subfield (which value is Poland).
issue in bundledFieldsEx("customfield_id", "subfield_name", "") issue in bundledFieldsEx("customfield_10301", "Country", "") Returns all issues that contain a custom field with ID = 10301 (in this case: Address) where the Country subfield’s value is empty.
issue in bundledFieldsEx("id", "subfield_name", "subfield_value") issue in bundledFieldsEx("10301", "Country", "Poland") Returns all issues that contain a custom field with ID = 10301 (in this case: Address) with a Country subfield (which value is Poland).
issue in bundledFieldsEx("id", "subfield_name", "") issue in bundledFieldsEx("10301", "Country", "") Returns all issues that contain a custom field with ID = 10301 (in this case: Address) where the Country subfield’s value is empty.
Tip

To find an ID of a Bundled Field custom field, go to Issues > Custom Fields. Select the custom field, click Edit, and check the URL address.

Example: http://192.168.0.84:8082/secure/admin/EditCustomField!default.jspa?id=10301

NOT_EMPTY, IN, NOT_IN

You can also search using JQL operators described below.

Examples

Operator Example Description
NOT_EMPTY issue in bundledFieldsEx("Bundled Field 1 (Ex)", "Last name", "NOT_EMPTY") Returns all issues with subfields that are not empty.
IN issue in bundledFieldsEx("Bundled Field 1 (Ex)", "Select field", "IN", "One", "Two") Returns all issues with subfields that contain given values. (Only for subfields of the select type)
NOT_IN issue in bundledFieldsEx("Bundled Field 1 (Ex)", "Select field", "NOT_IN", "One", "Two") Returns all issues with subfields that don’t contain given values. (Only for subfields of the select type)

Date and Date Time

You can also search by Date and Date Time subfields. Use the following patterns:

  • yyyy-MM-dd hh:mm a
  • yyyy-MM-dd
  • hh:mm a

Examples

Operator Example
< issue in bundledFieldsEx("Bundled Field 1 (Ex)", "Date","<","2019-04-30")
issue in bundledFieldsEx("Bundled Field 1 (Ex)", "Date Time","<","2019-04-30 10:01 am")
issue in bundledFieldsEx("Bundled Field 1 (Ex)", "Time","<","08:15 am")
> issue in bundledFieldsEx("Bundled Field 1 (Ex)", "Date",">","2019-04-29")
issue in bundledFieldsEx("Bundled Field 1 (Ex)", "Date Time",">","2019-04-30 09:55 am")
issue in bundledFieldsEx("Bundled Field 1 (Ex)", "Time",">","08:15 am")
BETWEEN issue in bundledFieldsEx("Bundled Field 1 (Ex)", "Date","BETWEEN","2019-04-29","2019-04-31")
issue in bundledFieldsEx("Bundled Field 1 (Ex)", "Date Time","BETWEEN","2019-04-30 09:50 am","2019-04-30 10:10 am")
issue in bundledFieldsEx("Bundled Field 1 (Ex)", "Time","BETWEEN","08:13 am","08:15 am")

User Picker

You can search through subfields of the User Picker type. Use either the username or the full name of the user (practically it’s the same query).

Examples

Syntax with details Example Description
issue in bundledFieldsEx("customfield_name", "subfield_name", "full_name") issue in bundledFieldsEx("General information", "Project lead", "John Smith") Returns all issues that contain a subfield of the User Picker type (in this case “Project lead”) that contains the user John Smith (jsmith).
issue in bundledFieldsEx("customfield_name", "subfield_name", "username") issue in bundledFieldsEx("General information", "Project lead", "jsmith") Returns all issues that contain a subfield of the User Picker type (in this case “Project lead”) that contains the user John Smith (jsmith).

Troubleshooting

If you do not see issues that contain the Bundled Fields custom field, go to the Issues > Custom Fields. Select custom field, click Edit and check Search Template. Bundled Fields Searcher should be set.

Bundled Fields
Bundled Field searcher
Need help?

If you can’t find the answer you need in our documentation, raise a support request.
Include as much information as possible to help our support team resolve your issue faster.