页面历史记录

影响版本

搜索指定影响版本的问题。 你可以按照版本名称或版本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]

字段类型

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

支持的运算符

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

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

  包含页面
  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

支持的函数

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

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

文本

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

注意: 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