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

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


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

  • 相关资源推荐:

零基础学习使用缺陷管理工具Jira(三):Jira的管理使用(下)
字段列表:

  • Priority
  • Project
  • Remaining Estimate
  • Reporter
  • Resolution
  • Resolved
  • Sprint
  • Status
  • Summary
  • Text

Priority

根据具体的优先级搜索问题,可通过优先级名称和优先级ID进行查询。注:该字段支持自动填写功能。
语法
priority
字段类型
PRIORITY
支持的运算符

JIRA搜索字段

支持的函数

  • n/a

示例

  • 查找优先级为"High"的问题:
    priority = High
  • 查找优先级ID为10000的问题:
    priority = 10000

Project

查找属于某个具体项目的问题,可通过项目名称、项目键或项目ID进行搜索。极少数情况,若项目键相同时,搜索结果按偏好隐藏搜索出来的其它项目。注:该字段支持自动填写功能。
语法
Project
字段类型
PROJECT
支持的运算符

JIRA搜索字段

支持的函数
当使用INNOT IN运算符时,该字段支持:

  • projectsLeadByUser()
  • projectsWhereUserHasPermission()
  • projectsWhereUserHasRole()

示例

  • 查找属于名为"ABC Project"项目的问题:
    project = "ABC Project"
  • 查找属于键为"ABC"的项目的问题:
    project = "ABC"
  • 查找属于项目ID为"1234"的项目的问题:
    project = 1234

Remaining Estimate

仅当JIRA管理员启用time-tracking后可用。
查询剩余时间设置为某个具体值(是数值而不是日期或时间段)的问题。使用"w","d","h"和"m"来指定周、天、时和分。注:该字段不支持自动填写功能。
语法
remainingEstimate
别名:
timeEstimate
字段类型
DURATION
支持的语法

JIRA搜索字段

支持的函数

  • n/a

示例

  • 查找剩余时间超过4小时的问题:
    remainingEstimate > 4h

Reporter

搜索被某个具体用户报告的问题,和问题创建者类似,但又有所不同,可通过用户全名、ID或邮件地址进行查询。注:该字段支持自动填写功能。
语法
reporter
字段类型
USER
支持的运算符

JIRA搜索字段

支持的函数
当使用INNOT IN运算符时,该字段支持:

  • membersOf()

当使用EQUALSNOT EQUALS运算符时,该字段支持:

  • currentUser()

示例

  • 查找被Jill Jones报告的问题:
    reporter = "Jill Jones"

    reporter = jjones
  • 查找被用户邮箱为"bob@mycompany.com"报告的问题:
    reporter = "bob@mycompany.com"
    (注意全站保留字符和@符号要加双引号。)

Resolution

搜索已经有具体解决方案的问题,可通过解决方案名称或ID进行查询。注:该字段支持自动填写功能。
语法
resolution
字段类型
RESOLUTION
支持的运算符

JIRA搜索字段

支持的函数

  • n/a

示例

  • 查找解决方案为"Cannot Reproduce"或"Won't Fix"的问题:
    resolution in ("Cannot Reproduce", "Won't Fix")
  • 查找解决方案ID为5的问题:
    resolution = 5
  • 查找还没有解决方案的问题:
    resolution = unresolved

Resolved

搜索在某个具体的日期或日期范围内解决的问题。注意默认时间分量为午夜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)后的毫秒计算。注:该字段不支持自动填写功能。
语法
resolved
别名:
resolutionDate
字段类型
DATE
支持的运算符

JIRA搜索字段

支持的函数
当使用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月31日前(不包括31日)解决的所有问题:
    resolved <= "2010/12/31"
  • 查找在2010年12月31日下午2点之前解决的所有问题:
    resolved < "2010/12/31 14:00"
  • 查找在2010年12月31日这一天或之前解决的所有问题:
    resolved <= "2011/01/01"
  • 查找在2011年1月分解决的所有问题:
    resolved > "2011/01/01" and resolved < "2011/02/01"
  • 查找在2011年1月15日这一天解决的所有问题:
    resolved > "2011/01/15" and resolved < "2011/01/16"
  • 查找在过去一个小时内解决的问题:
    resolved > -1h

Sprint

仅当使用JIRA Agile时可用。
搜索分配给JIRA Agile中特定sprint的问题,可通过sprint名称和ID进行查询。
语法
sprint
如果你的多个sprint拥有相似的名称,你可以通过名称进行简单查询-或这名称的部分。可能匹配的将自动填充在下拉框中,同时日期和ID也会显示出来以供区别。
字段类型
Number
支持的运算符

JIRA搜索字段

支持的函数

  • openSprints()
  • closedSprints()

示例

  • 查找属于sprint999的问题:
    sprint = 999
  • 查找属于sprint "February 1"的问题:
    sprint = "February 1"
  • 查找属于"February 1","February 2"或"February 3"的问题:
    sprint in ("February 1","February 2","February 3")
  • 查找属于sprint的所有问题:
    sprint is not empty

Status

搜索某个具体状态的问题,可通过状态名称或ID进行查询。
注意:WAS, WAS NOT, WAS INWAS NOT IN运算符只能用于状态名称(不能用于ID)。注:该字段支持自动填写功能。
语法
Status
字段类型
STATUS
支持的运算符

JIRA搜索字段

支持的函数

  • n/a

示例

  • 查找状态为"Open"的问题:
    status = Open
  • 查找状态ID为1的问题:
    status = 1
  • 查找当前或曾经状态为"Open"的问题:
    status WAS Open

Summary

搜索总结里包含具体文本的问题,也可使用文本搜索。注:该字段不支持自动填写功能。
语法
Summary
字段类型
TEXT
支持的运算符

JIRA搜索字段

支持的函数

  • n/a

示例

  • 查找总结里含有"Error saving file"的问题(模糊匹配):
    summary ~ "Error saving file"
  • 查找总结里含有"Error saving file"精准语句的问题:
    summary ~ "\"Error saving file\""

Text

该字段允许搜索所有文本类字段,如:

  • Summary
  • Description
  • Environment
  • Comments
  • custom 该字段使用自由文本搜索器;自定义字段类型如下:
    • Free Text Field (无限制文本)
    • Text Field (< 255字节)
    • Read-only Text Field

尽管JQL中的Text字段可以搜索所有文本类字段的问题如:Summary, Description, Environment, Comments等,但为了使搜索更精确,在搜索的时候尽量使用某个具体的字段,如:
Summary ~ "some words" OR Description ~ "some words"
注:
text字段只能和CONTAINS运算符("~")一起使用。
语法
text
字段类型
TEXT
支持的运算符

JIRA搜索字段

支持的函数

  • n/a

示例

  • 查找文本字段里包含"Fred"的问题:
    text ~ "Fred"

    text ~ Fred
  • 查找文本字段里包含"full screen"精准语句的问题:
    text ~ "\"full screen\""

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

JIRA SoftwareJIRA Servcie Desk均已更新至最新版本,更多实用功能等你来体验!

点击下载JIRA Core v8.3最新试用版