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

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

• 相关资源推荐：

零基础学习使用缺陷管理工具Jira（三）：Jira的管理使用（下）
字段列表：

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

Priority

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

支持的函数

• n/a

示例

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

Project

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

支持的函数
当使用IN和NOT 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
支持的语法

支持的函数

• n/a

示例

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

Reporter

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

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

• membersOf()

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

• currentUser()

示例

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

Resolution

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

支持的函数

• 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
支持的运算符

支持的函数
当使用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
支持的运算符

支持的函数

• 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 IN和WAS NOT IN运算符只能用于状态名称（不能用于ID）。注：该字段支持自动填写功能。
语法
Status
字段类型
STATUS
支持的运算符

支持的函数

• n/a

示例

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

Summary

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

支持的函数

• 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
支持的运算符

支持的函数

• n/a

示例

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

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

JIRA Software、JIRA Servcie Desk均已更新至最新版本，更多实用功能等你来体验！

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