JIRA使用教程：高級(jí)搜索—字段參考（3/4）

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

• 相關(guān)資源推薦：

零基礎(chǔ)學(xué)習(xí)使用缺陷管理工具Jira（三）：Jira的管理使用（下）
字段列表：

• Priority
• Project
• Remaining Estimate
• Reporter
• Resolution
• Resolved
• Sprint
• Status
• Summary
• Text

Priority

根據(jù)具體的優(yōu)先級(jí)搜索問(wèn)題，可通過(guò)優(yōu)先級(jí)名稱和優(yōu)先級(jí)ID進(jìn)行查詢。注：該字段支持自動(dòng)填寫功能。
語(yǔ)法
priority
字段類型
PRIORITY
支持的運(yùn)算符

支持的函數(shù)

• n/a

示例

• 查找優(yōu)先級(jí)為"High"的問(wèn)題：
  priority = High
• 查找優(yōu)先級(jí)ID為10000的問(wèn)題：
  priority = 10000

Project

查找屬于某個(gè)具體項(xiàng)目的問(wèn)題，可通過(guò)項(xiàng)目名稱、項(xiàng)目鍵或項(xiàng)目ID進(jìn)行搜索。極少數(shù)情況，若項(xiàng)目鍵相同時(shí)，搜索結(jié)果按偏好隱藏搜索出來(lái)的其它項(xiàng)目。注：該字段支持自動(dòng)填寫功能。
語(yǔ)法
Project
字段類型
PROJECT
支持的運(yùn)算符

支持的函數(shù)
當(dāng)使用IN和NOT IN運(yùn)算符時(shí)，該字段支持：

• projectsLeadByUser()
• projectsWhereUserHasPermission()
• projectsWhereUserHasRole()

示例

• 查找屬于名為"ABC Project"項(xiàng)目的問(wèn)題：
  project = "ABC Project"
• 查找屬于鍵為"ABC"的項(xiàng)目的問(wèn)題：
  project = "ABC"
• 查找屬于項(xiàng)目ID為"1234"的項(xiàng)目的問(wèn)題：
  project = 1234

Remaining Estimate

僅當(dāng)JIRA管理員啟用time-tracking后可用。
查詢剩余時(shí)間設(shè)置為某個(gè)具體值（是數(shù)值而不是日期或時(shí)間段）的問(wèn)題。使用"w","d","h"和"m"來(lái)指定周、天、時(shí)和分。注：該字段不支持自動(dòng)填寫功能。
語(yǔ)法
remainingEstimate
別名：
timeEstimate
字段類型
DURATION
支持的語(yǔ)法

支持的函數(shù)

• n/a

示例

• 查找剩余時(shí)間超過(guò)4小時(shí)的問(wèn)題：
  remainingEstimate > 4h

Reporter

搜索被某個(gè)具體用戶報(bào)告的問(wèn)題，和問(wèn)題創(chuàng)建者類似，但又有所不同，可通過(guò)用戶全名、ID或郵件地址進(jìn)行查詢。注：該字段支持自動(dòng)填寫功能。
語(yǔ)法
reporter
字段類型
USER
支持的運(yùn)算符

支持的函數(shù)
當(dāng)使用IN和NOT IN運(yùn)算符時(shí)，該字段支持：

• membersOf()

當(dāng)使用EQUALS和NOT EQUALS運(yùn)算符時(shí)，該字段支持：

• currentUser()

示例

• 查找被Jill Jones報(bào)告的問(wèn)題：
  reporter = "Jill Jones"
  或
  reporter = jjones
• 查找被用戶郵箱為"bob@mycompany.com"報(bào)告的問(wèn)題：
  reporter = "bob@mycompany.com"
  (注意全站保留字符和@符號(hào)要加雙引號(hào)。)

Resolution

搜索已經(jīng)有具體解決方案的問(wèn)題，可通過(guò)解決方案名稱或ID進(jìn)行查詢。注：該字段支持自動(dòng)填寫功能。
語(yǔ)法
resolution
字段類型
RESOLUTION
支持的運(yùn)算符

支持的函數(shù)

• n/a

示例

• 查找解決方案為"Cannot Reproduce"或"Won't Fix"的問(wèn)題：
  resolution in ("Cannot Reproduce", "Won't Fix")
• 查找解決方案ID為5的問(wèn)題：
  resolution = 5
• 查找還沒(méi)有解決方案的問(wèn)題：
  resolution = unresolved

Resolved

搜索在某個(gè)具體的日期或日期范圍內(nèi)解決的問(wèn)題。注意默認(rèn)時(shí)間分量為午夜00:00，搜索結(jié)果參照J(rèn)IRA服務(wù)器時(shí)間。格式如下：
"yyyy/MM/dd HH:mm"
"yyyy-MM-dd HH:mm"
"yyyy/MM/dd"
"yyyy-MM-dd"
或使用"w" (周), "d" (天), "h" (時(shí))或"m" (分)來(lái)指定當(dāng)前相對(duì)時(shí)間。注意加雙引號(hào)，否則將按照(1970-1-1)后的毫秒計(jì)算。注：該字段不支持自動(dòng)填寫功能。
語(yǔ)法
resolved
別名：
resolutionDate
字段類型
DATE
支持的運(yùn)算符

支持的函數(shù)
當(dāng)使用EQUALS, NOT EQUALS, GREATER THAN, GREATER THAN EQUALS, LESS THAN 或 LESS THAN EQUALS運(yùn)算符時(shí)，該字段支持：

• currentLogin()
• lastLogin()
• now()
• startOfDay()
• startOfWeek()
• startOfMonth()
• startOfYear()
• endOfDay()
• endOfWeek()
• endOfMonth()
• endOfYear()

示例

• 查找2010年12月31日前（不包括31日）解決的所有問(wèn)題：
  resolved <= "2010/12/31"
• 查找在2010年12月31日下午2點(diǎn)之前解決的所有問(wèn)題：
  resolved < "2010/12/31 14:00"
• 查找在2010年12月31日這一天或之前解決的所有問(wèn)題：
  resolved <= "2011/01/01"
• 查找在2011年1月分解決的所有問(wèn)題：
  resolved > "2011/01/01" and resolved < "2011/02/01"
• 查找在2011年1月15日這一天解決的所有問(wèn)題：
  resolved > "2011/01/15" and resolved < "2011/01/16"
• 查找在過(guò)去一個(gè)小時(shí)內(nèi)解決的問(wèn)題：
  resolved > -1h

Sprint

僅當(dāng)使用JIRA Agile時(shí)可用。
搜索分配給JIRA Agile中特定sprint的問(wèn)題，可通過(guò)sprint名稱和ID進(jìn)行查詢。
語(yǔ)法
sprint
如果你的多個(gè)sprint擁有相似的名稱，你可以通過(guò)名稱進(jìn)行簡(jiǎn)單查詢-或這名稱的部分?？赡芷ヅ涞膶⒆詣?dòng)填充在下拉框中，同時(shí)日期和ID也會(huì)顯示出來(lái)以供區(qū)別。
字段類型
Number
支持的運(yùn)算符

支持的函數(shù)

• openSprints()
• closedSprints()

示例

• 查找屬于sprint999的問(wèn)題：
  sprint = 999
• 查找屬于sprint "February 1"的問(wèn)題：
  sprint = "February 1"
• 查找屬于"February 1"，"February 2"或"February 3"的問(wèn)題：
  sprint in ("February 1","February 2","February 3")
• 查找屬于sprint的所有問(wèn)題：
  sprint is not empty

Status

搜索某個(gè)具體狀態(tài)的問(wèn)題，可通過(guò)狀態(tài)名稱或ID進(jìn)行查詢。
注意：WAS, WAS NOT, WAS IN和WAS NOT IN運(yùn)算符只能用于狀態(tài)名稱（不能用于ID）。注：該字段支持自動(dòng)填寫功能。
語(yǔ)法
Status
字段類型
STATUS
支持的運(yùn)算符

支持的函數(shù)

• n/a

示例

• 查找狀態(tài)為"Open"的問(wèn)題：
  status = Open
• 查找狀態(tài)ID為1的問(wèn)題：
  status = 1
• 查找當(dāng)前或曾經(jīng)狀態(tài)為"Open"的問(wèn)題：
  status WAS Open

Summary

搜索總結(jié)里包含具體文本的問(wèn)題，也可使用文本搜索。注：該字段不支持自動(dòng)填寫功能。
語(yǔ)法
Summary
字段類型
TEXT
支持的運(yùn)算符

支持的函數(shù)

• n/a

示例

• 查找總結(jié)里含有"Error saving file"的問(wèn)題（模糊匹配）：
  summary ~ "Error saving file"
• 查找總結(jié)里含有"Error saving file"精準(zhǔn)語(yǔ)句的問(wèn)題：
  summary ~ "\"Error saving file\""

Text

該字段允許搜索所有文本類字段，如：

• Summary
• Description
• Environment
• Comments
• custom 該字段使用自由文本搜索器；自定義字段類型如下：
• Free Text Field (無(wú)限制文本)
• Text Field (< 255字節(jié))
• Read-only Text Field

盡管JQL中的Text字段可以搜索所有文本類字段的問(wèn)題如：Summary, Description, Environment, Comments等，但為了使搜索更精確，在搜索的時(shí)候盡量使用某個(gè)具體的字段，如：
Summary ~ "some words" OR Description ~ "some words"
注：
text字段只能和CONTAINS運(yùn)算符("~")一起使用。
語(yǔ)法
text
字段類型
TEXT
支持的運(yùn)算符

支持的函數(shù)

• n/a

示例

• 查找文本字段里包含"Fred"的問(wèn)題：
  text ~ "Fred"
  或
  text ~ Fred
• 查找文本字段里包含"full screen"精準(zhǔn)語(yǔ)句的問(wèn)題：
  text ~ "\"full screen\""

相關(guān)產(chǎn)品購(gòu)買請(qǐng)咨詢"在線客服"。

JIRA Software、JIRA Servcie Desk均已更新至最新版本，更多實(shí)用功能等你來(lái)體驗(yàn)！

點(diǎn)擊下載JIRA Core v8.3最新試用版