Git Integration for Jira Self-Managed (Data Center/Server) Documentation

Contact Support
GitKraken Status  

JQL searching

The Git Integration for Jira app has added JQL operators and fields to query Jira using JQL and git context via the Jira search.

 

Enable/disable JQL search feature

Go to  Jira Administration ➜ Applications ➜ General settings.

This general setting allows administrators to enable/disable the JQL functions within the Git Integration for Jira app.

JQL field syntax

The Jira JQL has been extended as follows:

Criteria Name JQL Field Syntax Description Search Result Value Example
Git Commits Referenced gitCommitsReferenced is not empty
gitCommitsReferenced is empty
True for all issues referenced by a git commit
True for all issues not referenced by a git commit
True or “” (empty string)
Git Branch gitBranch in (Version-5.2, Version-5.3) True for all issues referenced by a git commit in branch Version-5.2 and branch Version-5.3 Version-5.2, Version-5.3

Examples:

gitBranch in (master) AND resolution = Unresolved
gitCommitsReferenced is not empty AND resolution = Unresolved

 

VERSION 4.28+ VERSION 5.1+

The gitCommitsReferenced field now additionally supports project filtering.

The resulting set in the response to the user’s request has not changed. The only difference is that, before, the project filter is applied only after the filter. Now, it is applied inside the filter as well.

See the JQL query with the project filter together with the gitCommitReferenced field below:

project = ISSUE_KEY AND gitCommitsReferenced is EMPTY

 

Exporting JQL search results

You can save the JQL search results to CSV, HTML, XML or Word via Export.

JQL searching will not work if more than 65,000 Jira issues have at least one git commit associated. For more detailed information, see Known issues – JQL searching limitation.

 


Prev: Reindexing

Next: Integration webhooks

Have feedback about this article? Did we miss something? Let us know!
On this page