本页面的内容:
什么是高级搜索?
通过高级搜索,你可以使用结构化查询语言搜索JIRA的问题。 搜索的结果会显示在 问题导航器中, 然后你可以将搜索结果输出为 MS Excel格式 以及 其他格式。 你还可以 保存 以及 订阅搜索结果。
查询语句由一个 字段, 运算符, 和 值 或 _函数_构成。 例如, 下面的查询语句将返回 "TEST"项目的所有问题:
(这个例子使用了 项目(project) 字段, 等于 符号, 和 值 "TEST"
。)
注意不能比较两个 字段。
当你执行高级搜索时, 你使用的是JIRA查询语言(JQL)。 JQL类似SQL表达式, 比如 #> 和 #NULL。 当然, 你不能使用数据库查询语言; 例如, JQL不能使用 SELECT
表达式。
如何使用高级搜索
- 点击顶部导航菜单栏的'问题'标签链接。会显示 搜索页面。
- 点击 "高级"搜索模式链接。会显示 "查询" 框:
- 使用下面描述的 字段, 运算符 和值或函数,书写查询语句。
- 点击"搜索" 按钮执行查询语句。
关键字
内容区目录 |
---|
maxLevel | 4 |
---|
minLevel | 4 |
---|
location | top |
---|
type | list |
---|
|
与 AND 用于整合多个查询条件, 允许你精炼查询条件。 注意,你可以使用 括号 来控制查询条件的执行顺序。 示例 - 查询"New office"项目中所有开放的问题:
代码块 |
---|
project = "New office" and status = "open" |
- 查询所有分配给jsmith的紧急的开放问题:
代码块 |
---|
status = open and priority = urgent and assignee = jsmith |
- 查询JRA项目中没有分配给jsmith的问题:
代码块 |
---|
project = JRA and assignee != jsmith |
- 查找JRA和CONF项目中修复版本是3.14的问题:
代码块 |
---|
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 用于否定一个运算符或整个查询条件, 允许你优化查询条件。 注意,你可以使用 括号 来控制查询条件的执行顺序。 (注意: 请参阅 不等于 ("!="), 不包括 ("!~"), 不再...之中 和 不是章节) 示例 - 搜索经办人不是jsmith的所有问题:
- 搜索所有报告人不是jsmith或不是jbrown的问题:
代码块 |
---|
not (reporter = jsmith or reporter = jbrown) |
空 EMPTY 用于搜索没有值的字段。 请参阅 空(NULL)。 注意 EMPTY 只能与 是(IS) 和 不是(IS NOT) 运算符结合使用。 要查看字段支持的运算符, 点击 #字段 。 示例 空 NULL 用于搜索字段没有赋值的问题。 请查看 空(EMPTY)。 注意 NULL 只能用于支持 是(IS) 和 不是(IS NOT) 操作符的字段。 要了解字段支持哪些操作符, 请查看每个 字段 参考。 示例 排序 ORDER BY 用于对输出的结果,按照指定的字段排序。 默认情况下, 按照字段输出顺序排序。 你可以指定按照升序 ("asc ") 或降序 ("desc ")排列。 示例 |
运算符参考
内容区目录 |
---|
maxLevel | 4 |
---|
minLevel | 4 |
---|
location | top |
---|
type | list |
---|
|
等于: = "= " 运算符用于查找精确匹配字段值的问题。 (注意: 不能用于 文本 字段; 文本字段的匹配条件请使用 包含 运算符。) 要精确匹配多个字段值,请使用与(AND)将多个 "= " 表达式连接起来。 示例 - 查找由jsmith创建的所有问题:
- 查找由John Smith创建的所有问题:
代码块 |
---|
reporter = "John Smith" |
不等于: != "!= " 运算符用于查找不等于指定字段值之外的问题。 (注意: 不能用于 文本 字段; 文本字段的否定条件请使用 不包含 ("!~ ") 运算符。) 注意输入 field != value 与输入 NOT field = value}}具有同等效果, 并且 {{field != EMPTY 与 {{field #IS_NOT EMPTY}}也具有同等效果。 示例 - 查找所有已经被分配经办人,但是经办人不是jsmith的问题: or:
- 查找报告人不是jsmith的所有问题:
- 查找你报告的,但经办人没有被分配给你的问题:
代码块 |
---|
reporter = currentUser() and assignee != currentUser() |
- 查找已经被分配经办人,但报告人或经办人不是John Smith的问题:
代码块 |
---|
assignee != "John Smith" or reporter != "John Smith" |
- 查找所有还没有分配经办人的问题: 或
大于: > "> " 运算符用于差咋后比指定字段值大的问题。 不能用于 文本 字段。 注意 "> " 运算符只能用于支持排序的字段 (例如 日期字段和版本字段等)。 要了解字段支持哪些运算符, 请查看每个 字段 参考。 示例 - 查找所有投票数大于4的问题:
- 查找所有逾期未解决的问题:
代码块 |
---|
duedate < now() and resolution is empty |
- 查找所有优先级高于 "Normal"的问题:
锚 |
---|
| GREATER_THAN_EQUALS |
---|
| GREATER_THAN_EQUALS |
---|
|
大于等于: >= ">= " 运算符用于查找大于等于指定字段值的问题。不能用于 文本 字段。 注意 ">= " 运算符只能用于支持排序的字段 (例如 日期字段和版本字段等)。 要了解字段支持哪些运算符, 请查看每个 字段 参考。 示例 - 查找所有投票数大于等于 4 的问题:
- 查找到期日大于等于 31/12/2008 的问题:
代码块 |
---|
duedate >= "2008/12/31" |
- 查找过去5天内创建的问题:
小于: < The "< " 运算符用于搜索小于指定字段值的问题。 不能用于 文本 字段。 注意"< " 运算符只能用于支持排序的字段 (例如 日期字段和版本字段等)。 要了解字段支持哪些运算符, 请查看每个 字段 参考。 示例 锚 |
---|
| LESS_THAN_EQUALS |
---|
| LESS_THAN_EQUALS |
---|
|
小于等于: <= The "<= " 运算符用于搜索小于等于指定字段值的问题。 不能用于 文本 字段。 注意 "<= " 运算符只能用于支持排序的字段 (例如 日期字段和版本字段等)。 要了解字段支持哪些运算符, 请查看每个 字段 参考。 示例 - 查找所有投票数小于等于 4的问题:
- 查找过去一个月(30天)内没有更新的问题:
在...之内 IN "IN " 运算符用于查找多个指定字段值的问题。 多个值之间用逗号分隔, 用括号括起来。 使用 "IN " 运算符相当于多个 #EQUALS (=) 表达式, 但是使用起来更方便,更简短。 也就是说, 输入 reporter IN (tom, jane, harry) 与输入 {{reporter = "tom" #OR reporter = "jane" #OR reporter = "harry"}}具有同等效果。 示例 - 查找报告人是jsmith或jbrown或jjones的所有问题:
代码块 |
---|
reporter in (jsmith,jbrown,jjones) |
- 查找所有报告人或经办人是Jack或Jill的所有问题:
代码块 |
---|
reporter in (Jack,Jill) or assignee in (Jack,Jill) |
- 查找影响版本是3.14 或 4.2的问题:
代码块 |
---|
affectedVersion in ("3.14", "4.2") |
不在...之内 NOT IN "NOT IN " 运算符用于排除多个指定字段值的问题。 使用 "NOT IN " 运算符相当于多个 #NOT_EQUALS (!=) 表达式, 但是使用起来更方便,更简短。也就是说,输入 reporter NOT IN (tom, jane, harry) 与输入 {{reporter != "tom" #AND reporter != "jane" #AND reporter != "harry"}}具有相同的效果。 示例 - 查找所有报告人不是Jack或不是Jill或不是John的问题:
代码块 |
---|
reporter not in (Jack,Jill,John) |
- 查找修复版本不是 'A', 'B', 'C' 或不是 'D'的问题:
代码块 |
---|
FixVersion not in ( A, B, C, D) |
- 查找修复版本不是'A', 'B', 'C' 或不是 'D'的问题, 或者没有指定修复版本值的问题:
代码块 |
---|
FixVersion not in ( A, B, C, D) or FixVersion is empty |
包含: ~ "~ " 运算符用于匹配指定字段值的问题 (也可以使用精确匹配或 "模糊" 匹配 — 查看下面的示例)。 只能用于文本字段, 例如: 包含页面 |
---|
| quickstart:__JQL Text Fields |
---|
| quickstart:__JQL Text Fields |
---|
nopanel | true |
---|
|
注意: 使用 "~ " 运算符, 在运算符右侧的字段值可以使用 JIRA 文本搜索语法。 示例 - 查找主题中包括"full screen"词组的问题:
代码块 |
---|
summary ~ "\"full screen\"" |
- 查找主题中包括 "win"单词 (或其衍生单词, 比如 "windows" 或 "winning")的问题:
锚 |
---|
| DOES_NOT_CONTAIN |
---|
| DOES_NOT_CONTAIN |
---|
|
不包括: !~ "!~ " 运算符用于模糊匹配不包含指定字符的问题。 只能用于文本字段, 例如: 包含页面 |
---|
| quickstart:__JQL Text Fields |
---|
| quickstart:__JQL Text Fields |
---|
nopanel | true |
---|
|
注意: 使用 "!~ " 运算符, 在运算符右侧的字段值可以使用 JIRA 文本搜索语法。 示例 - 查找主题中不包括 "run"单词的问题 (或其衍生单词, 比如 "running" 或 "ran"):
是 IS "IS " 运算符只能与 空(EMPTY) 或 空(NULL)结合使用。 也就是说搜索指定字段没有赋值的问题。 注意不是所有的 字段 都可以使用这个运算符; 分别查看所有的 字段 参考了解具体用法。 示例 不是 IS NOT "IS NOT " 运算符只能与 空(EMPTY) 或 空(NULL)结合使用。也就是说搜索指定字段已经被赋值的问题。 注意不是所有的 字段 都可以使用这个运算符; 分别查看所有的 字段 参考了解具体用法。 示例 |
字段参考
内容区目录 |
---|
maxLevel | 4 |
---|
minLevel | 4 |
---|
location | top |
---|
type | list |
---|
|
锚 |
---|
| affectedVersion |
---|
| affectedVersion |
---|
|
锚 |
---|
| AffectedVersion |
---|
| AffectedVersion |
---|
|
影响版本搜索指定影响版本的问题。 你可以按照版本名称或版本ID(JIRA自动为版本分配的数值)搜索 。 信息 |
---|
title | 按照版本ID搜索比按照版本名称搜索更准确 |
---|
| 不同的项目可能有相同名称的版本, 所有按照版本名称搜索可能会搜索到多个项目的问题。 当JIRA管理员更改版本的名称, 会使依赖版本名称的 过滤器 失效。 Version ID是唯一且无法修改的。 |
注意: 这个字段支持 自动完成。 语法 字段类型 版本 VERSION 支持的操作符 包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
nopanel | true |
---|
|
注意比较运算符 (如 ">") 使用 版本排序 只按照JIRA管理员设置的顺序, 而不按照数值或字母顺序。 支持的函数 当使用 在...之内(IN) 和 不在...之内(NOT IN) 运算符时, affectedVersion 支持: 示例 - 查找影响版本是 3.14的问题:
代码块 |
---|
affectedVersion = "3.14" | (注意点(.)是保留 #字符, 所以你需要用引号括起来。) - 查找影响版本是"Big Ted"的问题:
代码块 |
---|
affectedVersion = "Big Ted" |
- 查找影响版本ID是 10350的问题:
代码块 |
---|
affectedVersion = 10350 |
经办人搜索经办人是指定用户的问题。 你可以使用用户全名、ID或电子邮件地址。 注意: 这个字段支持 自动完成。 语法 字段类型 用户 USER 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
nopanel | true |
---|
| 支持的函数 当使用 #IN 和 #NOT_IN 运算符时, assignee 支持: 当使用 等于 和 不等于 运算符时, assignee 支持: 示例 - 搜索分配给John Smith的问题:
代码块 |
---|
assignee = "John Smith" | 或 - 搜索经办人邮件地址是 "bob@mycompany.com"的问题:
代码块 |
---|
assignee = "bob@mycompany.com" | (注意句号(.)和 "@" 符号是保留 #字符, 所以需要用引号将邮件地址括起来。)
类别 搜索属于指定项目类别的项目下的所有问题。 注意: 这个字段支持 自动完成。 语法 字段类型 类别 CATEGORY 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例
备注 搜索备注中包含指定字符的问题。 可以使用JIRA 文本搜索语法 。 注意: 这个字段不支持 自动完成。 语法 字段类型 文本 TEXT 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Fields (excluding IS) |
---|
| quickstart:__JQL Operators supported by Text Fields (excluding IS) |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 - 模糊搜索备注中包含 "My PC is quite old"字符的问题:
代码块 |
---|
comment ~ "My PC is quite old" |
- 精确搜索备注中包含 "My PC is quite old"的问题:
代码块 |
---|
comment ~ "\"My PC is quite old\"" |
模块 搜索一个项目中的指定 模块的问题。 你可以按照模块名称或模块ID (JIRA自动分配给模块的数字)搜索。 信息 |
---|
| 不同的项目可能有相同的模块名称, 所以按照模块名称搜索可能会返回多个项目的问题。 JIRA管理员一旦修改了模块名称, 以模块名称为条件的 过滤器将无法使用。 模块ID是唯一且不能修改的。 |
注意: 这个字段支持自动完成。 语法 字段类型 模块 COMPONENT 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
nopanel | true |
---|
| 支持的函数 当使用 在...之内(IN) 和 不在...之内(NOT IN) 运算符时, component 支持: 示例 - 查找模块是 "Comp1" 或 "Comp2" 的问题:
代码块 |
---|
component in (Comp1, Comp2) |
- 查找模块是 "Comp1" 并且 也是"Comp2" 的问题:
代码块 |
---|
component in (Comp1) and component in (Comp2) | 或 代码块 |
---|
component = Comp1 and component = Comp2 |
- 查找模块ID是 20500的问题:
创建日期按照指定的创建日期范围搜索问题。 包含页面 |
---|
| quickstart:__JQL Date Formats |
---|
| quickstart:__JQL Date Formats |
---|
nopanel | true |
---|
|
注意: 这个字段不支持 自动完成。 语法 或者: 字段类型 日期 DATE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
nopanel | true |
---|
| 支持的函数 当使用 等于, 不等于, 大于, 大于等于, 小于 或 小于等于 运算符时, createdDate 支持: 示例 - 查找2008年12月12日 00:00之前创建的问题(包括00:00):
代码块 |
---|
created <= "2008/12/12" |
- 查找1天以前创建的问题:
- 查找2009年1月创建的问题:
代码块 |
---|
created > "2008/12/31" and created < "2009/02/01" |
- 查找2009年1月15日创建的问题:
代码块 |
---|
created > "2009/01/14" and created < "2009/01/16" |
自定义字段只有当JIRA管理员已经创建了 自定义字段才有效 按照指定自定义字段值查找问题。 你可以按照自定义字段名称或自定义字段ID(JIRA自动为自定义字段分配的数值)搜索。 信息 |
---|
title | 搜索自定义字段ID比搜索自定义字段名称更准确 |
---|
| JIRA中自定义字段名称可能会与系统字段名称相同, 这种情况下,如果按照自定义字段名称搜索,JIRA只会搜索系统个字段,而不搜索自定义字段。 一旦JIRA管理员修改了自定义字段名称, 以自定义字段名称为搜索条件的 过滤器 将无法工作。自定义字段ID是唯一且无法修改的。 |
注意: - JIRA文本搜索语法 可以用于'文本'类型的自定义字段。
- 自动完成 支持选择器类型、用户组选择器类型, 选择列表类型 (不包括 '级联选择类型'), 复选框类型和单选按钮类型的自定义字段。
语法 或者: 字段类型 依赖于自定义字段的配置。 支持的运算符 不同类型的自定义字段支持不同的 运算符。 对于默认的自定义字段, 支持下面的运算符: - 数值和日期/时间类型字段:
包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
nopanel | true |
---|
|
- 选择器, 选择列表, 复选框和单选按钮类型字段:
包含页面 |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
nopanel | true |
---|
|
- 文本类型字段:
包含页面 |
---|
| quickstart:__JQL Operators supported by Text Fields |
---|
| quickstart:__JQL Operators supported by Text Fields |
---|
nopanel | true |
---|
|
支持的函数 不同类型的自定义字段支持不同的 函数。 对于默认的自定义字段, 支持下面的函数: 示例 - 查找自定义字段 "Location" 的值为 "New York"的问题:
- 查找自定义字段ID 10003的值为"New York"的问题:
代码块 |
---|
cf[10003] = "New York" |
- 查找自定义字段"Location"的值为 "London" 或 "Milan" 或 "Paris"的问题:
代码块 |
---|
cf[10003] in ("London", "Milan", "Paris") |
- 查找自定义字段"Location"的值不为空的问题:
描述搜索 描述中包含指定字符的问题。 可以使用JIRA文本搜索语法。 注意: 这个字段不支持 自动完成。 语法 字段类型 文本 TEXT 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Fields |
---|
| quickstart:__JQL Operators supported by Text Fields |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 - 模糊搜索描述中包含 "Please see screenshot" 的问题:
代码块 |
---|
description ~ "Please see screenshot" |
- 精确搜索描述中包含 "Please see screenshot" 的问题:
代码块 |
---|
description ~ "\"Please see screenshot\"" |
逾期日期 Due 按照问题的逾期日期范围搜索问题。 包含页面 |
---|
| quickstart:__JQL Date Formats |
---|
| quickstart:__JQL Date Formats |
---|
nopanel | true |
---|
|
注意逾期日期只能根据 日期 计算 (不能根据时间计算)。 注意: 这个字段不支持 自动完成。 语法 或者: 字段类型 日期 DATE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
nopanel | true |
---|
| 支持的函数 当使用 等于, 不等于, 大于, 大于等于, 小于 或 小于等于 运算符时, dueDate 支持: 示例 - 搜索截止2009年1月1日逾期的问题:
- 查找明天到期的问题:
- 查找2009年1月到期的问题:
代码块 |
---|
due > "2008/12/31" and due < "2009/02/01" |
- 查找2009年1月15日到期的问题:
代码块 |
---|
due > "2009/01/14" and due < "2009/01/16" |
环境 搜索 环境 字段中包含指定字符的问题。 可以使用JIRA文本搜索语法。 注意: 这个字段不支持 自动完成。 语法 字段类型 文本 TEXT 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Fields |
---|
| quickstart:__JQL Operators supported by Text Fields |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 - 模糊搜索环境中包括 "Third floor"的问题:
代码块 |
---|
environment ~ "Third floor" |
- 精确匹配环境中包含"Third floor"的问题:
代码块 |
---|
environment ~ "\"Third floor\"" |
过滤器你可以直接在JQL中使用 保存的过滤器 。 可以使用过滤器名称或过滤器ID(JIRA自动为过滤器分配的数值)搜索。 信息 |
---|
| 一旦修改了过滤器名称, 以过滤器名称为条件的其他过滤器将失效。 过滤器 ID是唯一且不能更改的。 |
注意: - 输入的查询语句中的 排序 (ORDER BY) 表达式将会代替过滤器中的 ORDER BY 表达式。
- 你不能执行或保存一个无限循环的过滤器 (例如 当一个被引用的过滤器中又引用的当前的过滤器,是无法执行的。)。
- 这个字段支持 自动完成。
语法 或者: 字段类型 过滤器 FILTER 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Select Fields (excluding IS) |
---|
| quickstart:__JQL Operators supported by Select Fields (excluding IS) |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 - 返回过滤器 "My Saved Filter" (过滤器ID是 12000)中经办人是jsmith的问题:
代码块 |
---|
filter = "My Saved Filter" and assignee = jsmith | 或 代码块 |
---|
filter = 12000 and assignee = jsmith |
修复版本 按照指定的 修复版本搜索问题。 你可以使用版本名称或版本ID (JIRA自动为版本分配的数值)搜索。 信息 |
---|
title | 按照版本ID搜索比按照版本名称搜索更准确 |
---|
| 不同的项目可能有相同名称的版本, 所有按照版本名称搜索可能会搜索到多个项目的问题。 当JIRA管理员更改版本的名称, 会使依赖版本名称的 过滤器 失效。 Version ID是唯一且无法修改的。 |
注意: 这个字段支持自动完成。 语法 字段类型 版本 VERSION 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
nopanel | true |
---|
|
注意比较运算符 (如 ">") 使用 版本排序 只按照JIRA管理员设置的顺序, 而不按照数值或字母顺序。 支持的函数 当使用 在...之内(IN) 和 不在...之内(NOT IN) 运算符时, fixVersion 支持: 示例 - 查找修复版本是 3.14 或 4.2的问题:
代码块 |
---|
fixVersion in ("3.14", "4.2") | (注意句号(.)是JIRA保留 #字符, 所以你需要用引号将其括起来。) - 查找修复版本是 "Little Ted"的问题:
代码块 |
---|
fixVersion = "Little Ted" |
- 查找修复版本ID 是10001的问题:
问题键值 按照指定的 问题键值 或问题ID (JIRA自动为问题分配的数值)。 注意: 这个字段不支持 自动完成。 语法 或者: 字段类型 问题 ISSUE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
nopanel | true |
---|
| 支持的函数 当使用 在...之内(IN) 或 不在...之内(NOT IN) 运算符时, issueKey 支持: 示例 安全级别 只有当JIRA管理员 开启了问题安全级别时才有效 按照指定的 安全级别搜索问题。 你可以按照问题安全级别或问题安全级别ID(JIRA自动为问题安全级别分配的数值)搜索。 信息 |
---|
title | 搜索安全级别ID比搜索安全级别名称更准确 |
---|
| 一旦JIRA管理员修改了安全级别名称, 以安全级别名称为条件的 过滤器 将无法工作。 安全级别ID是唯一且不能被修改的。 |
注意: 这个字段支持自动完成。 语法 字段类型 安全级别 SECURITY LEVEL 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 - 搜索安全级别是 "Really High" 或 "level1"的问题:
代码块 |
---|
level in ("Really High", level1) |
- 搜索安全级别ID 是123的问题:
锚 |
---|
| originalEstimate |
---|
| originalEstimate |
---|
|
锚 |
---|
| OriginalEstimate |
---|
| OriginalEstimate |
---|
|
初始预估时间 只有JIRA管理员 开启了时间跟踪 才有效 按照 初始预估时间 的值(只能是数字, 不能是日期或日期范围)搜索问题 使用 "w", "d", "h" 和 "m" 来指定周, 日, 小时或分钟。 注意: 这个字段不支持 自动完成。 语法 或者: 字段类型 期间 DURATION 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 - 查找初始预估时间为1小时的问题:
- 查找初始预估时间大于2天的问题:
父问题只有当JIRA管理员 开启子任务(连接到Atlassian网站) 才有效 搜索指定问题的所有 子任务。 你可以按照 问题键值 或问题ID (JIRA自动为问题分配的数值)搜索。 注意: 这个字段不支持 自动完成。 语法 字段类型 问题 ISSUE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Select Fields (excluding IS) |
---|
| quickstart:__JQL Operators supported by Select Fields (excluding IS) |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 优先级按照指定的 优先级搜索问题。 你可以使用优先级名称或优先级ID (JIRA自动为优先级分配的数值)搜索。 信息 |
---|
| 一旦JIRA管理员修改了优先级名称, 以优先级名称为搜索条件的 过滤器将无法工作。 优先级ID是唯一且无法更改的。 |
注意: 这个字段支持自动完成。 语法 字段类型 优先级 PRIORITY 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 - 搜索优先级时 "High"的问题:
- 搜索优先级ID是10000的问题:
项目搜索指定 项目 中的问题。 你可以按照 项目名称, 或 项目键值 或项目ID (JIRA自动为项目分配的数值)搜索。 注意: 这个字段支持自动完成。 语法 字段类型 项目 PROJECT 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
nopanel | true |
---|
| 支持的函数 当使用 在...之内(IN) 和 不在...之内(NOT IN)运算符时, project 支持: 示例 - 查找项目名称是 "ABC Project"的问题:
代码块 |
---|
project = "ABC Project" |
- 查找项目键值是 "ABC"的问题:
- 查找项目ID是 "1234"的问题:
锚 |
---|
| remainingEstimate |
---|
| remainingEstimate |
---|
|
锚 |
---|
| RemainingEstimate |
---|
| RemainingEstimate |
---|
|
剩余预估时间 只有JIRA管理员 开启了时间跟踪 才有效 按照 剩余预估时间 的值(只能是数字, 不能是日期或日期范围)搜索问题 使用 "w", "d", "h" 和 "m" 来指定周, 日, 小时或分钟。 注意: 这个字段不支持 自动完成。 语法 或者: 字段类型 期间 DURATION 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 - 查找剩余预估时间大于4小时的问题:
代码块 |
---|
remainingEstimate > 4h |
报告人 按照指定的报告人(创建人)搜索问题。 你可以按照用户全称、ID或邮件地址搜索。 注意: 这个字段支持自动完成。 语法 字段类型 用户 USER 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
nopanel | true |
---|
| 支持的函数 当使用 在...之内(IN) 或 不在...之内(NOT IN) 运算符时, reporter 支持: 当使用 等于 和 不等于 运算符时, reporter 支持: 示例 - 搜索由Jill Johns创建的问题:
代码块 |
---|
reporter = "Jill Jones" | 或 - 搜索报告人邮件地址是"bob@mycompany.com"的问题:
代码块 |
---|
assignee = "bob@mycompany.com" | (注意句号(.)和 "@" 符号是JIRA保留 #字符, 所以你需要用引号将其括起来。)
解决结果按照指定的 解决结果搜索问题。 你可以将解决结果的名称和ID(JIRA自动为解决结果分配的数值)作为搜索条件。 信息 |
---|
title | 搜索解决结果ID比搜索解决结果名称更准确 |
---|
| 一旦JIRA管理员更改了解决结果的名称, 以解决结果名称为条件的 过滤器 将无法工作。 而解决结果ID是唯一且不能修改的。 |
注意: 这个字段支持自动完成。 语法 字段类型 解决结果 RESOLUTION 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 - 查找解决方法为"Cannot Reproduce" 或 "Won't Fix"的问题:
代码块 |
---|
resolution in ("Cannot Reproduce", "Won't Fix") |
- 查找解决方法ID为5的问题:
- 查找还没有解决的问题:
代码块 |
---|
resolution = unresolved |
锚 |
---|
| ResolutionDate |
---|
| ResolutionDate |
---|
|
锚 |
---|
| resolutionDate |
---|
| resolutionDate |
---|
|
解决日期按照指定的解决日期或解决日期的范围查找问题。 包含页面 |
---|
| quickstart:__JQL Date Formats |
---|
| quickstart:__JQL Date Formats |
---|
nopanel | true |
---|
|
注意: 这个字段不支持 自动完成。 语法 或者: 字段类型 日期 DATE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
nopanel | true |
---|
| 支持的函数 当使用 等于, 不等于, 大于, 大于等于, 小于 或 #LESS_THAN_EQUALS 运算符时, resolved 支持: 示例 - 查找2008年12月31日00:00之前解决的问题:
代码块 |
---|
resolved <= "2008/12/31" |
- 查找2009年1月解决的问题:
代码块 |
---|
resolved > "2008/12/31" and resolved < "2009/02/01" |
- 查找2009年1月15日解决的问题:
代码块 |
---|
resolved > "2009/01/14" and resolved < "2009/01/16" |
- 查找前一小时之内解决的问题:
状态按照指定的 状态查找问题。 你可以按照状态名称或状态ID(JIRA自动为状态分配的数值)搜索问题。 信息 |
---|
| 一旦JIRA管理员更改了状态名称,按照状态名称为搜索条件的 过滤器 将无法工作。 状态ID是唯一且无法更改的。 |
注意: 这个字段支持自动完成。 语法 字段类型 状态 STATUS 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 - 查找状态是"Open"的问题:
- 查找状态ID 是1的问题:
主题按照主题中指定的字符查找问题。 可以使用JIRA 文本搜索语法 。 注意: 这个字段不支持自动完成。 语法 字段类型 文本 TEXT 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Fields |
---|
| quickstart:__JQL Operators supported by Text Fields |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 - 模糊查找主题中包含 "Error saving file"的问题:
代码块 |
---|
summary ~ "Error saving file" |
- 精确查找主题中包含 "Error saving file"的问题:
代码块 |
---|
summary ~ "\"Error saving file\"" |
文本可以在以下文本字段内容中查找包含指定字符的问题: 包含页面 |
---|
| quickstart:__JQL Text Fields |
---|
| quickstart:__JQL Text Fields |
---|
nopanel | true |
---|
|
注意: text 只能和 包含 运算符 ("~ " 以及 "!~ ")结合使用。 语法 字段类型 文本 TEXT 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Fields (excluding IS and NOT) |
---|
| quickstart:__JQL Operators supported by Text Fields (excluding IS and NOT) |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 - 查找文本字段中包括"Fred"的问题: or
- 精确查找文本字段中包括"full screen"的问题:
代码块 |
---|
text ~ "\"full screen\"" |
问题类型 按照指定的 问题类型搜索问题 你可以按照问题类型名称或问题类型ID (JIRA自动为问题类型分配的数值)搜索问题。 信息 |
---|
title | 搜索问题类型ID比搜索问题类型名称更准确 |
---|
| 一旦JIRA管理员修改了问题类型名称,以问题类型名称为搜索条件的过滤器 将无法工作。 问题类型ID是唯一且不能修改的。 |
注意: 这个字段支持自动完成。 语法 或者: 字段类型 问题类型 ISSUE_TYPE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 - 查找问题类型是"Bug"的问题:
- 查找问题类型是"Bug" 或 "Improvement"的问题:
代码块 |
---|
issueType in (Bug,Improvement) |
- 查找问题类型ID是2的问题:
实际工作时间 只有当JIRA管理员 开启了时间跟踪(链接到)才有效 按照 实际工作时间 的值 (只能是数字,不能是日期或日期范围)搜索问题。 使用 "w", "d", "h" 和 "m" 来指定周, 日, 小时或分钟。 注意: 这个字段不支持自动完成。 语法 字段类型 期间 DURATION 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例
更新日期 按照指定的日期或日期范围查找被更新的问题。 包含页面 |
---|
| quickstart:__JQL Date Formats |
---|
| quickstart:__JQL Date Formats |
---|
nopanel | true |
---|
|
注意: 这个字段不支持自动完成。 语法 或者: 字段类型 日期 DATE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
nopanel | true |
---|
| 支持的函数 当使用 等于, 不等于, 大于, 大于等于, 小于 或 #LESS_THAN_EQUALS 运算符时, updated 支持: 示例 - 查找2008年12月12日00:00之前更新的问题:
代码块 |
---|
updated <= "2008/12/12" |
- 查找2周之前更新的问题:
- 查找2009年1月15日更新的问题:
代码块 |
---|
updated > "2009/01/14" and updated < "2009/01/16" |
- 查找2009年1月更新的问题:
代码块 |
---|
updated > "2008/12/31" and updated < "2009/02/01" |
投票人 按照指定的投票人查找问题。 你可以按照用户全名、ID 或电子邮件地址搜索。 需要注意的是,你必须拥有 "查看投票人及关注者"权限才能根据投票人搜索问题, 否则你只能搜索你自己投票的问题。具体内容参见 投票的问题。 注意: 这个字段支持自动完成。 语法 字段类型 USER 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
nopanel | true |
---|
| 支持的函数 当使用 在...之内(IN)和不在...之内(NOT IN) 运算符时, voter 支持: 当使用 等于 以及 不等于 运算符时, voter 支持: 示例 - 搜索你自己投票的问题:
- 搜索 "jsmith" 投票的问题:
- 搜索用户组 "jira-developers"所有成员投票的问题:
代码块 |
---|
voter in membersOf("jira-developers") |
投票数量 搜索指定投票数量的问题。 注意: 这个字段不支持自动完成。 语法 字段类型 NUMBER 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields (excluding IS) |
---|
| quickstart:__JQL Operators supported by Numeric Fields (excluding IS) |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例
关注人按照指定关注人搜索问题。 你可以按照用户全称、ID或电子邮件地址搜索。 需要注意的是,你必须拥有 "查看投票人及关注者"权限才能根据关注人搜索问题, 否则你只能搜索你自己关注的问题。具体信息请参阅 关注的问题。 注意: 这个字段支持自动完成。 语法 字段类型 USER 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
| quickstart:__JQL Operators supported by Select Fields |
---|
nopanel | true |
---|
| 支持的函数 当使用 在...之内(IN) 和 不在...之内(NOT IN) 运算符时, watcher 支持: 当使用 等于 和 不等于 运算符时, watcher 支持: 示例 - 搜索你关注的问题:
代码块 |
---|
watcher = currentUser() |
- 搜索 "jsmith" 关注的问题:
- 搜索用户组"jira-developers"的成员关注的问题:
代码块 |
---|
watcher in membersOf("jira-developers") |
工作时间比率 只有当JIRA管理员 开启了时间跟踪(链接到)才有效 按照指定的工作时间比率的值搜索问题。 工作时间比率的计算公式是: 工作时间比率 = 实际工作时间 / 初始预估时间) x 100 注意: 这个字段不支持自动完成。 语法 字段类型 数值 NUMBER 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
| quickstart:__JQL Operators supported by Numeric Fields |
---|
nopanel | true |
---|
| 支持的函数 n/a 示例 - 查找实际工作时间占初始预估时间百分比大于75%的问题:
|
函数参考
内容区目录 |
---|
maxLevel | 4 |
---|
minLevel | 4 |
---|
location | top |
---|
type | list |
---|
|
锚 |
---|
| cascadeOption |
---|
| cascadeOption |
---|
|
级联选择列表值 cascadeOption() 按照 自定义字段中设置的 '级联选择列表'值来查找问题。 一级列表值 是必选参数。 二级列表值 是可选参数。 关键字 "none" 可以用来搜索级联列表值为空的问题。 语法 代码块 |
---|
cascadeOption(parentOption) |
或者 代码块 |
---|
cascadeOption(parentOption,childOption) | 支持的字段类型 级联选择列表 CASCADING_OPTION 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查找自定义字段 ("Location") 中 "USA" 下 "New York" 的问题:
代码块 |
---|
location in cascadeOption("USA","New York") |
- 查找自定义字段 ("Location") 中 "USA" 下(包括二级选择值为空)的所有问题:
代码块 |
---|
location in cascadeOption("USA") |
- 查找自定义字段 ("Location") 中 "USA" 下, 二级选择值为空的问题:
代码块 |
---|
location in cascadeOption("USA",none) |
- 查找自定义字段 ("Location") 中一、二级列表都没有值的问题:
代码块 |
---|
location in cascadeOption(none) |
- 查找自定义字段 ("Referrer") 中一、二级列表值都为"none"的问题:
代码块 |
---|
referrer in cascadeOption("\"none\"","\"none\"") |
- 查找自定义字段 ("Referrer") 中一级列表值为"none",二级列表值为空的的问题:
代码块 |
---|
referrer in cascadeOption("\"none\"",none) |
锚 |
---|
| componentsLeadByUser |
---|
| componentsLeadByUser |
---|
|
模块负责人 componentsLeadByUser() 查找指定模块负责人负责的问题。 如果你没有输入用户参数, JIRA会将当前用户(你)作为默认条件。 如果你没有登录JIRA, 必须指定用户。 语法 代码块 |
---|
componentsLeadByUser() |
或 代码块 |
---|
componentsLeadByUser(username) | 支持的字段类型 模块 COMPONENT 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查看模块负责人是你,状态是Open的问题:
代码块 |
---|
component in componentsLeadByUser() AND status = Open |
- 查看模块负责人是Bill,状态是Open的问题:
代码块 |
---|
component in componentsLeadByUser(bill) AND status = Open |
当前用户进程 currentLogin() 按照当前用户进程搜索问题。 还可以查阅 上次进程。 语法 支持的字段类型 日期 DATE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Date Functions |
---|
| quickstart:__JQL Operators supported by Date Functions |
---|
nopanel | true |
---|
| 示例 - 查找当前进程中创建的问题:
代码块 |
---|
created > currentLogin() |
当前用户 currentUser() 按照当前用户查找问题。 只有登录用户才能使用这个函数。所以匿名用户创建的过滤器无法使用这个函数。 语法 支持的字段类型 用户 USER 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by User Functions |
---|
| quickstart:__JQL Operators supported by User Functions |
---|
nopanel | true |
---|
| 示例 - 查找分配给我的问题:
代码块 |
---|
assignee = currentUser() |
- 查找我报告的但不是分配给我的问题:
代码块 |
---|
reporter = currentUser() and assignee != currentUser() |
最近查看的问题 issueHistory() 查看你最近查看的问题, 就是在页面顶部菜单导航栏 '问题'菜单下的'最近查看的问题'中的问题。 注意: issueHistory() 只返回50个结果, 但是 '最近查看的问题' 只返回5个结果。- 如果你没有登录JIRA, 只返回当前浏览器进程中浏览的问题。
语法 支持的字段类型 问题 ISSUE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查找我最近查看的,并且分配给我的问题:
代码块 |
---|
issue in issueHistory() AND assignee = currentUser() |
用户上次进程 lastLogin() 按照当前用户上次进程搜索问题。还可以查阅 当前进程。 语法 支持的字段类型 日期 DATE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Date Functions |
---|
| quickstart:__JQL Operators supported by Date Functions |
---|
nopanel | true |
---|
| 示例 链接的问题 linkedIssues() 查找问题的 链接 作为条件查找问题。 你可以指定链接类型作为查询条件,注意链接类型大小写敏感。 语法 代码块 |
---|
linkedIssues(issueKey) |
或者 代码块 |
---|
linkedIssues(issueKey,linkType) | 支持的字段类型 问题 ISSUE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查找被ABC-123链接的问题:
代码块 |
---|
issue in linkedIssues(ABC-123) |
- 查找被ABC-123链接,链接类型是"重复"的问题:
代码块 |
---|
issue in linkedIssues(ABC-123,"重复") |
是...的成员 membersOf() 按照指定用户组成员来查找问题。 语法 支持的字段类型 用户 USER 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查找分配人是用户组 "jira-developers"的问题:
代码块 |
---|
assignee in membersOf("jira-developers") |
- 搜索多个用户组成员报告的问题:
代码块 |
---|
reporter in membersOf("jira-developers") or reporter in membersOf("jira-administrators") or reporter=jsmith |
- 搜索用户在指定用户组并且不再另外用户组中的问题:
代码块 |
---|
assignee in membersOf(QA) and assignee not in ("John Smith","Jill Jones") |
- 经办人不是用户组QA成员的问题:
代码块 |
---|
assignee not in membersOf(QA) |
当前时间 now() 以当前时间为搜索条件。 语法 支持的字段类型 日期 DATE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Date Functions |
---|
| quickstart:__JQL Operators supported by Date Functions |
---|
nopanel | true |
---|
| 示例 - 查找过期的未解决的问题:
代码块 |
---|
duedate < now() and status not in (closed, resolved) |
锚 |
---|
| projectsLeadByUser |
---|
| projectsLeadByUser |
---|
|
项目负责人 projectsLeadByUser() 查找指定项目负责人负责的问题。 你可以指定一个用户,或者不指定用户,JIRA会自动按照当前用户查找。 如果你没有登录JIRA, 你必须指定一个用户来执行这个函数。 语法 或者 代码块 |
---|
projectsLeadByUser(username) | 支持的字段类型 项目 PROJECT 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查找项目负责人是你的问题:
代码块 |
---|
project in projectsLeadByUser() AND status = Open |
- 查找项目负责人是Bill,并且状态为Open的问题:
代码块 |
---|
project in projectsLeadByUser(bill) AND status = Open |
锚 |
---|
| projectsWhereUserHasPermission |
---|
| projectsWhereUserHasPermission |
---|
|
你拥有的项目权限 projectsWhereUserHasPermission() 按照你拥有的项目 权限查找问题。 只有登录到JIRA后才能使用这个函数。 语法 代码块 |
---|
projectsWhereUserHasPermission(permission) |
查看具体的 权限 参数 支持的字段类型 项目 PROJECT 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查找你拥有"Resolve Issues"权限的项目中,状态"Open"的问题:
代码块 |
---|
project in projectsWhereUserHasPermission("Resolve Issues") AND status = Open |
锚 |
---|
| projectsWhereUserHasRole |
---|
| projectsWhereUserHasRole |
---|
|
你属于的项目角色 projectsWhereUserHasRole() 按照你属于指定的 项目角色搜索问题。 注意只有登录JIRA后才能使用这个函数。 语法 代码块 |
---|
projectsWhereUserHasRole(rolename) | 支持的字段类型 项目 PROJECT 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查找你作为 "Developers" 角色的项目中状态为"Open"的问题:
代码块 |
---|
project in projectsWhereUserHasRole("Developers") AND status = Open |
锚 |
---|
| releasedVersions |
---|
| releasedVersions |
---|
|
已发布版本 releasedVersions() 查找指定项目中已发布版本的问题。 如果没有输入 项目 参数,就会搜索所有项目的已发布版本的问题。 语法 或 代码块 |
---|
releasedVersions(project) | 支持的字段类型 版本 VERSION 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查找项目 ABC 中所有 修复版本(FixVersion) 已经发布的问题:
代码块 |
---|
fixVersion in releasedVersions(ABC) |
- 查找项目 ABC 中所有影响版本和修复版本已经发布的问题 :
代码块 |
---|
affectedVersion in releasedVersions(ABC) | 或 代码块 |
---|
fixVersion in releasedVersions(ABC) |
锚 |
---|
| standardIssuesTypes |
---|
| standardIssuesTypes |
---|
|
标准问题类型 standardIssueTypes() 按照"标准" 问题类型查找问题。标准问题类型指的是非 子任务的问题。 语法 支持的字段类型 问题类型 ISSUE_TYPE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查找非子任务类型的问题 (标准问题类型的问题,不是子任务问题类型):
代码块 |
---|
issuetype in standardIssueTypes() |
锚 |
---|
| subtaskIssuesTypes |
---|
| subtaskIssuesTypes |
---|
|
子任务问题类型 subtaskIssueTypes() 查找所有子任务问题。 语法 支持的字段类型 问题类型 ISSUE_TYPE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查找所有子任务问题 (问题类型是子任务类型):
代码块 |
---|
issuetype in subtaskIssueTypes() |
锚 |
---|
| unreleasedVersions |
---|
| unreleasedVersions |
---|
|
未发布版本 unreleasedVersions() 查找指定项目中未发布版本的问题。 如果没有输入 项目 参数,就会搜索所有项目的已发布版本的问题。 语法 或 代码块 |
---|
unreleasedVersions(project) | 支持的字段类型 版本 VERSION 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查找ABC项目中修复版本(FixVersion)还未发布的问题:
代码块 |
---|
fixVersion in unreleasedVersions(ABC) |
- 查找ABC项目中影响版本和修复版本尚未发布的问题:
代码块 |
---|
affectedVersion in unreleasedVersions(ABC) | or 代码块 |
---|
fixVersion in unreleasedVersions(ABC) |
投票的问题 votedIssues() 查看你已投票的问题 。 请查阅 投票人(Voter)字段。 只有登录用户才能使用这个函数。 语法 支持的字段类型 问题 ISSUE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查找你投票的问题:
代码块 |
---|
issue in votedIssues() |
锚 |
---|
| watchedIssues |
---|
| watchedIssues |
---|
|
关注的问题 watchedIssues() 查找你 正在关注的问题。 请查看 关注人(Watcher)字段。 只有登录用户才能使用这个函数。 语法 支持的字段类型 问题 ISSUE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查找你关注的问题:
代码块 |
---|
issue in watchedIssues() |
支持的字段类型 问题 ISSUE 支持的运算符 包含页面 |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
| quickstart:__JQL Operators supported by Text Functions |
---|
nopanel | true |
---|
| 示例 - 查找最近刚刚查看过的问题:
代码块 |
---|
issue in issueHistory() |
|
控制运算顺序
你可以在复杂的JQL语句中使用括号来控制 运算符的运算顺序。
例如, 如果你想查找SysAdmin项目中所有问题解决的问题,或者分配给系统管理员(bobsmith)的问题, 你可以使用括号来控制运算顺序, 例如:
代码块 |
---|
(status=resolved AND project=SysAdmin) OR assignee=bobsmith |
如果你不使用括号, 表达式运算顺序将从左到右逐一运算。
你也可以使用括号将表达式分组, 方便地在表达式前使用否定(NOT)运算符,否定整个表达式的结果。
执行文本搜索
当搜索下面的文本字段时,你可以在查询表达式中使用包括这样的 Lucene 文本搜索特性运算符:
更多详细说明, 请查看 搜索文本页面, 该页面包括以下章节:
包含摘录 |
---|
| quickstart:执行文本搜索 |
---|
| quickstart:执行文本搜索 |
---|
nopanel | true |
---|
|
锚 |
---|
| auto-complete |
---|
| auto-complete |
---|
|
使用自动完成
当你输入以下条件的查询语句时, JIRA 会自动根据上下文提供一些建议:
内容区目录 |
---|
|
建议列表按照字母顺序提供最多15个可选项。JIRA不会提供函数参数的自动完成建议列表。 信息 |
---|
| - 如果没有可提供的自动完成建议, 管理员可能禁止了 "JQL自动完成" 功能。
- 如果你不希望使用自动完成建议功能, 点击查询框下方的 "关闭自动完成" 链接。
|
不是所有字段都提供自动完成建议列表。 点击 字段 参考查看哪些字段支持自动完成。 如果你在查询语句的起始输入了空格... ...JIRA 会自动提供所有可用字段的列表, 例如: 如果你输入了超过1个字符... ...JIRA 会列出可能匹配的字段列表, 例如: 如果你输入了一个字段并输入了空格... ...JIRA 会列出可用的 运算符列表, 例如: 如果你输入了一个字段, 接着输入了一个运算符, 然后又输入了一个空格... ...JIRA 会提供有效的字段值列表, 例如: 如果你输入了一个字段, 接着输入了一个运算符, 然后又输入了1个字符... ...JIRA 会提供可用字段值的列表 (如果你输入的 字段 值支持列表) 以及可用的and valid functions for the field/operator combination, e.g.:
|
在 '高级搜索' 和 '简单搜索'模式之间切换
一般情况下, 使用'简单搜索' 模式的查询条件都可以翻译为 '高级搜索(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保留了一些特定字符。如果你需要在查询语句中使用下面的字符,你必须用引号将其括起来:
- space (
" "
) "+"
"."
","
";"
"?"
"|"
"'"
"*"
"/"
"%"
"^"
"$"
"#"
"@"
信息 |
---|
你既可以使用单引号 (' ) 也可以使用双引号 (" ). |
如果搜索条件中包含引号, 你需要在引号前加上转义符(反斜线), 例如:
代码块 |
---|
"Type your name in the \"Login\" box" |
如果你的搜索条件中包含单引号, 那么你就可以在单引号里面使用双引号(不需要转义符); 但是你必须为其他单引号添加转义符,反之亦然。
注意有一些附加的 文本搜索保留字符在以下字段中应用:
包含页面 |
---|
| quickstart:__JQL Text Fields |
---|
| quickstart:__JQL Text Fields |
---|
nopanel | true |
---|
|
.
保留的单词
JQL保留了一些专用的单词. 如果你需要在查询语句中使用下面的单词,必须用引号将其括起来:
"abort", "access", "add", "after", "alias", "all", "alter", "and", "any", "as", "asc",
"audit", "avg", "before", "begin", "between", "boolean", "break", "by", "byte", "catch", "cf",
"char", "character", "check", "checkpoint", "collate", "collation", "column", "commit", "connect", "continue",
"count", "create", "current", "date", "decimal", "declare", "decrement", "default", "defaults", "define", "delete",
"delimiter", "desc", "difference", "distinct", "divide", "do", "double", "drop", "else", "empty", "encoding",
"end", "equals", "escape", "exclusive", "exec", "execute", "exists", "explain", "false", "fetch", "file", "field",
"first", "float", "for", "from", "function", "go", "goto", "grant", "greater", "group", "having",
"identified", "if", "immediate", "in", "increment", "index", "initial", "inner", "inout", "input", "insert",
"int", "integer", "intersect", "intersection", "into", "is", "isempty", "isnull", "join", "last", "left",
"less", "like", "limit", "lock", "long", "max", "min", "minus", "mode", "modify",
"modulo", "more", "multiply", "next", "noaudit", "not", "notin", "nowait", "null", "number", "object",
"of", "on", "option", "or", "order", "outer", "output", "power", "previous", "prior", "privileges",
"public", "raise", "raw", "remainder", "rename", "resource", "return", "returns", "revoke", "right", "row",
"rowid", "rownum", "rows", "select", "session", "set", "share", "size", "sqrt", "start", "strict",
"string", "subtract", "sum", "synonym", "table", "then", "to", "trans", "transaction", "trigger", "true",
"uid", "union", "unique", "update", "user", "validate", "values", "view", "when", "whenever", "where",
"while", "with"
信息 |
---|
你既可以使用单引号 (' ) 也可以使用双引号 (" ). |
(JIRA管理员请注意: 上面列表是 JqlStringSupportImpl.java
文件的固定编码。)
注意还有一些其他 文本搜索的保留字段 在下面的字段中应用:
包含页面 |
---|
| quickstart:__JQL Text Fields |
---|
| quickstart:__JQL Text Fields |
---|
nopanel | true |
---|
|
.