JIRA使用教程：高級搜索—字段參考（4/4）

---

JQL中的字段是JIRA中的字段（或已在JIRA中已定義的自定義字段）。在一個語句中，字段緊跟在運算符后面，而字段后面又跟著一個或多個值（或函數）。運算符比較字段的一個或多個值，使得查詢語句僅返回正確的結果。

字段列表：

• Type
• Time Spent
• Updated
• Voter
• Votes
• Watcher
• Watchers
• Work Ratio

Type

搜索某個具體類型的問題，可通過類型名稱或ID進行搜索。注：該字段支持自動填寫功能。
語法
type
別名：
issueType
字段類型
ISSUE_TYPE
支持的運算符

支持的函數

• n/a

示例

• 查找類型為"Bug"的問題：
  type = Bug
• 查找類型為"Bug"或"Improvement"的問題：
  issueType in (Bug,Improvement)
• 查找類型ID為2的問題：
  issueType = 2

Time Spent

僅當JIRA管理員啟用time-tracking后可用。
搜索已耗費時間為某個具體值的問題。使用"w", "d", "h"和"m"來指定周、天、時和分。注：該字段不支持自動填寫功能。
語法
timeSpent
字段類型
DURATION
支持的運算符

支持的函數

• n/a

示例

• 查找已耗費時間超過5天的問題：
  timeSpent > 5d

Updated

搜索上一次更新是在某個具體的日期或日期段的問題，注意午夜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)后的毫秒來計算。注：該字段不支持自動填寫功能。
語法
updated
別名：
updatedDate
字段類型
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日之前的問題：
  updated < "2010/12/12"
• 查找上一次更新是在2010年12月12日或之前的問題：
  updated < "2010/12/13"
• 查找上一次更新是在2010年12月31日下午2點之前的所有問題：
  updated < "2010/12/31 14:00"
• 查找上一次更新離現在不超過2周的問題：
  updated < "-2w"
• 查找上一次更新是在2011年1月15日這一天的問題：
  updated > "2011/01/15" and updated < "2011/01/16"
• 查找上一次更新是在2011年1月份的問題：
  updated > "20011/01/01" and updated < "2011/02/01"

Voter

搜索某個具體的用戶投票的問題，可通過用戶全稱、ID、郵箱地址進行查詢。你只能搜索你擁有“查看投票人和瀏覽人”權限的問題，否則只能搜索你自己投的問題。注：該字段支持自動填寫功能。
語法
voter
字段類型
USER
支持的運算符

支持的函數
當使用 IN 和 NOT IN 運算符時，該字段支持：

• membersOf()

當使用 EQUALS 和 NOT EQUALS 運算符時，該字段支持：

• currentUser()

示例

• 查找自己投過的問題：
  voter = currentUser()
• 查找用戶"jsmith"投過的問題：
  voter = "jsmith"
• 查找"jira-developers"組的成員投過的問題：
  voter in membersOf("jira-developers")

Votes

搜索有具體票數的問題。注：該字段不支持自動填寫功能。
語法
votes
字段類型
NUMBER
支持的運算符

支持的函數

• n/a

示例

• 查找所有擁有12票的問題：
  votes >= 12

Watcher

搜索某個具體的用戶瀏覽過的問題，可通過用戶全稱、ID、郵箱地址進行查詢。你只能搜索你擁有“查看投票人和瀏覽人”權限的問題，否則只能搜索你自己瀏覽過的問題。注：該字段支持自動填寫功能。
語法
Watcher
字段類型
USER
支持的運算符

支持的函數
當使用 IN 和 NOT IN 運算符時，該字段支持：

• membersOf()

當使用 EQUALS 和 NOT EQUALS 運算符時，該字段支持：

• currentUser()

示例

• 查找所有自己瀏覽過的問題：
  watcher = currentUser()
• 查找用戶"jsmith"瀏覽過的問題：
  watcher = "jsmith"
• 查找"jira-developers"組的成員瀏覽過的問題：
  watcher in membersOf("jira-developers")

Watchers

按具體瀏覽的用戶量搜索問題。注：該字段不支持自動填寫功能。
語法
watchers
字段類型
NUMBER
支持的運算符

支持的函數

• n/a

示例

• 查找瀏覽量大于3的問題：
  watchers > 3

Work Ratio

僅當JIRA管理員啟用time-tracking后可用。
搜索擁有具體工作比值的問題，計算公式如下：
workRatio = timeSpent / originalEstimate x 100（即:比值=已耗費時間/初始估計時間*100）
注：該字段不支持自動填寫功能。
語法
workRatio
字段類型
NUMBER
支持的運算符

支持的函數

• n/a

示例

• 查找比值超過75%的問題：
  workRatio > 75

相關產品購買請咨詢""。