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均已更新至最新版本，更多實用功能等你來體驗！
QQ交談
在線咨詢
渝公網安備
50010702500608號
客服熱線