logo JIRA使用教程 我也要发布文档

高级搜索


什么是高级搜索?

高级搜索可以让你使用结构化查询搜索JIRA问题。搜索结果将显示在问题导航器,你可以将其导出到MS Excel等多种格式。你还可以保存和订阅你的高级搜索。
当你执行高级搜索时,你是用的是JIRA搜索语言(JQL)。JQL简单查询(也称为一个“语句”)包括一个字段,包括一个运算符、一个或多个值或功能。例如,下面的简单的查询会搜索在“TEST”项目中的所有问题:
project = "TEST"
这个例子使用Project字段,EQUALS 运算符以及"TEST"值。
(info)JQL提供一些类似于SQL的语法,比如ORDER BY SQL关键字和ISNULL()SQL函数。然而,JQL不是数据库查询语言。例如,JQL不具有SELECT语句。

如何执行高级搜索

  1. 选择Issues > Search for Issues将出现问题导航界面。
    • 如果有现有的搜索条件,请单击New filter按钮复位搜索条件。
    • 如果Advanced是以链接显示,点击该链接切换到高级搜索。
  2. 使用字段、运算符、字段值或函数输入查询条件。
  3. 点击Search按钮执行查询。

执行文本搜索

当在以下字段执行搜索时,可以使用Lucene的文本搜索功能的CONTAINS运算符:

  • Summary
  • Description
  • Environment
  • Comments
  • custom 字段采用“自由文本搜索器”,包括以下内置自定义字段类型:
    • Free Text Field (无限制文本)
    • Text Field (< 255字节)
    • Read-only Text Field

在JQL中使用文本字段的"some words"值搜索问题。这会搜索所有文本自定义字段如总结、描述、环境、评论。如果你有很多文本自定义字段,你可以通过搜索特定的字段来改进搜索,例如:
Summary ~ "some words" OR Description ~ "some words"

使用自动填写功能

当你在输入查询条件时,JIRA会自动识别上下文并提供一个自动填写推荐列表。自动填写推荐列表按字母顺序排列,包括前15个匹配值。注意自动填写推荐不提供函数参数。
(info)注意:
如果自动填写推荐没有出现,可能是因为你的管理员关闭了JIRA实例的该功
自动填写推荐不会出现在所有字段。点击字段参考查看那些字段支持自动填写。

在高级搜索和简单搜索之间切换

通常情况下,使用“简单搜索”创建查询可能会被转换成“高级搜索”(JQL),然后再简单查询查询。
然而,使用“高级搜索”创建查询就不会被转换成“简单搜索”,特别是当:

  • 查询包含OR运算符(注意你可以使用IN运算符,但它将被转换,例如:project in (A, B))
    • 例:尽管(project = JRA OR project = CONF)查询等同于(project in (JRA, CONF)),但只有第二个查询会被转换
  • 查询包含NOT运算符
  • 查询包含EMPTY运算符
  • 查询包含任何!=, IS, IS NOT, >, >=, <, <=运算符
  • 查询指定相关项目中的字段和值(如版本,组成,自定义字段),并且该项目没有明确包括在查询中(如fixVersion=“4.0”,没有AND project=JRA)。这些自定义字段特别棘手,因为它们可以在一个项目/问题类型的基础上进行配置。一般的经验规则是,如果该查询不能在“简单搜索”的形式创建,那么如果使用“高级搜索”创造该查询,那么该查询将不会被转换成'简单搜索'。

设置运算符优先

你可以通过使用括号来强调JQL语句中运算符的优先级。例如,如果你想查找SysAdmin项目中所有被解决的问题,以及目前被分配给系统管理员(bobsmith)的问题。你可以在你的查询中使用括号强制执行布尔运算符的优先级,即:
tatus=resolved AND project=SysAdmin) OR assignee=bobsmith
需要注意的是,如果你不使用括号,该语句将使用运算符优先级评估。你还可以使用括号来组合语句,这样就可以将NOT运算符应用于组。
(info)如果你添加括号强制符的优先级,但他们没有严格要求的运算符优先级执行但返回相同的结果,当你保存查询时JIRA会删除你查询语句里面的优先级。

相关产品购买请咨询"在线客服"。