高级搜索
- 导航至 Issues(位于标题中)> Search for issues。
- 如果存在现有的搜索条件,则单击 New filter 按钮,以重置搜索条件。
如果显示的是基本搜索而不是高级本搜索,则单击 Advanced(位于
图标旁边)。
输入 JQL 查询。在您键入时,JIRA 将根据查询的上下文提供一系列“自动完成”建议。请注意,自动完成建议只包括前 15 个匹配,并按字母顺序显示,因此,如果找不到匹配项,您可能需要输入更多文本。
- 按 Enter 键或单击 以运行查询。搜索结果将在事务导航器中显示。
了解高级搜索
阅读以下主题,以了解如何充分利用高级搜索:
构建 JQL 查询
JQL 中的简单查询(又称为“子句”)包含一个字段,后跟一个运算符以及一个或多个值或函数。例如:
project = "TEST"
此查询将查找“TEST”项目中的所有事务。它使用了“project”字段、EQUALS 运算符以及 "TEST"
一值。
更复杂的查询可能如下所示:
project = "TEST" AND assignee = currentuser()
此查询将查找“TEST”项目中经办人为当前登录用户的所有事务。它使用了“project”字段、EQUALS 运算符、"TEST"
一值、“AND”关键词和“currentuser()”函数。
有关字段、运算符、关键词和函数的更多信息,请参见下文的"参考"部分。
设置运算符的优先级
您可以在复杂 JQL 语句中使用括号,来强制排定运算符的优先级。
例如,如果要查找“SysAdmin”项目中所有已解决的事务,以及当前指派给系统管理员 (bobsmith) 的所有事务(任何状态,任何项目),则可以使用括号来强制排定查询中布尔运算符的优先级,即
(status=resolved AND project=SysAdmin) OR assignee=bobsmith
请注意,如果不使用括号,则语句将从左到右求值。
您也可以使用括号来对子句分组,以便将 NOT 运算符应用于子句组。
受限单词和字符
保留字符
JQL 有一系列保留字符:
space (" ") | + | . | , | ; | ? | | | * | / | % | ^ | $ | # | @ | [ | ] |
如果您希望在查询中使用这些字符,则需要执行以下操作:
- 用引号包围它们(您可以使用单引号 (
'
) 或双引号 ("
));
此外,如果您正在搜索某文本字段,而字符位于文本搜索的保留字符列表中, - 则在它们之前使用两个反斜杠。
例如:
version = "[example]"
summary ~ "\\[example\\]"
保留单词
JQL 也有一系列保留单词:如果您希望在查询中使用这些单词,则需要使用引号(单引号或双引号)来包围它们。
JIRA 管理员请注意:此列表已硬编码在 JqlStringSupportImpl.java
文件中。
执行文本搜索
使用 CONTAINS 运算符对以下字段执行搜索时,可以使用 Lucene 的文本搜索功能:
Summary、Description、Environment、Comments、使用“自由文本搜索器”的自定义字段(即具有以下内置自定义字段类型的自定义字段:Free Text Field、Text Field、Read-only Text Field)。
有关更多信息,请参见文本字段的搜索语法。
参考
说明 | 参考 | |
---|---|---|
字段 | JQL 中的字段是指表示 JIRA 字段(或 JIRA 中已定义的自定义字段)的单词。 | |
运算符 | JQL 中的运算符是一个或多个符号或单词,它可将其左侧字段的值与右侧的一个或多个值(或函数)进行比较,从而使子句仅返回比较结果为真的那些事务。 一些运算符可能会使用 NOT 关键词。 | |
关键词 | JQL 中的关键词是指可执行(或属于)以下任意操作的单词或短语:
| |
函数 | JQL 中的函数显示为一个字,后跟括号,其中可能包含一个或多个显式值或 JIRA 字段。 函数对括号中的特定 JIRA 数据或函数内容执行计算,以使函数仅返回真值结果,进而使得调用该函数的子句也返回真值的结果。 |