How do I use the "summary" field in JQL?

When I use "/rest/api/2/search?jql=summary="TRUE"" I get the error "operator '=' is not supported by the 'summary' field". When I use "/rest/api/2/search?jql=summary:"TRUE"" I get the error "Error in the JQL Query: Expecting operator but got 'TRUE'. The valid operators are '=', '!=', '<', '>', '<=', '>=', '~', '!~', 'IN', 'NOT IN', 'IS' and 'IS NOT'".

2 answers

1 vote
Joseph Clark Atlassian Team Aug 29, 2016

You can only use the ~ and !~ operators with the summary and description fields in JIRA.  These behave similar to the LIKE and NOT LIKE keywords in SQL, except that you can't specify wildcards.

Because the information from these fields is stored in the JIRA search index in a tokenized format, it's not possible to specify an exact match using the = operator.

 

Why is it when I use the "Advanced Rest Client Application" I can use this:

"http://localhost:8080/rest/api/2/search?jql:summary:TRUE" and get the summary data for all the issues assigned to me?

Sample:

 

{
"expand": "schema,names"
"startAt": 0
"maxResults": 50
"total": 6
"issues": 
[
6]
0:  
{
"expand": "operations,versionedRepresentations,editmeta,changelog,renderedFields"
"id": "10042"
"key": "TEST-43"
"fields": 
{
"issuetype": 
{
"id": "10001"
"description": "A task that needs to be done."
"name": "Task"
"subtask": false
"avatarId": 10318
}
-
"components": 
[
0]
"timespent": null

 

Suggest an answer

Log in or Sign up to answer
Atlassian Community Anniversary

Happy Anniversary, Atlassian Community!

This community is celebrating its one-year anniversary and Atlassian co-founder Mike Cannon-Brookes has all the feels.

Read more
Community showcase
Fadoua M. Boualem
Published 6 hours ago in Trello

Using Trello to manage events

As a Jira power user, I was at first doubtful that Trello could benefit my workflow. Jira already uses boards (ones you can customize!), so why would I even need to use Trello?! In this post you will...

250 views 4 4
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you