高级搜索 - 关键字参考

此页面介绍用于高级搜索的关键词的信息。请参见高级搜索 - 关键字参考。

JQL 中的关键词是指可执行（或属于）以下任意操作的单词或短语：

• 将两个或多个子句连接在一起以形成复杂的 JQL 查询
• 改变一个或多个子句的逻辑
• 改变运算符的逻辑
• 在 JQL 查询中有明确的定义
• 执行可改变 JQL 查询结果的特定函数

AND

用于组合多个子句，允许您缩小搜索范围。

请注意，您可以使用括号来控制子句执行的顺序。

示例

• 查找“New office”项目中的所有活动事务：

  project = "New office" and status = "open"

• 查找指派给 jsmith 的所有紧急活动事务：

  status = open and priority = urgent and assignee = jsmith

• 查找特定项目中未指派给 jsmith 的所有事务：

  project = JRA and assignee != jsmith

• 查找特定发布（由多个项目的不同版本号组成）的所有事务：

  project in (JRA,CONF) and fixVersion = "3.14"

• 查找报告人和经办人都不是 Jack、Jill 或 John 的所有事务：

  reporter not in (Jack,Jill,John) and assignee not in (Jack,Jill,John)

^返回页首

OR

用于组合多个子句，允许您扩大搜索范围。

请注意，您可以使用括号来控制子句执行的顺序。

（注意：另请参见 IN，这种方式在搜索字段的多个值时更为便捷。）

示例

• 查找由 jsmith 或 jbrown 创建的所有事务：

  reporter = jsmith or reporter = jbrown

• 查找已到期或未设置到期日期的所有事务：

  duedate < now() or duedate is empty

^返回页首

NOT

用于对单个子句，或由括号括起来的（由多个子句构成的）复杂 JQL 查询进行取反操作，从而可以缩小搜索范围。

（注意：另请参见 NOT EQUALS ("!=")、DOES NOT CONTAIN ("!~")、NOT IN 和 IS NOT。）

示例

• 查找分配给除 jsmith 之外的任意用户的所有事务：

  not assignee = jsmith

• 查找不由 jsmith 或 jbrown 创建的所有事务：

  not (reporter = jsmith or reporter = jbrown)

^返回页首

EMPTY

用于搜索给定字段没有值的事务。另请参见 NULL。

请注意，EMPTY 只能与支持 IS 和 IS NOT 运算符的字段配合使用。要查看字段支持的运算符，请查看各个字段参考。

示例

• 查找不带 DueDate 的所有事务：

  duedate = empty

  或者

  duedate is empty

^返回页首

NULL

用于搜索给定字段没有值的事务。另请参见 EMPTY。

请注意，NULL 只能与支持 IS 和 IS NOT 运算符的字段配合使用。要查看字段支持的运算符，请查看各个字段参考。

示例

• 查找不带 DueDate 的所有事务：

  duedate = null

  或者

  duedate is null

^返回页首

ORDER BY

用于指定搜索结果将按哪些字段的值排序。

默认情况下，将使用字段自己的排序顺序。您可以通过指定升序（“asc”）或降序（“desc”）覆盖此设置。

示例

• 查找不带 DueDate 的所有事务，并按 CreationDate 排序：

  duedate = empty order by created 

• 查找不带 DueDate 的所有事务，先按 CreationDate 排序，再按 Priority（从最高到最低）排序：

  duedate = empty order by created, priority desc

• 查找不带 DueDate 的所有事务，先按 CreationDate 排序，再按 Priority（从最低到最高）排序：

  duedate = empty order by created, priority asc

^返回页首