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 創(chuàng)建的自定義類型).
支持的運算符

支持的函數
當使用IN 或 NOT IN 運算符時， epic鏈接支持：

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

示例

• 查找屬于名為"Jupiter"，問題鍵為ANERDS-317的epic的問題：
  "epic link" = ANERDS-317
  或
  "epic link" = Jupiter

Filter

你可以使用保存的過濾器來縮小搜索范圍，通過過濾器名稱或過濾器的ID進行搜索。
注：

• 在保存的過濾器中鍵入的高級搜索-字段參考聲明將覆蓋ORDER BY聲明。
• 不能運行或保存可能引起無限循環(huán)的過濾器（例如：你不能參考已保存的參考正在運行的過濾器的過濾器）。
• 支持自動填寫功能。

語法
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

相關產品購買請咨詢"在線客服"。