JIRA使用教程：高级搜索—字段参考（4/4）

---

JQL中的字段是JIRA中的字段（或已在JIRA中已定义的自定义字段）。在一个语句中，字段紧跟在运算符后面，而字段后面又跟着一个或多个值（或函数）。运算符比较字段的一个或多个值，使得查询语句仅返回正确的结果。

字段列表：

• Type
• Time Spent
• Updated
• Voter
• Votes
• Watcher
• Watchers
• Work Ratio

Type

搜索某个具体类型的问题，可通过类型名称或ID进行搜索。注：该字段支持自动填写功能。
语法
type
别名：
issueType
字段类型
ISSUE_TYPE
支持的运算符

支持的函数

• n/a

示例

• 查找类型为"Bug"的问题：
  type = Bug
• 查找类型为"Bug"或"Improvement"的问题：
  issueType in (Bug,Improvement)
• 查找类型ID为2的问题：
  issueType = 2

Time Spent

仅当JIRA管理员启用time-tracking后可用。
搜索已耗费时间为某个具体值的问题。使用"w", "d", "h"和"m"来指定周、天、时和分。注：该字段不支持自动填写功能。
语法
timeSpent
字段类型
DURATION
支持的运算符

支持的函数

• n/a

示例

• 查找已耗费时间超过5天的问题：
  timeSpent > 5d

Updated

搜索上一次更新是在某个具体的日期或日期段的问题，注意午夜00:00为默认时间分量，查询参照JIRA服务器时间。格式如下：
"yyyy/MM/dd HH:mm"
"yyyy-MM-dd HH:mm"
"yyyy/MM/dd"
"yyyy-MM-dd"
或使用"w" (周), "d" (天), "h" (时)或"m" (分)来指定当前相对时间，默认是分。确保使用双引号(")，否则将按照(1970-1-1)后的毫秒来计算。注：该字段不支持自动填写功能。
语法
updated
别名：
updatedDate
字段类型
DATE
支持的运算符

支持的函数
当使用EQUALS, NOT EQUALS, GREATER THAN, GREATER THAN EQUALS, LESS THAN或LESS THAN EQUALS 运算符时，该字段支持：

• currentLogin()
• lastLogin()
• now()
• startOfDay()
• startOfWeek()
• startOfMonth()
• startOfYear()
• endOfDay()
• endOfWeek()
• endOfMonth()
• endOfYear()

示例

• 查找上一次更新是在2010年12月12日之前的问题：
  updated < "2010/12/12"
• 查找上一次更新是在2010年12月12日或之前的问题：
  updated < "2010/12/13"
• 查找上一次更新是在2010年12月31日下午2点之前的所有问题：
  updated < "2010/12/31 14:00"
• 查找上一次更新离现在不超过2周的问题：
  updated < "-2w"
• 查找上一次更新是在2011年1月15日这一天的问题：
  updated > "2011/01/15" and updated < "2011/01/16"
• 查找上一次更新是在2011年1月份的问题：
  updated > "20011/01/01" and updated < "2011/02/01"

Voter

搜索某个具体的用户投票的问题，可通过用户全称、ID、邮箱地址进行查询。你只能搜索你拥有“查看投票人和浏览人”权限的问题，否则只能搜索你自己投的问题。注：该字段支持自动填写功能。
语法
voter
字段类型
USER
支持的运算符

支持的函数
当使用 IN 和 NOT IN 运算符时，该字段支持：

• membersOf()

当使用 EQUALS 和 NOT EQUALS 运算符时，该字段支持：

• currentUser()

示例

• 查找自己投过的问题：
  voter = currentUser()
• 查找用户"jsmith"投过的问题：
  voter = "jsmith"
• 查找"jira-developers"组的成员投过的问题：
  voter in membersOf("jira-developers")

Votes

搜索有具体票数的问题。注：该字段不支持自动填写功能。
语法
votes
字段类型
NUMBER
支持的运算符

支持的函数

• n/a

示例

• 查找所有拥有12票的问题：
  votes >= 12

Watcher

搜索某个具体的用户浏览过的问题，可通过用户全称、ID、邮箱地址进行查询。你只能搜索你拥有“查看投票人和浏览人”权限的问题，否则只能搜索你自己浏览过的问题。注：该字段支持自动填写功能。
语法
Watcher
字段类型
USER
支持的运算符

支持的函数
当使用 IN 和 NOT IN 运算符时，该字段支持：

• membersOf()

当使用 EQUALS 和 NOT EQUALS 运算符时，该字段支持：

• currentUser()

示例

• 查找所有自己浏览过的问题：
  watcher = currentUser()
• 查找用户"jsmith"浏览过的问题：
  watcher = "jsmith"
• 查找"jira-developers"组的成员浏览过的问题：
  watcher in membersOf("jira-developers")

Watchers

按具体浏览的用户量搜索问题。注：该字段不支持自动填写功能。
语法
watchers
字段类型
NUMBER
支持的运算符

支持的函数

• n/a

示例

• 查找浏览量大于3的问题：
  watchers > 3

Work Ratio

仅当JIRA管理员启用time-tracking后可用。
搜索拥有具体工作比值的问题，计算公式如下：
workRatio = timeSpent / originalEstimate x 100（即:比值=已耗费时间/初始估计时间*100）
注：该字段不支持自动填写功能。
语法
workRatio
字段类型
NUMBER
支持的运算符

支持的函数

• n/a

示例

• 查找比值超过75%的问题：
  workRatio > 75

相关产品购买请咨询""。