The search query was originally intended to reflect the design of the Zendesk search query syntax. The supported arguments and values was intended to be identical.
The query search might change away from the original copy of Zendesk supported search.
For now there is as set of supported arguments and a set non-supported arguments, as listed below
Current supported arguments
This is a list queries implemented into the test suite, expected to work
|
Valid Queries |
Note |
|---|---|
|
type:ticket report animal inside develop morning task |
Query words, against the description argument, in random order |
|
type:ticket "assignee :" "John Doe" |
|
|
type:ticket description:"unmatched quote \" match" |
Query contain unmatched quote character, but it is valid because the quote is escaped |
|
type:ticket "status=new" |
|
|
type:ticket subject:Analysis* |
|
|
type:ticket subject:*fly. |
|
|
type:ticket subject:*country* |
|
|
type:ticket subject:"*country and indeed*" |
|
|
type:ticket organization:"My Bakery" -tags:mytag |
|
|
type:ticket organization:none |
|
|
type:ticket organization:360166362552 |
ID of the organization |
|
type:ticket group:"Foo group" |
|
|
type:ticket group:360002862272 |
ID of the group |
|
type:ticket status>=solved |
|
|
type:ticket status:open |
|
|
type:ticket solved<2years |
|
|
type:ticket created:2019-02-01 |
|
|
type:ticket created<2019-02-01 |
|
|
type:ticket created>2019-02-01 |
|
|
type:ticket created>=2019-02-01 |
|
|
type:ticket created<=2019-02-01 |
|
|
type:ticket solved:2019-02-01 |
|
|
type:ticket solved<2019-02-01 |
|
|
type:ticket solved>2019-02-01 |
|
|
type:ticket solved>=2019-02-01 |
|
|
type:ticket solved<=2019-02-01 |
|
|
type:ticket updated:2019-02-01 |
|
|
type:ticket updated<2019-02-01 |
|
|
type:ticket updated>2019-02-01 |
|
|
type:ticket updated>=2019-02-01 |
|
|
type:ticket updated<=2019-02-01 |
|
|
type:ticket due_date:2019-02-01 |
|
|
type:ticket due_date<2019-02-01 |
|
|
type:ticket due_date>2019-02-01 |
|
|
type:ticket due_date>=2019-02-01 |
|
|
type:ticket due_date<=2019-02-01 |
|
|
type:ticket assignee:"John Doe" |
|
|
type:ticket assignee:john.doe@helphouse.io |
|
|
type:ticket assignee:none |
|
|
type:ticket requester:"John Doe" |
|
|
type:ticket requester:john.doe@helphouse.io |
|
|
type:ticket requester:none |
|
|
type:ticket subject:"delete account" |
|
|
type:ticket subject:"delete account*" |
|
|
type:ticket description:"delete account" |
|
|
type:ticket description:"delete account*" |
|
|
type:ticket status>solved |
|
|
type:ticket status:closed |
|
|
type:ticket status<solved |
|
|
type:ticket status<=solved |
|
|
type:ticket status>=solved |
|
|
type:ticket status>=solved status<new |
|
|
type:ticket status:solved status:new |
|
|
type:ticket status:pending status:open |
|
|
type:ticket status:pending status<open |
|
|
type:ticket status>open status<closed |
|
|
type:ticket status<closed status>open status:open |
|
|
type:ticket status<hold status:closed -status:open -status:pending |
|
|
type:ticket group:"Support" |
|
|
type:ticket organization:"helphouse.io" |
|
|
type:ticket tags:flex_sla1 |
|
|
type:ticket tags:flex_sla2 tags:no_csat2 |
|
|
type:ticket tags:"flex_sla21 flex_sla22" tags:"no_csat21 no_csat22" |
|
|
type:ticket tags:"flex_sla3 no_csat3" |
|
|
type:ticket status:pending -tags:invoice |
|
|
type:ticket status:pending tags:"invoice support" |
|
|
type:ticket status:pending tags:"-invoice support" |
|
|
type:ticket created>2014-08-01 created<2014-08-05 |
|
|
type:ticket updated>2014-08-01 updated<2014-08-05 |
|
|
type:ticket created>2014-08-01T11:59:00Z created<2014-08-05T00:00:00Z |
|
|
type:ticket solved>4hours |
|
|
type:ticket status<=solved description:"delete account" requester:"John Doe" |
|
|
type:ticket status:closed created<2016-01-01 |
|
|
type:ticket created>2015-09-01T12:00:00-08:00 |
|
|
type:ticket updated<2015-09-01T12:00:00Z |
|
|
type:ticket subject:"Contact 1*" subject:"*Contact 2*" subject:"*Contact 3*" |
|
Currently NOT support arguments
This is a list queries implemented into the test suite, expected NOT to work.
These queries we would some what want to work in the future.
|
Query with invalid arguments or values |
Note |
|---|---|
|
type:ticket closed:2019-02-01 |
|
|
type:ticket closed<2019-02-01 |
|
|
type:ticket closed>2019-02-01 |
|
|
type:ticket closed>=2019-02-01 |
|
|
type:ticket closed<=2019-02-01 |
|
|
type:ticket status:"solved -new" |
|
|
type:ticket status:solvedd |
|
|
type:ticket status<customstatus |
|
|
type:ticket ticket_type:problem |
|
|
type:ticket priority>low |
|
|
type:ticket priority:normal |
|
|
type:ticket priority<=normal |
|
|
type:ticket priority>=normal |
|
|
type:ticket via:phone |
|
|
type:ticket via:mail |
|
|
type:ticket via:closed_ticket |
|
|
type:ticket via:"any_channel" |
|
|
type:ticket fieldvalue:123456 |
|
|
type:ticket brand:Gert |
|
|
type:ticket brand:"Brandname1 Brandname2" |
|
|
type:ticket brand:"Brandname1" brand:"Brandname2" |
|
|
type:ticket cc:john.doe@helphouse.io |
|
|
type:ticket has_attachment:true |
|
|
type:ticket has_attachment:false |
|
|
type:ticket form:support |
|
|
type:ticket recipient:john.doe@helphouse.io |
|
|
type:ticket satisfaction:bad |
|
|
type:ticket satisfaction:badwithcomment |
|
|
type:ticket satisfaction:good |
|
|
type:ticket satisfaction:goodwithcomment |
|
|
type:ticket satisfaction:offered |
|
|
type:ticket closed:2019-02-01 tags:flex_sla |
|
|
type:ticket commenter:"Thomas" |
|
Non-supported syntax
This is a list of queries, implemented into the test suite, expected to fail caused by invalid syntax.
|
Queries with invalid syntax |
Note |
|---|---|
|
123 |
Query for ticket id is too specific and is not supported |
|
type:user |
|
|
type:ticket group: "Support" |
Query operator is surrounded by whitespace |
|
type:ticket assignee : "John Doe" |
Query operator is surrounded by whitespace |
|
type:ticket status=new |
|
|
type:ticket tags>flex_sla |
Expected to fail because value cannot be "greater than" |
|
type:ticket tags<flex_sla |
Expected to fail because value cannot be "less than" |
|
type:ticket assignee<"John Doe" |
Query assignee cannot be matched with a < operator |
|
type:ticket status:pending -tags:"-invoice support" |
Should fail because exclude is defined on the tags argument and tags value |
|
type:ticket description:"unmatched quote " match" |
Query contains unmatched quote character |
Comments
0 comments
Article is closed for comments.