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 votes
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 Join to answer
Community showcase
Teodora [Botron]
Published Thursday in Marketplace Apps

Jira Inferno: The Nine Circles of Jira Administration Hell

If you spend enough time as a Jira admin - whether you are managing a single, mid-sized instance, a large enterprise one or juggling multiple instances at once - you will eventually find yourself in ...

661 views 4 15
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
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot