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

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

JIRA搜索字段
支持的函数
  • 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 创建的自定义类型).
支持的运算符

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

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

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

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

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

JIRA搜索字段
支持的函数
  • n/a
示例
  • 查找问题安全级别为"Really High"或"level1"的问题:
    level in ("Really High", level1)
  • 查找问题安全级别ID为123的问题:
    level = 123

Original Estimate

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

JIRA搜索字段
支持的函数
  • n/a
示例
  • 查找初始估计为1小时的问题:
    originalEstimate = 1h
  • 查找初始估计大于2天的问题:
    originalEstimate > 2d

Parent

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

JIRA搜索字段
支持的函数
  • n/a
示例
  • 查找TEST-1234问题的子任务:
    parent = TEST-1234

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

在线咨询
联系我们

客服热线
023-68661681

QQ客服

意见反馈


添加微信获专业服务

TOP