Advanced searching - development fields reference
If you've linked your development tools to Jira, you can use even more parameters when performing a search. Adding development information to your JQL queries gives you more visibility of your development tools in Jira. So, you'll make better-informed decisions on your development and work, build a better, more reliable release pipeline, and deliver higher quality releases to your happy customers.
JQL is made up of clauses. In a clause, a field is followed by an operator. The operator is followed by one or more values or functions. The operator compares the value of the field on the left side with one or more values or functions on the right side. So, only valid results are retrieved by the clause. But you can't compare two fields in JQL.
To use development fields in your JQL queries, you can enter something like this when doing an advanced search:
fixVersion = 7.8.0 AND development[pullrequests].open > 0
This query will return all issues with the fix version 7.8.0 and open pull requests linked to them.
And what if you want to know how many builds are failing in your project? Try this query:
project = ABC AND development[builds].failing > 0
When using development fields for advanced search, you may see an error stating that the field doesn't exist or you don't have permission to view it. Learn more about this issue and how to resolve it in our knowledge base article.
Now, check the following development fields that can be used in JQL queries.
development[branches].all
Search for issues that have branches on Bitbucket instances.
Syntax | development[branches].all |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | None |
Examples |
|
development[builds].all
Search for issues that have builds on linked Bamboo instances.
Syntax | development[builds].all |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | None |
Examples |
|
development[builds].failing
Search for issues that have failed builds on linked Bamboo instances. Note that these issues may also have passed builds associated with them, so create your JQL query to exclude passed builds if that's what you require.
Syntax | development[builds].failing |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | None |
Examples | Find all issues with more than three failing builds: |
development[builds].passing
Search for issues that have passed builds on linked Bamboo instances. Note that these issues may also have failed builds associated with them, so create your JQL query to exclude failed builds if that's what you require.
Syntax | development[builds].passing |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | None |
Examples | Find all issues with more than one passed build: |
development[builds].status
Search for issues that have builds that have passed or failed on linked Bamboo instances.
Syntax | development[builds].failing |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | passed, failed |
Examples |
|
development[commits].all
Search for issues that have code commits on linked Bitbucket instances.
Syntax | development[commits].all |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | None |
Examples |
|
development[deployments].all
Search for issues that have successful and unsuccessful deployments on Bamboo instances.
Syntax | development[deployments].all |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | None |
Examples |
|
development[deployments].deployed
Search for issues that have successful deployments on linked Bamboo instances.
Syntax | development[deployments].deployed |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | None |
Examples | Find all issues with more than two successful deployments: |
development[deployments].environment
Search for issues that have deployments to a specific environment on linked Bamboo instances. The supported environment functions are set in the Bamboo instances by the instance admin and can vary.
Syntax | development[deployments].environment |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | The supported environment functions are set in the Bamboo instances by the instance admin and can vary. |
Examples | Find all issues with deployments to a production environment: |
development[pullrequests].all
Search for issues that have open or merged pull requests on linked Bitbucket instances.
Syntax | development[pullrequests].all |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | None |
Examples |
|
development[pullrequests].declined
Search for issues that have declined pull requests on linked Bitbucket instances. Note that this query will also return issues with merged pull requests.
Syntax | development[pullrequests].declined |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | None |
Examples | Find all issues with more than three declined pull requests: |
development[pullrequests].merged
Search for issues that have merged pull requests on linked Bitbucket instances. Note that this query will also return issues with declined requests.
Syntax | development[pullrequests].merged |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | None |
Examples | Find all issues with more than five merged pull requests: |
development[pullrequests].open
Search for issues that have open pull requests on linked Bitbucket instances.
Syntax | development[pullrequests].open |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | None |
Examples | Find all issues with more than two open pull requests: |
development[pullrequests].status
Search for issues that have open or merged pull requests on linked Bitbucket instances.
Syntax | development[pullrequests].status |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | None |
Examples |
|
development[reviews].all
Search for issues that have open or closed reviews on linked Crucible instances.
Syntax | development[reviews].all |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | None |
Examples |
|
development[reviews].open
Search for issues that have open reviews on linked Crucible instances.
Syntax | development[reviews].open |
---|---|
Field Type | TEXT |
Auto-complete | No |
Supported operators |
|
Unsupported operators |
|
Supported functions | None |
Examples | Find all issues with open reviews: |