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

---

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

字段列表：

• Due
• Environment
• Epic Link
• Filter
• Fix Version
• Issue Key
• LastViewed
• Level
• Original Estimate
• Parent

Due

根据某个具体的截止日期之前或之后（或某个时间段）来搜索问题。注意截止日期仅和日期（而不是时间）有关。格式如下：
"yyyy/MM/dd"
"yyyy-MM-dd"
或使用"w"(周)或"d"(天)指定当前日期，记住要使用双引号。该字段不支持自动填写功能。
语法
due
别名：
dueDate
字段类型
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日前截止的所有问题：
  due < "2010/12/31"
• 查找截止到2010年11月31日的所有问题：
  due <= "2011/01/01"
• 查找明天截止的所有问题：
  due = "1d"
• 查找所有在2011年1月这个月截止的问题：
  due >= "2011/01/01" and due <= "2011/01/31"
• 查找所有在2011年1月15日这天截止的问题：
  due = "2011/01/15"

Environment

查找Environment字段包含某个特定文本的问题，也可用JIRA文本搜索。注：该字段不支持自动填写功能。
语法
environment
字段类型
TEXT
支持的运算符

支持的函数

• n/a

示例

• 查找Environment字段包含"Third floor"的问题（模糊匹配）：
  environment ~ "Third floor"
• 查找Environment字段包含完整"Third floor"语句的问题：
  environment ~ "\"Third floor\""

Epic Link

仅适用于JIRA Agile 6.1.2或以后的版本。
查找属于JIRA Agile中某个具体Epic的问题，可以根据Epic名称、问题键或问题ID进行查询。注：该字段不支持自动填写功能。
语法
"epic link"
字段类型
Epic Link Relationship (这是通过JIRA Agile 创建的自定义类型).
支持的运算符

支持的函数
当使用IN 或 NOT IN 运算符时， epic链接支持：

• issueHistory()
• linkedIssues()
• votedIssues()
• watchedIssues()

示例

• 查找属于名为"Jupiter"，问题键为ANERDS-317的epic的问题：
  "epic link" = ANERDS-317
  或
  "epic link" = Jupiter

Filter

你可以使用保存的过滤器来缩小搜索范围，通过过滤器名称或过滤器的ID进行搜索。
注：

• 在保存的过滤器中键入的高级搜索-字段参考声明将覆盖ORDER BY声明。
• 不能运行或保存可能引起无限循环的过滤器（例如：你不能参考已保存的参考正在运行的过滤器的过滤器）。
• 支持自动填写功能。

语法
filter
别名：
request
savedFilter
searchRequest
字段类型
FILTER
支持的运算符

支持的函数

• n/a

示例

• 查询ID为12000，名称为"My Saved Filter"的过滤器授权给jsmith用户的问题：
  filter = "My Saved Filter" and assignee = jsmith
  或
  filter = 12000 and assignee = jsmith

Fix Version

查询某个具体修复版本的问题，可通过版本名称或版本ID进行查询。注：该字段支持自动填写。
语法
fixVersion
字段类型
VERSION
支持的运算符

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

• releasedVersions()
• latestReleasedVersion()
• unreleasedVersions()
• earliestUnreleasedVersion()
• versionMatch()

示例

• 查找修复版本为3.14或4.2的问题：
  fixVersion in ("3.14", "4.2")
  (注意保留字符要加双引号)
• 查询修复版本为"Little Ted"的问题：
  fixVersion = "Little Ted"
• 查询修复版本ID为10001的问题：
  fixVersion = 10001
• 查询修复版本为15.2或其子版本的问题：
  fixVersion in (versionMatch("15.2.*"))

Issue Key

通过具体的问题键或问题ID查询问题。注：该字段不支持自动填写功能。
语法
issueKey
别名：
id
issue
key
字段类型
ISSUE
支持的运算符

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

• issueHistory()
• linkedIssues()
• votedIssues()
• watchedIssues()

示例

• 查找问题键为"ABC-123"的问题：
  issueKey = ABC-123

LastViewed

查找最后一次某个具体的日期或时间段浏览过的问题，默认午夜00:00为时间分量，格式如下：
"yyyy/MM/dd HH:mm"
"yyyy-MM-dd HH:mm"
"yyyy/MM/dd"
"yyyy-MM-dd"
或使用"w" (周), "d" (天), "h" (时) 或 "m" (分)来指定当前相对时间。注：该字段不支持自动填写功能。
语法
lastViewed
字段类型
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日之前的所有问题：
  lastViewed < "2010/12/12"
• 查找最后一次浏览是在2010年12月12日当天或之前的所有问题：
  lastViewed <= "2010/12/13"
• 查找最后一次浏览是在2010年12月12日这一天并且是在下午2点之前的所有问题：
  lastViewed > "2010/12/12" and created < "2010/12/12 14:00"
• 查找最后一次浏览是在一天以前的问题：
  lastViewed > "-1d"
• 查找最后一次浏览是在2011年1月的所有问题：
  lastViewed > "2011/01/01" and created < "2011/02/01"
• 查找最后一次浏览是在2011年1月15日这一天的问题：
  lastViewed > "2011/01/15" and created < "2011/01/16"

Level

仅当Issue Level Security被JIRA管理员启用时可用。
通过具体的安全级别查找问题，可通过问题安全级别名称或ID进行查询。注：该字段支持自动填写功能。
语法
level
字段类型
SECURITY LEVEL
支持的运算符

支持的函数

• n/a

示例

• 查找问题安全级别为"Really High"或"level1"的问题：
  level in ("Really High", level1)
• 查找问题安全级别ID为123的问题：
  level = 123

Original Estimate

仅当JIRA管理员启用时间追踪后可用。
通过具体的初始估计值（是数字，而不是日期或日期范围）查找问题。使用"w", "d", "h"和"m"来指定周、天、时、分。注：该字段不支持自动填写功能。
语法
originalEstimate
别名：
timeOriginalEstimate
字段类型
DURATION
支持的运算符

支持的函数

• n/a

示例

• 查找初始估计为1小时的问题：
  originalEstimate = 1h
• 查找初始估计大于2天的问题：
  originalEstimate > 2d

Parent

仅当JIRA管理员启用子任务后可用。
查找某个具体问题的所有子任务，可通过问题键或问题ID进行查找。注：该字段不支持自动填写功能。
语法
parent
字段类型
ISSUE
支持的运算符

支持的函数

• n/a

示例

• 查找TEST-1234问题的子任务：
  parent = TEST-1234

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