与 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 #ISIS_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 EQUALS (=) 表达式, 但是使用起来更方便，更简短。 也就是说, 输入 reporter IN (tom, jane, harry) 与输入 {{reporter = "tom" #OR OR reporter = "jane" #OR 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" 运算符相当于多个 #NOTNOT_EQUALS (!=) 表达式, 但是使用起来更方便，更简短。也就是说，输入 reporter NOT IN (tom, jane, harry) 与输入 {{reporter != "tom" #AND AND reporter != "jane" #AND 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

包含: ~

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

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

示例

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

  代码块
  summary ~ "\"full screen\""

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

  代码块
  summary ~ win

不包括: !~

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

注意: 使用 "!~" 运算符, 在运算符右侧的字段值可以使用 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

支持的操作符

注意比较运算符 (如 ">") 使用 版本排序(链接到Atlassian网站) 只按照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 IN 和 #NOTNOT_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管理员已经创建了 自定义字段(链接到Atlassian网站)才有效

按照指定自定义字段值查找问题。

你可以按照自定义字段名称或自定义字段ID(JIRA自动为自定义字段分配的数值)搜索。

注意:

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

语法

CustomFieldName

或者:

cf[CustomFieldID]

字段类型

依赖于自定义字段(链接到Atlassian网站)的配置。

支持的运算符

不同类型的自定义字段支持不同的 运算符。 对于默认的自定义字段(链接到Atlassian网站), 支持下面的运算符:

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

  包含页面
  quickstartdoc:__JQL Operators supported by Numeric Fieldsquickstart doc:__JQL Operators supported by Numeric Fields nopanel true

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

  包含页面
  quickstartdoc:__JQL Operators supported by Select Fieldsquickstart doc:__JQL Operators supported by Select Fields nopanel true

• 文本类型字段:

  包含页面
  quickstartdoc:__JQL Operators supported by Text Fieldsquickstart doc:__JQL Operators supported by Text Fields nopanel true

支持的函数

不同类型的自定义字段支持不同的 函数。 对于默认的自定义字段(链接到Atlassian网站), 支持下面的函数:

• 日期/时间类型字段: 当前用户进程 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

支持的运算符

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

支持的函数

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

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

示例

• Find issues with a Fix Version of

  查找修复版本是 3.14

  or

  或 4.

  2

  2的问题:

  代码块
  fixVersion in ("3.14", "4.2")

  (

  Note that full-stops are reserved #characters, so they need to be surrounded by quote marks.)

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

• 查找修复版本是

  Find issues with a Fix Version of

  "Little Ted"的问题:

  代码块
  fixVersion = "Little Ted"

  Find issues with a
• Fix Version ID of 10001

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

  代码块
  fixVersion = 10001

Issue Key

Search 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.

语法

issueKey

Aliases或者:

id

issue

key

字段类型

问题 ISSUE

支持的运算符

支持的函数

When used with the #IN or #NOT_IN operators, issueKey supports: 当使用 在...之内(IN) 或 不在...之内(NOT IN) 运算符时, issueKey 支持:

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

示例

• Find the issue with key

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

  代码块
  issueKey = ABC-123

Level

Only 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自动为问题安全级别分配的数值)搜索。

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

语法

level

字段类型

安全级别 SECURITY LEVEL

支持的运算符

支持的函数

n/a

示例

• Search for issues with a Security Level of

  搜索安全级别是 "Really High"

  or

  或 "level1"的问题:

  代码块
  level in ("Really High", level1)

• Search for issues with a Security Level ID of 123

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

  代码块
  level = 123

Original Estimate

Only 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.

语法

originalEstimate

Alias或者:

timeOriginalEstimate

字段类型

期间 DURATION

支持的运算符

支持的函数

n/a

示例

• Find issues with an Original Estimate of 1 hour

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

  代码块
  originalEstimate = 1h

  Find issues with
• an Original Estimate of more than 2 days

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

  代码块
  originalEstimate > 2d

Parent

Only 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.

语法

parent

字段类型

问题 ISSUE

支持的运算符

支持的函数

n/a

示例

• Find issues that are sub-tasks of issue

  搜索问题 TEST-

  1234

  1234的所有子任务:

  代码块
  parent = TEST-1234

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

字段类型

优先级 PRIORITY

支持的运算符

支持的函数

n/a

示例

• Find issues with a Priority of

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

  代码块
  priority = High

  Find issues with a Priority
• ID of 10000:

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

  代码块
  priority = 10000

Project

Search 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

字段类型

项目 PROJECT

支持的运算符

支持的函数

When used with the #IN and #NOT_IN operators, project supports: 当使用 在...之内(IN) 和 不在...之内(NOT IN)运算符时, project 支持:

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

示例

• Find issues that belong to the Project that has the name "ABC Project"

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

  代码块
  project = "ABC Project"

  Find issues that belong to the Project that has the key

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

  代码块
  project = "ABC"

• Find issues that belong to the Project that has the ID

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

  代码块
  project = 1234

Remaining Estimate

Only 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.

日, 小时或分钟。

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

语法

remainingEstimate

Alias或者:

timeEstimate

字段类型

期间 DURATION

支持的运算符

支持的函数

n/a

示例

• Find issues with a Remaining Estimate of more than 4 hours

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

  代码块
  remainingEstimate > 4h

Reporter

Search 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.

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

语法

reporter

字段类型

用户 USER

支持的运算符

支持的函数

When used with the #IN and #NOT_IN operators, reporter supports:

• #membersOf()

When used with the #EQUALS and #NOT_EQUALS operators, reporter supports:

• #currentUser()

示例

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

• 是...的成员 membersOf()

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

• 当前用户 currentUser()

示例

• 搜索由Jill Johns创建的问题

• Search for issues that were created by Jill Jones

  :

  代码块
  reporter = "Jill Jones"

  or

  或

  代码块
  reporter = jjones

• Search for issues that were created by the user with email address

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

  代码块
  assignee = "bob@mycompany.com"

  (Note that full-stops and

  (注意句号(.)和 "@"

  symbols are reserved #characters, so the email address needs to be surrounded by quote-marks.

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

Resolution

Search for issues that have a particular Resolution

You can search by Resolution name or Resolution ID (i.e. the number that JIRA automatically allocates to a Resolution).

解决结果

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

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

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

语法

resolution

字段类型

解决结果 RESOLUTION

支持的运算符

支持的函数

n/a

示例

• Find issues with a Resolution of

  查找解决方法为"Cannot Reproduce"

  or

  或 "Won't Fix"的问题:

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

• Find issues with a Resolution ID of 5

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

  代码块
  resolution = 5

• Find issues that do not have a Resolution

  查找还没有解决的问题:

  代码块
  resolution = unresolved

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. 注意: 这个字段不支持 自动完成。

语法

resolved

Alias或者:

resolutionDate

字段类型

日期 DATE

支持的运算符

支持的函数

When used with the #EQUALS, #NOT_EQUALS, #GREATER_THAN, #GREATER_THAN_EQUALS, #LESS_THAN or #LESS当使用 等于, 不等于, 大于, 大于等于, 小于 或 LESS_THAN_EQUALS operators 运算符时, resolved supports 支持:

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

示例

• Find all issues that were resolved on or before 31st December 2008 00:00

  查找2008年12月31日00:00之前解决的问题:

  代码块
  resolved <= "2008/12/31"

• 查找2009年1月解决的问题:

  代码块

  Find issues that were resolved in January 2009:

  代码块
  resolved > "2008/12/31" and resolved < "2009/02/01"

• Find issues that were resolved on 15 January 2009

  查找2009年1月15日解决的问题:

  代码块
  resolved > "2009/01/14" and resolved < "2009/01/16"

• Find issues that were resolved in the last hour

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

  代码块
  resolved > -1h

Status

Search for issues that have a particular Status.

You can search by Status name or Status ID (i.e. the number that JIRA automatically allocates to a Status).

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

语法

status

字段类型

状态

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

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

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

语法

status

字段类型

状态 STATUS

支持的运算符

支持的函数

n/a

示例

• Find issues with a Status of

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

  代码块
  status = Open

  Find issues with a Status
• ID of 1

  查找状态ID 是1的问题:

  代码块
  status = 1

Summary

Search for issues where the Summary contains particular text.

JIRA text-search syntax can be used.

主题

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

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

注意: 这个字段不支持自动完成。Note: this field does not support #auto-complete.

语法

summary

字段类型

文本 TEXT

支持的运算符

支持的函数

n/a

示例

• Find issues where the Summary contains text that matches "

  模糊查找主题中包含 "Error saving file"

  (i.e. a "fuzzy" match)

  的问题:

  代码块
  summary ~ "Error saving file"

• Find issues where the Summary contains the exact phrase

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

  代码块
  summary ~ "\"Error saving file\""

Text

文本

可以在以下文本字段内容中查找包含指定字符的问题This is a "master-field" that allows you to search all text fields, i.e.:

Note注意: The text master-field can only be used with the #CONTAINS operator text 只能和 包含 运算符 ("~" and 以及 "!~"). 结合使用。

语法

text

字段类型

文本 TEXT

支持的运算符

支持的函数

n/a

示例

• Find issues where a text field matches the word

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

  代码块
  text ~ "Fred"

  or

  代码块
  text ~ Fred

• Find all issues where a text field contains the exact phrase

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

  代码块
  text ~ "\"full screen\""

Type

Search for issues that have a particular Issue Type.

问题类型

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

你可以按照问题类型名称或问题类型ID (JIRA自动为问题类型分配的数值)搜索问题。You can search by Issue Type name or Issue Type ID (i.e. the number that JIRA automatically allocates to an Issue Type).

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

语法

type

Alias或者:

issueType

字段类型

问题类型 ISSUE_TYPE

支持的运算符

支持的函数

n/a

示例

• Find issues with an Issue Type of "

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

  代码块
  type = Bug

• Find issues with an Issue Type of

  查找问题类型是"Bug"

  or

  或 "Improvement"的问题:

  代码块
  issueType in (Bug,Improvement)

• Find issues with an Issue Type ID of 2

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

  代码块
  issueType = 2

Time Spent

Only 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.

语法

日, 小时或分钟。

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

语法

timeSpent

字段类型

期间 DURATION

支持的运算符

支持的函数

n/a

示例

• Find issues where the Time Spent is more than 5 days

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

  代码块
  timeSpent > 5d

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. 注意: 这个字段不支持自动完成。

语法

updated

Alias或者:

updatedDate

字段类型

日期 DATE

支持的运算符

支持的函数

When used with the #EQUALS, #NOT_EQUALS, #GREATER_THAN, #GREATER_THAN_EQUALS, #LESS_THAN or #LESS_THAN_EQUALS operators, updated supports:

• #currentLogin()
• #lastLogin()
• #now()

示例

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

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

示例

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

• Find issues that were updated on or before 12th December 2008 00:00

  :

  代码块
  updated <= "2008/12/12"

• Find issues that were updated more than two weeks ago

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

  代码块
  updated < "-2w"

• Find issues that were updated on 15 January 2009

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

  代码块
  updated > "2009/01/14" and updated < "2009/01/16"

• Find issues that were updated in January 2009

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

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

Voter

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.

投票人

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

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

语法

voter

字段类型

USER

支持的运算符

支持的函数

When used with the #IN and #NOT_IN operators, voter supports:

• #membersOf()

When used with the #EQUALS and #NOT_EQUALS operators, voter supports:

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

• 是...的成员 membersOf()

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

• 当前用户 currentUser#currentUser()

示例

• Search for issues for which you have voted

  搜索你自己投票的问题:

  代码块
  voter = currentUser()

• Search for issues for which the user

  搜索 "jsmith"

  has voted

  投票的问题:

  代码块
  voter = "jsmith"

• Search for issues for which a member of the group

  搜索用户组 "jira-developers"

  has voted

  所有成员投票的问题:

  代码块
  voter in membersOf("jira-developers")

Votes

Search for issues with a specified number of votes.

投票数量

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

注意: 这个字段不支持自动完成。Note: this field does not support #auto-complete.

语法

votes

字段类型

NUMBER

支持的运算符

支持的函数

n/a

示例

• Find all issues that have 12 or more votes

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

  代码块
  votes >= 12

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.

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

语法

voter

字段类型

USER

支持的运算符

支持的函数

When used with the #IN and #NOT_IN operators, watcher supports:

• #membersOf()

When used with the #EQUALS and #NOT_EQUALS operators, watcher supports:

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

• 是...的成员 membersOf()

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

• 当前用户 currentUser#currentUser()

示例

• Search for issues that you are watching

  搜索你关注的问题:

  代码块
  watcher = currentUser()

• Search for issues that the user

  搜索 "jsmith"

  is watching

  关注的问题:

  代码块
  watcher = "jsmith"

• Search for issues that are being watched by a member of the group

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

  代码块
  watcher in membersOf("jira-developers")

Work Ratio

Only 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. 注意: 这个字段不支持自动完成。

语法

workRatio

字段类型

数值 NUMBER

支持的运算符

支持的函数

n/a

示例

• Find issues on which more than 75% of the Original Estimate has been spent

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

  代码块
  workRatio > 75