logo JIRA使用教程 我也要发布文档

高级搜索—字段参考(4/4)


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

字段列表:

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

Type

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

JIRA搜索字段
支持的函数
  • 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
支持的运算符

JIRA搜索字段
支持的函数
  • 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
支持的运算符

JIRA搜索字段
支持的函数
当使用EQUALS, NOT EQUALS, GREATER THAN, GREATER THAN EQUALS, LESS THANLESS 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
支持的运算符

JIRA搜索字段
支持的函数
当使用 INNOT IN 运算符时,该字段支持:
  • membersOf()
当使用 EQUALSNOT EQUALS 运算符时,该字段支持:
  • currentUser()
示例
  • 查找自己投过的问题:
    voter = currentUser()
  • 查找用户"jsmith"投过的问题:
    voter = "jsmith"
  • 查找"jira-developers"组的成员投过的问题:
    voter in membersOf("jira-developers")

Votes

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

JIRA搜索字段
支持的函数
  • n/a
示例
  • 查找所有拥有12票的问题:
    votes >= 12

Watcher

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

JIRA搜索字段
支持的函数
当使用 INNOT IN 运算符时,该字段支持:
  • membersOf()
当使用 EQUALSNOT EQUALS 运算符时,该字段支持:
  • currentUser()
示例
  • 查找所有自己浏览过的问题:
    watcher = currentUser()
  • 查找用户"jsmith"浏览过的问题:
    watcher = "jsmith"
  • 查找"jira-developers"组的成员浏览过的问题:
    watcher in membersOf("jira-developers")

Watchers

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

JIRA搜索字段
支持的函数
  • n/a
示例
  • 查找浏览量大于3的问题:
    watchers > 3

Work Ratio

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

JIRA搜索字段
支持的函数
  • n/a
示例
  • 查找比值超过75%的问题:
    workRatio > 75

相关产品购买请咨询"在线客服"。