本页面的内容:
目录 | ||||
---|---|---|---|---|
|
什么是高级搜索?
通过高级搜索,你可以使用结构化查询语言搜索JIRA的问题。 搜索的结果会显示在 问题导航器中, 然后你可以将搜索结果输出为 MS Excel格式 以及 其他格式。 你还可以 保存 以及 订阅搜索结果。
查询语句由一个 字段, 运算符, 和 值 或 _函数_构成。 例如, 下面的查询语句将返回 "TEST"项目的所有问题:
...
当你执行高级搜索时, 你使用的是JIRA查询语言(JQL)。 JQL类似SQL表达式, 比如 #> > 和 #NULL NULL。 当然, 你不能使用数据库查询语言; 例如, JQL不能使用 SELECT
表达式。
...
如何使用高级搜索
...
内容区目录 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
与 AND用于整合多个查询条件, 允许你精炼查询条件。 注意,你可以使用 括号 来控制查询条件的执行顺序。 示例
或 OR用户整合多个查询条件, 允许你扩展查询条件。 注意,你可以使用 括号 来控制查询条件的执行顺序。 (注意: 也可以查看 请参阅 在...之中(IN)章节, 使用更方便的方法搜索多个字段的值。) 示例
非 NOT用于否定一个运算符或整个查询条件, 允许你优化查询条件。 注意,你可以使用 括号 来控制查询条件的执行顺序。 (注意: 也可以查看 请参阅 不等于 ("!="), 不包括 ("!~"), 不再...之中 和 不是章节) 示例
空 EMPTY用于搜索没有值的字段。 也可以查看请参阅 空(NULL)。 注意 EMPTY 只能与 是(IS) 和 不是(IS NOT) 运算符结合使用。 要查看字段支持的运算符, 点击 #字段 字段 。 示例
空 NULL用于搜索字段没有赋值的问题。 请查看 空(EMPTY)。 注意 NULL 只能用于支持 是(IS) 和 不是(IS NOT) 操作符的字段。 要了解字段支持哪些操作符, 请查看每个 字段 参考。 示例
排序 ORDER BY用于对输出的结果,按照指定的字段排序。 默认情况下, 按照字段输出顺序排序。 你可以指定按照升序 (" 示例
|
...
内容区目录 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
等于: =" 要精确匹配多个字段值,请使用与(AND)将多个 " 示例
不等于: !=" 注意输入 示例
大于: >" 注意 " 示例
大于等于: >=" 注意 " 示例
小于: <The " 注意" 示例
小于等于: <=The " 注意 " 示例
在...之内 IN" 使用 " 示例
不在...之内 NOT IN" 使用 " 示例
包含: ~"
注意: 使用 " 示例
不包括: !~"
注意: 使用 " 示例
是 IS" 注意不是所有的 字段 都可以使用这个运算符; 分别查看所有的 字段 参考了解具体用法。 示例
不是 IS NOT" 注意不是所有的 字段 都可以使用这个运算符; 分别查看所有的 字段 参考了解具体用法。 示例
|
锚 | ||||
---|---|---|---|---|
|
锚 | ||||
---|---|---|---|---|
|
...
内容区目录 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
影响版本搜索指定影响版本的问题。 你可以按照版本名称或版本ID(JIRA自动为版本分配的数值)搜索 。
注意: 这个字段支持 自动完成。 语法
字段类型版本 VERSION 支持的操作符
注意比较运算符 (如 ">") 使用 版本排序(链接到Atlassian网站) 只按照JIRA管理员设置的顺序, 而不按照数值或字母顺序。 支持的函数当使用 在...之内(IN) 和 不在...之内(NOT IN) 运算符时, 示例
经办人搜索经办人是指定用户的问题。 你可以使用用户全名、ID或电子邮件地址。 注意: 这个字段支持 自动完成。 语法
字段类型用户 USER 支持的运算符
支持的函数当使用 #IN IN 和 #NOTNOT_IN 运算符时, 当使用 等于 和 不等于 运算符时, 示例
类别搜索属于指定项目类别的项目下的所有问题。 注意: 这个字段支持 自动完成。 语法
字段类型类别 CATEGORY 支持的运算符
支持的函数n/a 示例
备注搜索备注中包含指定字符的问题。 可以使用JIRA 文本搜索语法 。 注意: 这个字段不支持 自动完成。 语法
字段类型文本 TEXT 支持的运算符
支持的函数n/a 示例
模块搜索一个项目中的指定 模块的问题。 你可以按照模块名称或模块ID (JIRA自动分配给模块的数字)搜索。
注意: 这个字段支持自动完成。 语法
字段类型模块 COMPONENT 支持的运算符
支持的函数当使用 在...之内(IN) 和 不在...之内(NOT IN) 运算符时, 示例
创建日期按照指定的创建日期范围搜索问题。
注意: 这个字段不支持 自动完成。 语法
或者:
字段类型日期 DATE 支持的运算符
支持的函数当使用 等于, 不等于, 大于, 大于等于, 小于 或 小于等于 运算符时, 示例
自定义字段只有当JIRA管理员已经创建了 自定义字段(链接到Atlassian网站)才有效 按照指定自定义字段值查找问题。 你可以按照自定义字段名称或自定义字段ID(JIRA自动为自定义字段分配的数值)搜索。
注意:
语法
或者:
字段类型依赖于自定义字段(链接到Atlassian网站)的配置。 支持的运算符不同类型的自定义字段支持不同的 运算符。 对于默认的自定义字段(链接到Atlassian网站), 支持下面的运算符:
支持的函数不同类型的自定义字段支持不同的 函数。 对于默认的自定义字段(链接到Atlassian网站), 支持下面的函数:
示例
DescriptionSearch for issues where the Description contains particular text. JIRA text-search syntax can be used. 描述搜索 描述中包含指定字符的问题。 可以使用JIRA文本搜索语法。 注意: 这个字段不支持 自动完成。Note: this field does not support #auto-complete. 语法
字段类型文本 TEXT 支持的运算符
支持的函数n/a 示例
逾期日期 DueSearch for issues that were due on, before or after a particular date (or date range). 按照问题的逾期日期范围搜索问题。
Note that Due Date relates to the date only (not to the time). 注意逾期日期只能根据 日期 计算 (不能根据时间计算)。 注意: 这个字段不支持 自动完成。Note: this field does not support #auto-complete. 语法
Alias或者:
字段类型日期 DATE 支持的运算符
支持的函数When used with the #EQUALS, #NOT_EQUALS, #GREATER_THAN, #GREATER_THAN_EQUALS, #LESS_THAN or #LESS_THAN_EQUALS operators, 示例
EnvironmentSearch for issues where the Environment contains particular text. JIRA text-search syntax can be used. 环境搜索 环境 字段中包含指定字符的问题。 可以使用JIRA文本搜索语法。 注意: 这个字段不支持 自动完成。Note: this field does not support #auto-complete. 语法
字段类型文本 TEXT 支持的运算符
支持的函数n/a 示例
Filter过滤器你可以直接在JQL中使用 保存的过滤器 。 可以使用过滤器名称或过滤器ID(JIRA自动为过滤器分配的数值)搜索。You can use a saved filter to narrow your search. You can search by filter name or filter ID (i.e. the number that JIRA automatically allocates to a saved filter).
Note:
注意:
字段类型过滤器 FILTER 支持的运算符
支持的函数n/a 示例
Fix Version修复版本按照指定的 修复版本搜索问题。 你可以使用版本名称或版本ID (JIRA自动为版本分配的数值)搜索。Search for issues that are assigned to a particular Fix Version. You can search by version name or version ID (i.e. the number that JIRA automatically allocates to a version).
注意: 这个字段支持自动完成。 语法
字段类型版本 VERSION 支持的运算符
Note that the comparison operators (e.g. 注意比较运算符 (如 ">") use the version order that has been set up by your project administrator, not a numeric or alphabetic order. 支持的函数When used with the #IN and #NOT_IN operators, 使用 版本排序 只按照JIRA管理员设置的顺序, 而不按照数值或字母顺序。 支持的函数当使用 在...之内(IN) 和 不在...之内(NOT IN) 运算符时, 示例
Issue KeySearch for issues with a particular Issue Key or Issue ID (i.e. the number that JIRA automatically allocates to an Issue). 问题键值按照指定的 问题键值 或问题ID (JIRA自动为问题分配的数值)。 注意: 这个字段不支持 自动完成。Note: this field does not support #auto-complete. 语法
Aliases或者:
字段类型问题 ISSUE 支持的运算符
支持的函数When used with the #IN or #NOT_IN operators,
示例
LevelOnly available if Issue Level Security has been enabled by your JIRA administrator. Search for issues with a particular Security Level. You can search by Issue Security Level name or Issue Security Level ID (i.e. the number that JIRA automatically allocates to an Issue Security Level). 安全级别只有当JIRA管理员 开启了问题安全级别时才有效 按照指定的 安全级别搜索问题。 你可以按照问题安全级别或问题安全级别ID(JIRA自动为问题安全级别分配的数值)搜索。
注意: 这个字段支持自动完成。 语法
字段类型安全级别 SECURITY LEVEL 支持的运算符
支持的函数n/a 示例
Original EstimateOnly available if time-tracking has been enabled by your JIRA administrator. Search for issues where the Original Estimate is set to a particular value (i.e. a number, not a date or date range). 初始预估时间只有JIRA管理员 开启了时间跟踪 才有效 按照 初始预估时间 的值(只能是数字, 不能是日期或日期范围)搜索问题 使用 Use "w", "d", "h" and 和 "m" to specify weeks来指定周, days, hours or minutes. 日, 小时或分钟。 注意: 这个字段不支持 自动完成。Note: this field does not support #auto-complete. 语法
Alias或者:
字段类型期间 DURATION 支持的运算符
支持的函数n/a 示例
ParentOnly available if sub-tasks have been enabled by your JIRA administrator. Search for all sub-tasks of a particular issue. You can search by Issue Key or by Issue ID (i.e. the number that JIRA automatically allocates to an Issue). 父问题只有当JIRA管理员 开启子任务(连接到Atlassian网站) 才有效 搜索指定问题的所有 子任务。 你可以按照 问题键值 或问题ID (JIRA自动为问题分配的数值)搜索。 注意: 这个字段不支持 自动完成。Note: this field does not support #auto-complete. 语法
字段类型问题 ISSUE 支持的运算符
支持的函数n/a 示例
Priority优先级按照指定的 优先级搜索问题。 你可以使用优先级名称或优先级ID (JIRA自动为优先级分配的数值)搜索。Search for issues with a particular Priority. You can search by Priority name or Priority ID (i.e. the number that JIRA automatically allocates to a Priority).
注意: 这个字段支持自动完成。 语法
字段类型优先级 PRIORITY 支持的运算符
支持的函数n/a 示例
ProjectSearch for issues that belong to a particular Project 项目搜索指定 项目 中的问题。 你可以按照 项目名称, 或 项目键值 或项目ID (JIRA自动为项目分配的数值)搜索。You can search by Project Name, by Project Key or by Project ID (i.e. the number that JIRA automatically allocates to a project). 注意: 这个字段支持自动完成。 语法
字段类型项目 PROJECT 支持的运算符
支持的函数When used with the #IN and #NOT_IN operators,
示例
Remaining EstimateOnly available if time-tracking has been enabled by your JIRA administrator. Search for issues where the Remaining Estimate is set to a particular value (i.e. a number, not a date or date range). 剩余预估时间只有JIRA管理员 开启了时间跟踪 才有效 按照 剩余预估时间 的值(只能是数字, 不能是日期或日期范围)搜索问题 使用 Use "w", "d", "h" and 和 "m" to specify weeks来指定周, days, hours or minutes. 日, 小时或分钟。 注意: 这个字段不支持 自动完成。Note: this field does not support #auto-complete. 语法
Alias或者:
字段类型期间 DURATION 支持的运算符
支持的函数n/a 示例
ReporterSearch for issues that were reported by (i.e. created by) a particular user. 报告人按照指定的报告人(创建人)搜索问题。 你可以按照用户全称、ID或邮件地址搜索。You can search by the user's Full Name, ID or Email Address. 注意: 这个字段支持自动完成。 语法
字段类型用户 USER 支持的运算符
支持的函数When used with the #IN and #NOT_IN operators, When used with the #EQUALS and #NOT_EQUALS operators, 示例当使用 在...之内(IN) 或 不在...之内(NOT IN) 运算符时, 当使用 等于 和 不等于 运算符时, 示例
ResolutionSearch for issues that have a particular Resolution 解决结果按照指定的 解决结果搜索问题。 你可以将解决结果的名称和ID(JIRA自动为解决结果分配的数值)作为搜索条件。You can search by Resolution name or Resolution ID (i.e. the number that JIRA automatically allocates to a Resolution).
注意: 这个字段支持自动完成。 语法
字段类型解决结果 RESOLUTION 支持的运算符
支持的函数n/a 示例
Resolved解决日期按照指定的解决日期或解决日期的范围查找问题。Search for issues that were resolved on, before or after a particular date (or date range).
Note: this field does not support #auto-complete. 注意: 这个字段不支持 自动完成。 语法
Alias或者:
字段类型日期 DATE 支持的运算符
支持的函数When used with the #EQUALS, #NOT_EQUALS, #GREATER_THAN, #GREATER_THAN_EQUALS, #LESS_THAN or #LESS当使用 等于, 不等于, 大于, 大于等于, 小于 或 LESS_THAN_EQUALS operators 运算符时, 示例
Search for issues that have a particular Status.
状态按照指定的 状态查找问题。 你可以按照状态名称或状态ID(JIRA自动为状态分配的数值)搜索问题。You can search by Status name or Status ID (i.e. the number that JIRA automatically allocates to a Status).
注意: 这个字段支持自动完成。 语法
字段类型状态 STATUS 支持的运算符
支持的函数n/a 示例
SummarySearch for issues where the Summary contains particular text. JIRA text-search syntax can be used. 主题按照主题中指定的字符查找问题。 可以使用JIRA 文本搜索语法 。 注意: 这个字段不支持自动完成。Note: this field does not support #auto-complete. 语法
字段类型文本 TEXT 支持的运算符
支持的函数n/a 示例
Text文本可以在以下文本字段内容中查找包含指定字符的问题This is a "master-field" that allows you to search all text fields, i.e.:
Note注意: The 语法
字段类型文本 TEXT 支持的运算符
支持的函数n/a 示例
TypeSearch for issues that have a particular Issue Type. You can search by Issue Type name or Issue Type ID (i.e. the number that JIRA automatically allocates to an Issue Type). 问题类型按照指定的 问题类型搜索问题 你可以按照问题类型名称或问题类型ID (JIRA自动为问题类型分配的数值)搜索问题。
注意: 这个字段支持自动完成。 语法
Alias或者:
字段类型问题类型 ISSUE_TYPE 支持的运算符
支持的函数n/a 示例
Time SpentOnly available if time-tracking has been enabled by your JIRA administrator. Search for issues where the Time Spent is set to a particular value (i.e. a number, not a date or date range). 实际工作时间只有当JIRA管理员 开启了时间跟踪(链接到)才有效 按照 实际工作时间 的值 (只能是数字,不能是日期或日期范围)搜索问题。 使用 Use "w", "d", "h" and 和 "m" to specify weeks来指定周, days, hours or minutes. 日, 小时或分钟。 注意: 这个字段不支持自动完成。Note: this field does not support #auto-complete. 语法
字段类型期间 DURATION 支持的运算符
支持的函数n/a 示例
Updated更新日期按照指定的日期或日期范围查找被更新的问题。Search for issues that were last updated on, before or after a particular date (or date range).
Note: this field does not support #auto-complete. 注意: 这个字段不支持自动完成。 语法
Alias或者:
字段类型日期 DATE 支持的运算符
支持的函数When used with the #EQUALS, #NOT_EQUALS, #GREATER_THAN, #GREATER_THAN_EQUALS, #LESS_THAN or #LESS当使用 等于, 不等于, 大于, 大于等于, 小于 或 LESS_THAN_EQUALS operators 运算符时, 示例
Voter
投票人按照指定的投票人查找问题。 你可以按照用户全名、ID 或电子邮件地址搜索。 需要注意的是,你必须拥有 "查看投票人及关注者"权限才能根据投票人搜索问题, 否则你只能搜索你自己投票的问题。具体内容参见 投票的问题。Search for issues for which a particular user has voted. You can search by the user's Full Name, ID or Email Address. Note that you can only find issues for which you have the "View Voters and Watchers" permission, unless you are searching for your own votes. See also #votedIssues. 注意: 这个字段支持自动完成。 语法
字段类型USER 支持的运算符
支持的函数When used with the #IN and #NOT_IN operators, When used with the #EQUALS and #NOT_EQUALS operators, 当使用 在...之内(IN)和不在...之内(NOT IN) 运算符时, 示例
VotesSearch for issues with a specified number of votes. 投票数量搜索指定投票数量的问题。 注意: 这个字段不支持自动完成。Note: this field does not support #auto-complete. 语法
字段类型NUMBER 支持的运算符
支持的函数n/a 示例
Watcher
关注人按照指定关注人搜索问题。 你可以按照用户全称、ID或电子邮件地址搜索。 需要注意的是,你必须拥有 "查看投票人及关注者"权限才能根据关注人搜索问题, 否则你只能搜索你自己关注的问题。具体信息请参阅 关注的问题。Search for issues that a particular user is watching. You can search by the user's Full Name, ID or Email Address. Note that you can only find issues for which you have the "View Voters and Watchers" permission, unless you are searching for issues where you are the watcher. See also #watchedIssues. 注意: 这个字段支持自动完成。 语法
字段类型USER 支持的运算符
支持的函数When used with the #IN and #NOT_IN operators, When used with the #EQUALS and #NOT_EQUALS operators, 示例当使用 在...之内(IN) 和 不在...之内(NOT IN) 运算符时, 当使用 等于 和 不等于 运算符时, 示例
Work RatioOnly available if time-tracking has been enabled by your JIRA administrator. Search for issues where the Work Ratio has a particular value. 工作时间比率只有当JIRA管理员 开启了时间跟踪(链接到)才有效 按照指定的工作时间比率的值搜索问题。 工作时间比率的计算公式是: 工作时间比率 = 实际工作时间 / 初始预估时间Work Ratio is calculated as follows: workRatio = #timeSpent / #originalEstimate) x 100 Note: this field does not support #auto-complete. 注意: 这个字段不支持自动完成。 语法
字段类型数值 NUMBER 支持的运算符
支持的函数n/a 示例示例
|
锚 | ||||
---|---|---|---|---|
|
锚 | ||||
---|---|---|---|---|
|
...
函数参考
内容区目录 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
级联选择列表值 cascadeOption()Search for issues that match the selected values of a 'cascading select' custom field. The parentOption parameter matches against the first tier of options in the cascading select field. The childOption parameter matches against the second tier of options in the cascading select field, and is optional. 按照 自定义字段中设置的 '级联选择列表'值来查找问题。 一级列表值 是必选参数。 二级列表值 是可选参数。 关键字 语法
or 或者
Supported Field Types支持的字段类型级联选择列表 CASCADING_OPTION 支持的运算符
示例
模块负责人 componentsLeadByUser()Find issues in components that are lead by a specific user. You can optionally specify a user, or if the user is omitted the current user (i.e. you) will be used. 查找指定模块负责人负责的问题。 如果你没有输入用户参数, JIRA会将当前用户(你)作为默认条件。 如果你没有登录JIRA, 必须指定用户。Note that if you are not logged in to JIRA, a user must be specified. 语法
or 或
Supported Field Types支持的字段类型模块 COMPONENT 支持的运算符
示例示例
当前用户进程 currentLogin()Perform searches based on the time at which the current user's session began. See also #lastLogin. 按照当前用户进程搜索问题。 还可以查阅 上次进程。 语法
Supported Field Types支持的字段类型日期 DATE 支持的运算符
示例
当前用户 currentUser()按照当前用户查找问题。 只有登录用户才能使用这个函数。所以匿名用户创建的过滤器无法使用这个函数。 Perform searches based on the currently logged-in user. Note that this function can only be used by logged-in users. So if you are creating a saved filter that you expect to be used by anonymous users, do not use this function. 语法
Supported Field Types支持的字段类型用户 USER 支持的运算符
示例
最近查看的问题 issueHistory()Find issues that you have recently viewed, i.e. issues that are in the 'Recent Issues' section of the 'Issues' drop-down menu. 查看你最近查看的问题, 就是在页面顶部菜单导航栏 '问题'菜单下的'最近查看的问题'中的问题。 注意Note:
语法
Supported Field Types支持的字段类型问题 ISSUE 支持的运算符
示例
用户上次进程 lastLogin()Perform searches based on the time at which the current user's previous session began. See also #currentLogin. 按照当前用户上次进程搜索问题。还可以查阅 当前进程。 语法
Supported Field Types支持的字段类型日期 DATE 支持的运算符
示例
链接的问题 linkedIssues()Perform searches based on issues which are linked to a specified issue. 查找问题的 链接 作为条件查找问题。 你可以指定链接类型作为查询条件,注意链接类型大小写敏感。You can optionally restrict the search to links of a particular type. Note that LinkType is case-sensitive. 语法
or 或者
Supported Field Types支持的字段类型问题 ISSUE 支持的运算符
示例
是...的成员 membersOf()Perform searches based on the members of a particular group. 按照指定用户组成员来查找问题。 语法
Supported Field Types支持的字段类型用户 USER 支持的运算符
示例
当前时间 now()Perform searches based on the current time. 以当前时间为搜索条件。 语法
Supported Field Types支持的字段类型日期 DATE 支持的运算符
示例
项目负责人 projectsLeadByUser()Find issues in projects that are lead by a specific user. You can optionally specify a user, or if the user is omitted the current user will be used. 查找指定项目负责人负责的问题。 你可以指定一个用户,或者不指定用户,JIRA会自动按照当前用户查找。 如果你没有登录JIRA, 你必须指定一个用户来执行这个函数。Note that if you are not logged in to JIRA, a user must be specified. 语法
or 或者
Supported Field Types支持的字段类型项目 PROJECT 支持的运算符
示例
你拥有的项目权限 projectsWhereUserHasPermission()Find issues in projects where you have a specific permission. 按照你拥有的项目 权限查找问题。 只有登录到JIRA后才能使用这个函数。Note that this function is only available if you are logged in to JIRA. 语法
For the 包含页面 | | quickstart:__project permissions | quickstart:__project permissions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
nopanel | true |
包含页面 | ||||||
---|---|---|---|---|---|---|
|
示例
示例
查找你拥有
- Find open issues in projects where you have the
"Resolve Issues"权限的项目中,状态"Open"
permission的问题:
代码块 project in projectsWhereUserHasPermission("Resolve Issues") AND status = Open
锚 | ||||
---|---|---|---|---|
|
你属于的项目角色 projectsWhereUserHasRole()
Find issues in projects where you have a specific role.
按照你属于指定的 项目角色搜索问题。
注意只有登录JIRA后才能使用这个函数。Note that this function is only available if you are logged in to JIRA.
语法
代码块 |
---|
projectsWhereUserHasRole(rolename) |
Supported Field Types
支持的字段类型
项目 PROJECT
支持的运算符
包含页面 | ||||||
---|---|---|---|---|---|---|
|
示例
- Find open issues in projects where you have the
查找你作为 "Developers" 角色的项目中状态为"Open"
role的问题:
代码块 project in projectsWhereUserHasRole("Developers") AND status = Open
锚 | ||||
---|---|---|---|---|
|
已发布版本 releasedVersions()
Perform searches based on the released versions (i.e. versions that your JIRA administrator has released) of a specified project.
查找指定项目中已发布版本的问题。
如果没有输入 项目 参数,就会搜索所有项目的已发布版本的问题。You can also search on the released versions of all projects, by omitting the project parameter.
语法
代码块 |
---|
releasedVersions() |
or 或
代码块 |
---|
releasedVersions(project) |
Supported Field Types
支持的字段类型
版本 VERSION
支持的运算符
包含页面 | ||||||
---|---|---|---|---|---|---|
|
示例
- Find issues whose #FixVersion is a released version of the ABC project
查找项目 ABC 中所有 修复版本(FixVersion)#FixVersion 已经发布的问题:
代码块 fixVersion in releasedVersions(ABC)
- Find issues that relate to released versions of the ABC project
查找项目 ABC 中所有影响版本和修复版本已经发布的问题 :
or代码块 affectedVersion in releasedVersions(ABC)
或
代码块 fixVersion in releasedVersions(ABC)
锚 | ||||
---|---|---|---|---|
|
标准问题类型 standardIssueTypes()
Perform searches based on "standard" Issue Types, that is, search for issues which are not sub-tasks. 按照"标准" 问题类型查找问题。标准问题类型指的是非 子任务的问题。
语法
代码块 |
---|
standardIssueTypes() |
Supported Field Types
支持的字段类型
问题类型 ISSUE_TYPE
支持的运算符
包含页面 | ||||||
---|---|---|---|---|---|---|
|
示例
|
示例
查找非子任务类型的问题 (标准问题类型的问题,不是子任务问题类型
- Find issues that are not subtasks (i.e. issues whose Issue Type is a standard issue type, not a subtask issue type
):
代码块 issuetype in standardIssueTypes()
锚 | ||||
---|---|---|---|---|
|
子任务问题类型 subtaskIssueTypes()
Perform searches based on issues which are sub-tasks. 查找所有子任务问题。
语法
代码块 |
---|
subtaskIssueTypes() |
Supported Field Types
支持的字段类型
问题类型 ISSUE_TYPE
支持的运算符
包含页面 | ||||||
---|---|---|---|---|---|---|
|
示例
- Find issues that are subtasks (i.e. issues whose Issue Type is a subtask issue type
查找所有子任务问题 (问题类型是子任务类型):
代码块 issuetype in subtaskIssueTypes()
锚 | ||||
---|---|---|---|---|
|
未发布版本 unreleasedVersions()
Perform searches based on the unreleased versions (i.e. versions that your JIRA administrator has not yet released) of a specified project.
查找指定项目中未发布版本的问题。
如果没有输入 项目 参数,就会搜索所有项目的已发布版本的问题。You can also search on the unreleased versions of all projects, by omitting the project parameter.
语法
代码块 |
---|
unreleasedVersions() |
or 或
代码块 |
---|
unreleasedVersions(project) |
Supported Field Types
支持的字段类型
版本 VERSION
支持的运算符
包含页面 | ||||||
---|---|---|---|---|---|---|
|
示例
- Find issues whose #FixVersion is an unreleased version of the ABC project
查找ABC项目中修复版本(FixVersion)还未发布的问题:
代码块 fixVersion in unreleasedVersions(ABC)
- Find issues that relate to unreleased versions of the ABC project
查找ABC项目中影响版本和修复版本尚未发布的问题:
代码块 affectedVersion in unreleasedVersions(ABC)
or
代码块 fixVersion in unreleasedVersions(ABC)
锚 | ||||
---|---|---|---|---|
|
投票的问题 votedIssues()
Perform searches based on issues for which you have voted. Also see the #Voter field.
查看你已投票的问题 。 请查阅 投票人(Voter)字段。
只有登录用户才能使用这个函数。Note that this function can only be used by logged-in users.
语法
代码块 |
---|
votedIssues() |
Supported Field Types
支持的字段类型
问题 ISSUE
支持的运算符
包含页面 | ||||||
---|---|---|---|---|---|---|
|
示例
- Find issues that you have voted for
查找你投票的问题:
代码块 issue in votedIssues()
锚 | ||||
---|---|---|---|---|
|
watchedIssues()
Perform searches based on issues which you are watching. Also see the #Watcher field.
关注的问题 watchedIssues()
查找你 正在关注的问题。 请查看 关注人(Watcher)字段。
只有登录用户才能使用这个函数。Note that this function can only be used by logged-in users.
语法
代码块 |
---|
watchedIssues() |
Supported Field Types
支持的字段类型
问题 ISSUE
支持的运算符
包含页面 | ||||||
---|---|---|---|---|---|---|
|
示例
- Find issues that you are watching
查找你关注的问题:
代码块 issue in watchedIssues()
Supported Field Types
支持的字段类型
问题 ISSUE
支持的运算符
包含页面 | ||||||
---|---|---|---|---|---|---|
|
示例
- Find issues that you have recently viewed:
代码块 issue in issueHistory()
...
|
锚 | ||||
---|---|---|---|---|
|
控制运算顺序
你可以在复杂的JQL语句中使用括号来控制 运算符的运算顺序。
例如, 如果你想查找SysAdmin项目中所有问题解决的问题,或者分配给系统管理员(bobsmith)的问题, 你可以使用括号来控制运算顺序, 例如
...
Setting Precedence of Operators
You can use parentheses in complex JQL statements to enforce the precedence of #operators.
For example, if you want to find all resolved issues in the SysAdmin project as well as all issues (any status, any project) currently assigned to the system administrator (bobsmith), you can use parentheses to enforce the precedence of the boolean operators in your query, i.e.:
代码块 |
---|
(status=resolved AND project=SysAdmin) OR assignee=bobsmith |
Note that if you do not use parentheses, the statement will be evaluated left-to-right.
如果你不使用括号, 表达式运算顺序将从左到右逐一运算。
你也可以使用括号将表达式分组, 方便地在表达式前使用否定(NOT)运算符,否定整个表达式的结果。You can also use parentheses to group clauses, so that you can apply the #NOT operator to the group.
锚 | ||||
---|---|---|---|---|
|
Performing Text Searches
You can use Lucene's text-searching features when performing searches on the following fields, using the #CONTAINS operator:
- #Summary
- #Description
- #Environment
- #Comments
- #custom fields of type 'text'
For details, please see the page on Performing Text Searches, which includes the following sections:
...
执行文本搜索
当搜索下面的文本字段时,你可以在查询表达式中使用包括这样的 Lucene 文本搜索特性运算符:
更多详细说明, 请查看 搜索文本页面, 该页面包括以下章节:
...
锚 | ||||
---|---|---|---|---|
|
...
|
...
使用自动完成
当你输入以下条件的查询语句时, JIRA 会自动根据上下文提供一些建议As you type your query, JIRA will recognise the context and offer a list of "auto-complete" suggestions as follows:
内容区目录 | ||||||
---|---|---|---|---|---|---|
| ||||||
The list of auto-complete suggestions is displayed alphabetically and includes the first 15 matches. Note that auto-complete suggestions are not offered for #function parameters. 建议列表按照字母顺序提供最多15个可选项。JIRA不会提供函数参数的自动完成建议列表。
Auto-complete suggestions are not offered for all fields. Check the #fields reference to see which fields support auto-complete. If you type a space at the start of your query不是所有字段都提供自动完成建议列表。 点击 字段 参考查看哪些字段支持自动完成。 如果你在查询语句的起始输入了空格......JIRA will offer a list of all available fields, e.g.会自动提供所有可用字段的列表, 例如: If you type one or more characters 如果你输入了超过1个字符......JIRA will offer a list of matching fields, e.g.会列出可能匹配的字段列表, 例如: If you type a field then a space 如果你输入了一个字段并输入了空格......JIRA will offer a list of valid #operators, e.g.会列出可用的 运算符列表, 例如: If you type a field, then an operator, then a space 如果你输入了一个字段, 接着输入了一个运算符, 然后又输入了一个空格......JIRA will offer a list of valid values, e.g.会提供有效的字段值列表, 例如: If you type a field, then an operator, then one or more characters 如果你输入了一个字段, 接着输入了一个运算符, 然后又输入了1个字符......JIRA will offer a list of valid values (if your #field supports this) and 会提供可用字段值的列表 (如果你输入的 字段 值支持列表) 以及可用的and valid functions for the field/operator combination, e.g.: |
锚 | ||||
---|---|---|---|---|
|
...
在 '
...
高级搜索'
...
和 '
...
简单搜索'
...
模式之间切换
In general, a query created using 'Simple Search' will be able to be translated to 'Advanced Search' (i.e. JQL), and back again.
However, a query created using 'Advanced Search' may not be able to be translated to 'Simple Search', particular if:
一般情况下, 使用'简单搜索' 模式的查询条件都可以翻译为 '高级搜索(JQL)'查询条件, 也可以反向翻译。
然而, 使用'高级搜索' 创建的查询条件不一定能够翻译成 '简单搜索'的查询条件, 特别是:
- 查询语句中包括 或者(OR) 运算符 (但是在...之内(IN)运算符可以被翻译成简单模式查询条件, 如 the query contains an OR operator (note you can have an IN operator and it will be translated, e.g.
project in (A, B)
)- i.e. even though this query虽然这个查询语句:
(project = JRA OR project = CONF)
is equivalent to this query 与这个查询语句:(project in (JRA, CONF))
, only the second query will be translated.
- i.e. even though this query虽然这个查询语句:
- the query contains a NOT operator
- the query contains an EMPTY operator
- 一样, 但是只有第二个查询语句才能被翻译成简单搜索语句。
- 查询语句中包含 NOT 运算符
- 查询语句中包含 EMPTY 运算符
- 查询语句中包括比较运算符the query contains any of the comparison operators: !=, IS, IS NOT, >, >=, <, <=
- 查询语句中指定了与项目有密切关系的字段和字段值 (例如 版本, 模块, 自定义字段),但是又没有在查询条件中明确地指定项目 (例如,只输入了the query specifies a field and value that is related to a project (e.g. version, component, custom fields) and the project is not explicitly included in the query (e.g.
fixVersion = "4.0"
, without the 而没有输入AND project=JRA
). This is especially tricky with custom fields since they can be configured on a Project/Issue Type basis. The general rule of thumb is
that if the query cannot be created in the 'Simple Search' form, then if it is created using 'Advanced Search' it will not be able to be translated to 'Simple Search'. , 尤其是设置了项目/问题类型的自定义字段。
查询语句翻译的标准规则是:
如果查询语句无法在 '简单搜索' 模式中设置, 而需要在 '高级搜索' 模式中输入的查询语句,是无法翻译为'简单搜索' 查询条件的。
锚 | ||||
---|---|---|---|---|
|
保留的字符
...
信息 |
---|
你既可以使用单引号 ( |
如果搜索条件中包含引号, 你需要在引号前加上转义符(反斜线), 例如If your search term contains a quote-mark, you will need to precede it with the escape character (back-slash), e.g.:
代码块 |
---|
"Type your name in the \"Login\" box" |
If you use a single quote to escape your search term, then you can use the double quote (without escaping it) inside the single quotes; but you will have to escape any other single quotes. And vice-versa.
如果你的搜索条件中包含单引号, 那么你就可以在单引号里面使用双引号(不需要转义符); 但是你必须为其他单引号添加转义符,反之亦然。
注意有一些附加的 文本搜索保留字符在以下字段中应用Note that there is an additional list of reserved characters for Text Searches, which applies to the following fields:
包含页面 | ||||||
---|---|---|---|---|---|---|
|
...
(JIRA管理员请注意: 上面列表是 JqlStringSupportImpl.java
文件的固定编码。)
注意还有一些其他 文本搜索的保留字段, which applies to the following fields 在下面的字段中应用:
包含页面 | ||||||
---|---|---|---|---|---|---|
|