- Introduction
- About
- Get started
- Functionalities
- Fields Visibility
- Translations
- Tabs Visibility
- Mapper
- Secured Fields
- Supported fields
- Bundled Fields
- Overview
- Add Bundled Field
- Bundled Fields Configuration
- Using Bundled Fields
- JQL Searcher
- Java API (ScriptRunner)
- Data Sources
- Email notifications
Bundled Fields Searcher
Learn how to search for issues that contain Bundled Fields
Dynamic Forms 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 bundledFieldsDF("", "")issue in bundledFieldsDF("", "", "")
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 bundledFieldsDF("", "")
Examples
| Syntax with details | Example | Description |
|---|---|---|
issue in bundledFieldsDF("customfield_name", "subfield_value") |
issue in bundledFieldsDF("Address", "Poland") |
Returns all issues that contain an Address custom field where one subfield value is Poland. |
issue in bundledFieldsDF("Address", "") |
Returns all issues that contain an Address custom field where min. one subfield value is empty. | |
issue in bundledFieldsDF("customfield_id", "subfield_value") |
issue in bundledFieldsDF("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 bundledFieldsDF("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 bundledFieldsDF("id", "subfield_value") |
issue in bundledFieldsDF("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 bundledFieldsDF("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 bundledFieldsDF("", "", "")
Examples
| Syntax with details | Example | Description |
|---|---|---|
issue in bundledFieldsDF("customfield_name", "subfield_name", "subfield_value") |
issue in bundledFieldsDF("Address", "Country", "Poland") |
Returns all issues that contain an Address custom field with a Country subfield (which value is Poland). |
issue in bundledFieldsDF("customfield_name", "subfield_name", "") |
issue in bundledFieldsDF("Address", "Country", "") |
Returns all issues that contain an Address custom field where the Country subfield’s value is empty. |
issue in bundledFieldsDF("customfield_id", "subfield_name", "subfield_value") |
issue in bundledFieldsDF("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 bundledFieldsDF("customfield_id", "subfield_name", "") |
issue in bundledFieldsDF("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 bundledFieldsDF("id", "subfield_name", "subfield_value") |
issue in bundledFieldsDF("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 bundledFieldsDF("id", "subfield_name", "") |
issue in bundledFieldsDF("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. |
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 bundledFieldsDF("Bundled Field 1 (DF)", "Last name", "NOT_EMPTY") |
Returns all issues with subfields that are not empty. |
| IN | issue in bundledFieldsDF("Bundled Field 1 (DF)", "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 bundledFieldsDF("Bundled Field 1 (DF)", "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 bundledFieldsDF("Bundled Field 1 (DF)", "Date","<","2019-04-30") |
issue in bundledFieldsDF("Bundled Field 1 (DF)", "Date Time","<","2019-04-30 10:01 am") |
|
issue in bundledFieldsDF("Bundled Field 1 (DF)", "Time","<","08:15 am") |
|
| > | issue in bundledFieldsDF("Bundled Field 1 (DF)", "Date",">","2019-04-29") |
issue in bundledFieldsDF("Bundled Field 1 (DF)", "Date Time",">","2019-04-30 09:55 am") |
|
issue in bundledFieldsDF("Bundled Field 1 (DF)", "Time",">","08:15 am") |
|
| BETWEEN | issue in bundledFieldsDF("Bundled Field 1 (DF)", "Date","BETWEEN","2019-04-29","2019-04-31") |
issue in bundledFieldsDF("Bundled Field 1 (DF)", "Date Time","BETWEEN","2019-04-30 09:50 am","2019-04-30 10:10 am") |
|
issue in bundledFieldsDF("Bundled Field 1 (DF)", "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 bundledFieldsDF("customfield_name", "subfield_name", "full_name") |
issue in bundledFieldsDF("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 bundledFieldsDF("customfield_name", "subfield_name", "username") |
issue in bundledFieldsDF("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.
If you can’t find the answer you need in our documentation, raise a support request.
