与 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的所有问题:

  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

等于: =

"=" 运算符用于查找精确匹配字段值的问题。 (注意: 不能用于 文本 字段; 文本字段的匹配条件请使用 包含 运算符。)

要精确匹配多个字段值，请使用与(AND)将多个 "=" 表达式连接起来。

示例

• 查找由jsmith创建的所有问题:

  reporter = jsmith

• 查找由John Smith创建的所有问题:

  reporter = "John Smith"

不等于: !=

"!=" 运算符用于查找不等于指定字段值之外的问题。 (注意: 不能用于 文本 字段; 文本字段的否定条件请使用 不包含 ("!~") 运算符。)

注意输入 field != value 与输入 NOT field = value}}具有同等效果, 并且 {{field != EMPTY 与 {{field IS_NOT EMPTY}}也具有同等效果。

示例

• 查找所有已经被分配经办人，但是经办人不是jsmith的问题:

  not assignee = jsmith

  or:

  assignee != jsmith

• 查找报告人不是jsmith的所有问题:

  reporter !=jsmith

• 查找你报告的，但经办人没有被分配给你的问题:

  reporter = currentUser() and assignee != currentUser()

• 查找已经被分配经办人，但报告人或经办人不是John Smith的问题:

  assignee != "John Smith" or reporter != "John Smith"

• 查找所有还没有分配经办人的问题:

  assignee is not empty

  或

  assignee != null

大于: >

">" 运算符用于差咋后比指定字段值大的问题。 不能用于 文本 字段。

注意 ">" 运算符只能用于支持排序的字段 (例如 日期字段和版本字段等)。 要了解字段支持哪些运算符, 请查看每个 字段 参考。

示例

• 查找所有投票数大于4的问题:

  votes > 4

• 查找所有逾期未解决的问题:

  duedate < now() and resolution is empty

• 查找所有优先级高于 "Normal"的问题:

  priority > normal

大于等于: >=

">=" 运算符用于查找大于等于指定字段值的问题。不能用于 文本 字段。

注意 ">=" 运算符只能用于支持排序的字段 (例如 日期字段和版本字段等)。 要了解字段支持哪些运算符, 请查看每个 字段 参考。

示例

• 查找所有投票数大于等于 4 的问题:

  votes >= 4

• 查找到期日大于等于 31/12/2008 的问题:

  duedate >= "2008/12/31"

• 查找过去5天内创建的问题:

  created >= "-5d"

小于: <

The "<" 运算符用于搜索小于指定字段值的问题。 不能用于 文本 字段。

注意"<" 运算符只能用于支持排序的字段 (例如 日期字段和版本字段等)。 要了解字段支持哪些运算符, 请查看每个 字段 参考。

示例

• 查找所有投票数小于 4 的问题:

  votes < 4

小于等于: <=

The "<=" 运算符用于搜索小于等于指定字段值的问题。 不能用于 文本 字段。

注意 "<=" 运算符只能用于支持排序的字段 (例如 日期字段和版本字段等)。 要了解字段支持哪些运算符, 请查看每个 字段 参考。

示例

• 查找所有投票数小于等于 4的问题:

  votes <= 4

• 查找过去一个月(30天)内没有更新的问题:

  updated <= "-4w 2d"

在...之内 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

包含: ~

"~" 运算符用于匹配指定字段值的问题 (也可以使用精确匹配或 "模糊" 匹配 — 查看下面的示例)。 只能用于文本字段, 例如:

• 主题(Summary)
• 描述(Description)
• 环境(Environment)
• 备注(Comments)
• 自定义 字段用于 "自由文本搜索器"; 包括下面的 自定义字段类型
  • 自由文本字段 (无限制文本)
  • 文本字段 (< 255 字符)
  • 只读文本字段

注意: 使用 "~" 运算符, 在运算符右侧的字段值可以使用 JIRA 文本搜索语法。

示例

• 查找主题中包括"full screen"词组的问题:

  summary ~ "\"full screen\""

• 查找主题中包括 "win"单词 (或其衍生单词, 比如 "windows" 或 "winning")的问题:

  summary ~ win

不包括: !~

"!~" 运算符用于模糊匹配不包含指定字符的问题。 只能用于文本字段, 例如:

• 主题(Summary)
• 描述(Description)
• 环境(Environment)
• 备注(Comments)
• 自定义 字段用于 "自由文本搜索器"; 包括下面的 自定义字段类型
  • 自由文本字段 (无限制文本)
  • 文本字段 (< 255 字符)
  • 只读文本字段

注意: 使用 "!~" 运算符, 在运算符右侧的字段值可以使用 JIRA 文本搜索语法。

示例

• 查找主题中不包括 "run"单词的问题 (或其衍生单词, 比如 "running" 或 "ran"):

  summary !~ run

是 IS

"IS" 运算符只能与 空(EMPTY) 或 空(NULL)结合使用。 也就是说搜索指定字段没有赋值的问题。

注意不是所有的 字段 都可以使用这个运算符; 分别查看所有的 字段 参考了解具体用法。

示例

• 查找修复版本没有赋值的所有问题:

  fixVersion is empty

  或

  fixVersion is null

不是 IS NOT

"IS NOT" 运算符只能与 空(EMPTY) 或 空(NULL)结合使用。也就是说搜索指定字段已经被赋值的问题。

注意不是所有的 字段 都可以使用这个运算符; 分别查看所有的 字段 参考了解具体用法。

示例

• 查找所有被投票的问题:

  votes is not empty

  或

  votes is not null

影响版本

搜索指定影响版本的问题。 你可以按照版本名称或版本ID(JIRA自动为版本分配的数值)搜索 。

注意: 这个字段支持 自动完成。

语法

affectedVersion

字段类型

版本 VERSION

支持的操作符

注意比较运算符 (如 ">") 使用 版本排序 只按照JIRA管理员设置的顺序, 而不按照数值或字母顺序。

支持的函数

当使用 在...之内(IN) 和 不在...之内(NOT IN) 运算符时, affectedVersion 支持:

• 已发布版本 releasedVersions()
• 未发布版本 unreleasedVersions()

示例

• 查找影响版本是 3.14的问题:

  affectedVersion = "3.14"

  (注意点(.)是保留 字符, 所以你需要用引号括起来。)

• 查找影响版本是"Big Ted"的问题:

  affectedVersion = "Big Ted"

• 查找影响版本ID是 10350的问题:

  affectedVersion = 10350

经办人

搜索经办人是指定用户的问题。 你可以使用用户全名、ID或电子邮件地址。

注意: 这个字段支持 自动完成。

语法

assignee

字段类型

用户 USER

支持的运算符

支持的函数

当使用 IN 和 NOT_IN 运算符时, assignee 支持:

• 是...的成员 membersOf()

当使用 等于 和 不等于 运算符时, assignee 支持:

• 当前用户 currnetUser()

示例

• 搜索分配给John Smith的问题:

  assignee = "John Smith"

  或

  assignee = jsmith

• 搜索经办人邮件地址是 "bob@mycompany.com"的问题:

  assignee = "bob@mycompany.com"

  (注意句号(.)和 "@" 符号是保留 字符, 所以需要用引号将邮件地址括起来。)

类别

搜索属于指定项目类别的项目下的所有问题。

注意: 这个字段支持 自动完成。

语法

category

字段类型

类别 CATEGORY

支持的运算符

支持的函数

n/a

示例

• 搜索属于 "内部项目"类别下的所有问题:

   category = "内部项目"

备注

搜索备注中包含指定字符的问题。

可以使用JIRA 文本搜索语法 。

注意: 这个字段不支持 自动完成。

语法

comment

字段类型

文本 TEXT

支持的运算符

支持的函数

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自动分配给模块的数字)搜索。

注意: 这个字段支持自动完成。

语法

component

字段类型

模块 COMPONENT

支持的运算符

支持的函数

当使用 在...之内(IN) 和 不在...之内(NOT IN) 运算符时, component 支持:

• 模块负责人 componentsLeadByUser()

示例

• 查找模块是 "Comp1" 或 "Comp2" 的问题:

   component in (Comp1, Comp2)

• 查找模块是 "Comp1" 并且 也是"Comp2" 的问题:

   component in (Comp1) and component in (Comp2)

  或

   component = Comp1 and component = Comp2

• 查找模块ID是 20500的问题:

  component = 20500

创建日期

按照指定的创建日期范围搜索问题。

注意: 这个字段不支持 自动完成。

语法

created

或者:

createdDate

字段类型

日期 DATE

支持的运算符

支持的函数

当使用 等于, 不等于, 大于, 大于等于, 小于 或 小于等于 运算符时, createdDate 支持:

• 当前用户进程 currentLogin()
• 当前用户上次进程 lastLogin()
• 当前时间 now()

示例

• 查找2008年12月12日 00:00之前创建的问题(包括00:00):

  created <= "2008/12/12"

• 查找1天以前创建的问题:

  created > "-1d"

• 查找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自动为自定义字段分配的数值)搜索。

注意:

• JIRA文本搜索语法 可以用于'文本'类型的自定义字段。
• 自动完成 支持选择器类型、用户组选择器类型, 选择列表类型 (不包括 '级联选择类型'), 复选框类型和单选按钮类型的自定义字段。

语法

CustomFieldName

或者:

cf[CustomFieldID]

字段类型

依赖于自定义字段的配置。

支持的运算符

不同类型的自定义字段支持不同的 运算符。 对于默认的自定义字段, 支持下面的运算符:

• 数值和日期/时间类型字段:

  =	!=	~	!~	>	>=	<	<=	IS	IS NOT	IN	NOT IN

• 选择器, 选择列表, 复选框和单选按钮类型字段:

  =	!=	~	!~	>	>=	<	<=	IS	IS NOT	IN	NOT IN

• 文本类型字段:

  =	!=	~	!~	>	>=	<	<=	IS	IS NOT	IN	NOT IN

支持的函数

不同类型的自定义字段支持不同的 函数。 对于默认的自定义字段, 支持下面的函数:

• 日期/时间类型字段: 当前用户进程 currentLogin(), 当前用户上次进程 lastLogin() 以及 当前时间 now() (当使用除了 是 (IS) 或 不是 (IS NOT)之外的其他运算符时)
• 版本选择器类型字段: 已发布版本 releasedVersions() 和 未发布版本 unreleasedVersions() (当使用 在...之内(IN) 和 不在...之内 (NOT IN) 运算符时)

示例

• 查找自定义字段 "Location" 的值为 "New York"的问题:

  location = "New York"

• 查找自定义字段ID 10003的值为"New York"的问题:

  cf[10003] = "New York"

• 查找自定义字段"Location"的值为 "London" 或 "Milan" 或 "Paris"的问题:

  cf[10003] in ("London", "Milan", "Paris")

• 查找自定义字段"Location"的值不为空的问题:

  location != empty

描述

搜索 描述中包含指定字符的问题。

可以使用JIRA文本搜索语法。

注意: 这个字段不支持 自动完成。

语法

description

字段类型

文本 TEXT

支持的运算符

支持的函数

n/a

示例

• 模糊搜索描述中包含 "Please see screenshot" 的问题:

  description ~ "Please see screenshot"

• 精确搜索描述中包含 "Please see screenshot" 的问题:

  description ~ "\"Please see screenshot\""

逾期日期 Due

按照问题的逾期日期范围搜索问题。

注意逾期日期只能根据 日期 计算 (不能根据时间计算)。

注意: 这个字段不支持 自动完成。

语法

due

或者:

dueDate

字段类型

日期 DATE

支持的运算符

支持的函数

当使用 等于, 不等于, 大于, 大于等于, 小于 或 小于等于 运算符时, dueDate 支持:

• 当前用户进程 currentLogin()
• 当前用户上次进程 lastLogin()
• 当前时间 now()

示例

• 搜索截止2009年1月1日逾期的问题:

  due <= "2008/12/31"

• 查找明天到期的问题:

  due = "1d"

• 查找2009年1月到期的问题:

  due > "2008/12/31" and due < "2009/02/01"

• 查找2009年1月15日到期的问题:

  due > "2009/01/14" and due < "2009/01/16"

环境

搜索 环境 字段中包含指定字符的问题。

可以使用JIRA文本搜索语法。

注意: 这个字段不支持 自动完成。

语法

environment

字段类型

文本 TEXT

支持的运算符

支持的函数

n/a

示例

• 模糊搜索环境中包括 "Third floor"的问题:

  environment ~ "Third floor"

• 精确匹配环境中包含"Third floor"的问题:

  environment ~ "\"Third floor\""

过滤器

你可以直接在JQL中使用 保存的过滤器 。 可以使用过滤器名称或过滤器ID(JIRA自动为过滤器分配的数值)搜索。

注意:

• 输入的查询语句中的 排序 (ORDER BY) 表达式将会代替过滤器中的 ORDER BY 表达式。
• 你不能执行或保存一个无限循环的过滤器 (例如 当一个被引用的过滤器中又引用的当前的过滤器，是无法执行的。)。
• 这个字段支持 自动完成。

  语法

  filter

  或者:

  request

  savedFilter

  searchRequest

字段类型

过滤器 FILTER

支持的运算符

支持的函数

n/a

示例

• 返回过滤器 "My Saved Filter" (过滤器ID是 12000)中经办人是jsmith的问题:

  filter = "My Saved Filter" and assignee = jsmith

  或

  filter = 12000 and assignee = jsmith

修复版本

按照指定的 修复版本搜索问题。 你可以使用版本名称或版本ID (JIRA自动为版本分配的数值)搜索。

注意: 这个字段支持自动完成。

语法

fixVersion

字段类型

版本 VERSION

支持的运算符

注意比较运算符 (如 ">") 使用 版本排序 只按照JIRA管理员设置的顺序, 而不按照数值或字母顺序。

支持的函数

当使用 在...之内(IN) 和 不在...之内(NOT IN) 运算符时, fixVersion 支持:

• 已发布版本 releasedVersions()
• 未发布版本 unreleasedVersions()

示例

• 查找修复版本是 3.14 或 4.2的问题:

   fixVersion in ("3.14", "4.2")

  (注意句号(.)是JIRA保留 字符, 所以你需要用引号将其括起来。)

• 查找修复版本是 "Little Ted"的问题:

  fixVersion = "Little Ted"

• 查找修复版本ID 是10001的问题:

  fixVersion = 10001

问题键值

按照指定的 问题键值 或问题ID (JIRA自动为问题分配的数值)。

注意: 这个字段不支持 自动完成。

语法

issueKey

或者:

id

issue

key

字段类型

问题 ISSUE

支持的运算符

支持的函数

当使用 在...之内(IN) 或 不在...之内(NOT IN) 运算符时, issueKey 支持:

• 最近查看的问题 issueHistory()
• 链接的问题 linkedIssues()
• 被投票的问题 votedIssues()
• 被关注的问题 watchedIssues()

示例

• 查找键值是 "ABC-123"的问题:

  issueKey = ABC-123 

安全级别

只有当JIRA管理员 开启了问题安全级别时才有效

按照指定的 安全级别搜索问题。 你可以按照问题安全级别或问题安全级别ID(JIRA自动为问题安全级别分配的数值)搜索。

注意: 这个字段支持自动完成。

语法

level

字段类型

安全级别 SECURITY LEVEL

支持的运算符

支持的函数

n/a

示例

• 搜索安全级别是 "Really High" 或 "level1"的问题:

  level in ("Really High", level1)

• 搜索安全级别ID 是123的问题:

  level = 123

初始预估时间

只有JIRA管理员 开启了时间跟踪 才有效

按照 初始预估时间 的值(只能是数字, 不能是日期或日期范围)搜索问题

使用 "w", "d", "h" 和 "m" 来指定周, 日, 小时或分钟。

注意: 这个字段不支持 自动完成。

语法

originalEstimate

或者:

timeOriginalEstimate

字段类型

期间 DURATION

支持的运算符

支持的函数

n/a

示例

• 查找初始预估时间为1小时的问题:

  originalEstimate = 1h

• 查找初始预估时间大于2天的问题:

  originalEstimate > 2d

父问题

只有当JIRA管理员 开启子任务(连接到Atlassian网站) 才有效

搜索指定问题的所有 子任务。 你可以按照 问题键值 或问题ID (JIRA自动为问题分配的数值)搜索。

注意: 这个字段不支持 自动完成。

语法

parent

字段类型

问题 ISSUE

支持的运算符

支持的函数

n/a

示例

• 搜索问题 TEST-1234的所有子任务:

  parent = TEST-1234

优先级

按照指定的 优先级搜索问题。 你可以使用优先级名称或优先级ID (JIRA自动为优先级分配的数值)搜索。

注意: 这个字段支持自动完成。

语法

priority

字段类型

优先级 PRIORITY

支持的运算符

支持的函数

n/a

示例

• 搜索优先级时 "High"的问题:

   priority = High

• 搜索优先级ID是10000的问题:

  priority = 10000

项目

搜索指定 项目 中的问题。

你可以按照 项目名称, 或 项目键值 或项目ID (JIRA自动为项目分配的数值)搜索。

注意: 这个字段支持自动完成。

语法

project

字段类型

项目 PROJECT

支持的运算符

支持的函数

当使用 在...之内(IN) 和 不在...之内(NOT IN)运算符时, project 支持:

• 项目负责人 projectsLeadByUser()
• 用户拥有的项目权限 projectsWhereUserHasPermission()
• 用户拥有的项目角色 projectsWhereUserHasRole()

示例

• 查找项目名称是 "ABC Project"的问题:

   project = "ABC Project" 

• 查找项目键值是 "ABC"的问题:

  project = "ABC"

• 查找项目ID是 "1234"的问题:

  project = 1234

剩余预估时间

只有JIRA管理员 开启了时间跟踪 才有效

按照 剩余预估时间 的值(只能是数字, 不能是日期或日期范围)搜索问题

使用 "w", "d", "h" 和 "m" 来指定周, 日, 小时或分钟。

注意: 这个字段不支持 自动完成。

语法

remainingEstimate

或者:

timeEstimate

字段类型

期间 DURATION

支持的运算符

支持的函数

n/a

示例

• 查找剩余预估时间大于4小时的问题:

   remainingEstimate > 4h 

报告人

按照指定的报告人(创建人)搜索问题。

你可以按照用户全称、ID或邮件地址搜索。

注意: 这个字段支持自动完成。

语法

reporter

字段类型

用户 USER

支持的运算符

支持的函数

当使用 在...之内(IN) 或 不在...之内(NOT IN) 运算符时, reporter 支持:

• 是...的成员 membersOf()

当使用 等于 和 不等于 运算符时, reporter 支持:

• 当前用户 currentUser()

示例

• 搜索由Jill Johns创建的问题:

  reporter = "Jill Jones"

  或

  reporter = jjones

• 搜索报告人邮件地址是"bob@mycompany.com"的问题:

  assignee = "bob@mycompany.com"

  (注意句号(.)和 "@" 符号是JIRA保留 字符, 所以你需要用引号将其括起来。)

解决结果

按照指定的 解决结果搜索问题。

你可以将解决结果的名称和ID(JIRA自动为解决结果分配的数值)作为搜索条件。

注意: 这个字段支持自动完成。

语法

resolution

字段类型

解决结果 RESOLUTION

支持的运算符

支持的函数

n/a

示例

• 查找解决方法为"Cannot Reproduce" 或 "Won't Fix"的问题:

   resolution in ("Cannot Reproduce", "Won't Fix")

• 查找解决方法ID为5的问题:

  resolution = 5

• 查找还没有解决的问题:

  resolution = unresolved

解决日期

按照指定的解决日期或解决日期的范围查找问题。

注意: 这个字段不支持 自动完成。

语法

resolved

或者:

resolutionDate

字段类型

日期 DATE

支持的运算符

支持的函数

当使用 等于, 不等于, 大于, 大于等于, 小于 或 LESS_THAN_EQUALS 运算符时, resolved 支持:

• 当前用户进程 currentLogin()
• 当前用户上次进程 lastLogin()
• 当前时间 now()

示例

• 查找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"

• 查找前一小时之内解决的问题:

  resolved > -1h

状态

按照指定的 状态查找问题。

你可以按照状态名称或状态ID(JIRA自动为状态分配的数值)搜索问题。

注意: 这个字段支持自动完成。

语法

status

字段类型

状态 STATUS

支持的运算符

支持的函数

n/a

示例

• 查找状态是"Open"的问题:

   status = Open

• 查找状态ID 是1的问题:

  status = 1

主题

按照主题中指定的字符查找问题。

可以使用JIRA 文本搜索语法 。

注意: 这个字段不支持自动完成。

语法

summary

字段类型

文本 TEXT

支持的运算符

支持的函数

n/a

示例

• 模糊查找主题中包含 "Error saving file"的问题:

  summary ~ "Error saving file"

• 精确查找主题中包含 "Error saving file"的问题:

  summary ~ "\"Error saving file\""

文本

可以在以下文本字段内容中查找包含指定字符的问题:

• 主题(Summary)
• 描述(Description)
• 环境(Environment)
• 备注(Comments)
• 自定义 字段用于 "自由文本搜索器"; 包括下面的 自定义字段类型
  • 自由文本字段 (无限制文本)
  • 文本字段 (< 255 字符)
  • 只读文本字段

注意: text 只能和 包含 运算符 ("~" 以及 "!~")结合使用。

语法

text

字段类型

文本 TEXT

支持的运算符

支持的函数

n/a

示例

• 查找文本字段中包括"Fred"的问题:

  text ~ "Fred"

  or

  text ~ Fred

• 精确查找文本字段中包括"full screen"的问题:

  text ~ "\"full screen\""

问题类型

按照指定的 问题类型搜索问题

你可以按照问题类型名称或问题类型ID (JIRA自动为问题类型分配的数值)搜索问题。

注意: 这个字段支持自动完成。

语法

type

或者:

issueType

字段类型

问题类型 ISSUE_TYPE

支持的运算符

支持的函数

n/a

示例

• 查找问题类型是"Bug"的问题:

  type = Bug

• 查找问题类型是"Bug" 或 "Improvement"的问题:

   issueType in (Bug,Improvement)

• 查找问题类型ID是2的问题:

  issueType = 2

实际工作时间

只有当JIRA管理员 开启了时间跟踪(链接到)才有效

按照 实际工作时间 的值 (只能是数字，不能是日期或日期范围)搜索问题。

使用 "w", "d", "h" 和 "m" 来指定周, 日, 小时或分钟。

注意: 这个字段不支持自动完成。

语法

timeSpent

字段类型

期间 DURATION

支持的运算符

支持的函数

n/a

示例

• 查找实际工作时间大于5天的问题:

  timeSpent > 5d

更新日期

按照指定的日期或日期范围查找被更新的问题。

注意: 这个字段不支持自动完成。

语法

updated

或者:

updatedDate

字段类型

日期 DATE

支持的运算符

支持的函数

当使用 等于, 不等于, 大于, 大于等于, 小于 或 LESS_THAN_EQUALS 运算符时, updated 支持:

• 当前用户进程 currentLogin()
• 当前用户上次进程 lastLogin()
• 当前时间 now()

示例

• 查找2008年12月12日00:00之前更新的问题:

  updated <= "2008/12/12"

• 查找2周之前更新的问题:

  updated < "-2w"

• 查找2009年1月15日更新的问题:

  updated > "2009/01/14" and updated < "2009/01/16"

• 查找2009年1月更新的问题:

  updated > "2008/12/31" and updated < "2009/02/01"

投票人

按照指定的投票人查找问题。 你可以按照用户全名、ID 或电子邮件地址搜索。 需要注意的是，你必须拥有 "查看投票人及关注者"权限才能根据投票人搜索问题, 否则你只能搜索你自己投票的问题。具体内容参见 投票的问题。

注意: 这个字段支持自动完成。

语法

voter

字段类型

USER

支持的运算符

支持的函数

当使用 在...之内(IN)和不在...之内(NOT IN) 运算符时, voter 支持:

• 是...的成员 membersOf()

当使用 等于 以及 不等于 运算符时, voter 支持:

• 当前用户 currentUser()

示例

• 搜索你自己投票的问题:

  voter = currentUser()

• 搜索 "jsmith" 投票的问题:

  voter = "jsmith"

• 搜索用户组 "jira-developers"所有成员投票的问题:

  voter in membersOf("jira-developers")

投票数量

搜索指定投票数量的问题。

注意: 这个字段不支持自动完成。

语法

votes

字段类型

NUMBER

支持的运算符

支持的函数

n/a

示例

• 查找投票数大于等于12的问题:

  votes >= 12

关注人

按照指定关注人搜索问题。 你可以按照用户全称、ID或电子邮件地址搜索。 需要注意的是，你必须拥有 "查看投票人及关注者"权限才能根据关注人搜索问题, 否则你只能搜索你自己关注的问题。具体信息请参阅 关注的问题。

注意: 这个字段支持自动完成。

语法

voter

字段类型

USER

支持的运算符

支持的函数

当使用 在...之内(IN) 和 不在...之内(NOT IN) 运算符时, watcher 支持:

• 是...的成员 membersOf()

当使用 等于 和 不等于 运算符时, watcher 支持:

• 当前用户 currentUser()

示例

• 搜索你关注的问题:

  watcher = currentUser()

• 搜索 "jsmith" 关注的问题:

  watcher = "jsmith"

• 搜索用户组"jira-developers"的成员关注的问题:

  watcher in membersOf("jira-developers")

工作时间比率

只有当JIRA管理员 开启了时间跟踪(链接到)才有效

按照指定的工作时间比率的值搜索问题。

工作时间比率的计算公式是: 工作时间比率 = 实际工作时间 / 初始预估时间) x 100

注意: 这个字段不支持自动完成。

语法

workRatio

字段类型

数值 NUMBER

支持的运算符

支持的函数

n/a

示例

• 查找实际工作时间占初始预估时间百分比大于75%的问题:

   workRatio > 75

级联选择列表值 cascadeOption()

按照 自定义字段中设置的 '级联选择列表'值来查找问题。

一级列表值 是必选参数。 二级列表值 是可选参数。

关键字 "none" 可以用来搜索级联列表值为空的问题。

语法

cascadeOption(parentOption)

或者

cascadeOption(parentOption,childOption)

支持的字段类型

级联选择列表 CASCADING_OPTION

支持的运算符

示例

• 查找自定义字段 ("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()

查找指定模块负责人负责的问题。

如果你没有输入用户参数, JIRA会将当前用户(你)作为默认条件。

如果你没有登录JIRA, 必须指定用户。

语法

componentsLeadByUser()

或

componentsLeadByUser(username)

支持的字段类型

模块 COMPONENT

支持的运算符

示例

• 查看模块负责人是你，状态是Open的问题:

  component in componentsLeadByUser() AND status = Open

• 查看模块负责人是Bill，状态是Open的问题:

  component in componentsLeadByUser(bill) AND status = Open

当前用户进程 currentLogin()

按照当前用户进程搜索问题。 还可以查阅 上次进程。

语法

currentLogin()

支持的字段类型

日期 DATE

支持的运算符

示例

• 查找当前进程中创建的问题:

  created > currentLogin()

当前用户 currentUser()

按照当前用户查找问题。

只有登录用户才能使用这个函数。所以匿名用户创建的过滤器无法使用这个函数。

语法

currentUser()

支持的字段类型

用户 USER

支持的运算符

示例

• 查找分配给我的问题:

  assignee = currentUser()

• 查找我报告的但不是分配给我的问题:

  reporter = currentUser() and assignee != currentUser()

最近查看的问题 issueHistory()

查看你最近查看的问题, 就是在页面顶部菜单导航栏 '问题'菜单下的'最近查看的问题'中的问题。

注意:

• issueHistory() 只返回50个结果, 但是 '最近查看的问题' 只返回5个结果。
• 如果你没有登录JIRA, 只返回当前浏览器进程中浏览的问题。

语法

issueHistory()

支持的字段类型

问题 ISSUE

支持的运算符

示例

• 查找我最近查看的，并且分配给我的问题:

  issue in issueHistory() AND assignee = currentUser()

用户上次进程 lastLogin()

按照当前用户上次进程搜索问题。还可以查阅 当前进程。

语法

currentLogin()

支持的字段类型

日期 DATE

支持的运算符

示例

• 查找上次进程中创建的问题:

  created > lastLogin()

链接的问题 linkedIssues()

查找问题的 链接 作为条件查找问题。

你可以指定链接类型作为查询条件，注意链接类型大小写敏感。

语法

linkedIssues(issueKey)

或者

linkedIssues(issueKey,linkType)

支持的字段类型

问题 ISSUE

支持的运算符

示例

• 查找被ABC-123链接的问题:

  issue in linkedIssues(ABC-123)

• 查找被ABC-123链接，链接类型是"重复"的问题:

  issue in linkedIssues(ABC-123,"重复")

是...的成员 membersOf()

按照指定用户组成员来查找问题。

语法

membersOf(Group)

支持的字段类型

用户 USER

支持的运算符

示例

• 查找分配人是用户组 "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()

以当前时间为搜索条件。

语法

now()

支持的字段类型

日期 DATE

支持的运算符

示例

• 查找过期的未解决的问题:

  duedate < now() and status not in (closed, resolved) 

项目负责人 projectsLeadByUser()

查找指定项目负责人负责的问题。

你可以指定一个用户，或者不指定用户，JIRA会自动按照当前用户查找。

如果你没有登录JIRA, 你必须指定一个用户来执行这个函数。

语法

projectsLeadByUser()

或者

projectsLeadByUser(username)

支持的字段类型

项目 PROJECT

支持的运算符

示例

• 查找项目负责人是你的问题:

  project in projectsLeadByUser() AND status = Open

• 查找项目负责人是Bill，并且状态为Open的问题:

  project in projectsLeadByUser(bill) AND status = Open

你拥有的项目权限 projectsWhereUserHasPermission()

按照你拥有的项目 权限查找问题。

只有登录到JIRA后才能使用这个函数。

语法

projectsWhereUserHasPermission(permission)

查看具体的 权限 参数

支持的字段类型

项目 PROJECT

支持的运算符

示例

• 查找你拥有"Resolve Issues"权限的项目中，状态"Open"的问题:

  project in projectsWhereUserHasPermission("Resolve Issues") AND status = Open

你属于的项目角色 projectsWhereUserHasRole()

按照你属于指定的 项目角色搜索问题。

注意只有登录JIRA后才能使用这个函数。

语法

projectsWhereUserHasRole(rolename)

支持的字段类型

项目 PROJECT

支持的运算符

示例

• 查找你作为 "Developers" 角色的项目中状态为"Open"的问题:

  project in projectsWhereUserHasRole("Developers") AND status = Open

已发布版本 releasedVersions()

查找指定项目中已发布版本的问题。

如果没有输入 项目 参数，就会搜索所有项目的已发布版本的问题。

语法

releasedVersions()

或

releasedVersions(project)

支持的字段类型

版本 VERSION

支持的运算符

示例

• 查找项目 ABC 中所有 修复版本(FixVersion)#FixVersion 已经发布的问题:

  fixVersion in releasedVersions(ABC)

• 查找项目 ABC 中所有影响版本和修复版本已经发布的问题 :

  affectedVersion in releasedVersions(ABC)

  或

  fixVersion in releasedVersions(ABC)

标准问题类型 standardIssueTypes()

按照"标准" 问题类型查找问题。标准问题类型指的是非 子任务的问题。

语法

standardIssueTypes()

支持的字段类型

问题类型 ISSUE_TYPE

支持的运算符

示例

• 查找非子任务类型的问题 (标准问题类型的问题，不是子任务问题类型):

  issuetype in standardIssueTypes()

子任务问题类型 subtaskIssueTypes()

查找所有子任务问题。

语法

subtaskIssueTypes()

支持的字段类型

问题类型 ISSUE_TYPE

支持的运算符

示例

• 查找所有子任务问题 (问题类型是子任务类型):

  issuetype in subtaskIssueTypes()

未发布版本 unreleasedVersions()

查找指定项目中未发布版本的问题。

如果没有输入 项目 参数，就会搜索所有项目的已发布版本的问题。

语法

unreleasedVersions()

或

unreleasedVersions(project)

支持的字段类型

版本 VERSION

支持的运算符

示例

• 查找ABC项目中修复版本(FixVersion)还未发布的问题:

  fixVersion in unreleasedVersions(ABC)

• 查找ABC项目中影响版本和修复版本尚未发布的问题:

  affectedVersion in unreleasedVersions(ABC)

  or

  fixVersion in unreleasedVersions(ABC)

投票的问题 votedIssues()

查看你已投票的问题 。 请查阅 投票人(Voter)字段。

只有登录用户才能使用这个函数。

语法

votedIssues()

支持的字段类型

问题 ISSUE

支持的运算符

示例

• 查找你投票的问题:

  issue in votedIssues()

关注的问题 watchedIssues()

查找你 正在关注的问题。 请查看 关注人(Watcher)字段。

只有登录用户才能使用这个函数。

语法

watchedIssues()

支持的字段类型

问题 ISSUE

支持的运算符

示例

• 查找你关注的问题:

  issue in watchedIssues()

支持的字段类型

问题 ISSUE

支持的运算符

示例

• 查找最近刚刚查看过的问题:

  issue in issueHistory()

建议列表按照字母顺序提供最多15个可选项。JIRA不会提供函数参数的自动完成建议列表。

不是所有字段都提供自动完成建议列表。 点击 字段 参考查看哪些字段支持自动完成。

如果你在查询语句的起始输入了空格...

...JIRA 会自动提供所有可用字段的列表, 例如:

如果你输入了超过1个字符...

...JIRA 会列出可能匹配的字段列表, 例如:

如果你输入了一个字段并输入了空格...

...JIRA 会列出可用的 运算符列表, 例如:

如果你输入了一个字段, 接着输入了一个运算符, 然后又输入了一个空格...

...JIRA 会提供有效的字段值列表, 例如:

如果你输入了一个字段, 接着输入了一个运算符, 然后又输入了1个字符...

...JIRA 会提供可用字段值的列表 (如果你输入的 字段 值支持列表) 以及可用的and valid functions for the field/operator combination, e.g.: