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最新試用版