JIRA使用教程:高級(jí)搜索—字段參考(2/4)
JQL中的字段是JIRA中的字段(或已在JIRA中已定義的自定義字段)。在一個(gè)語(yǔ)句中,字段緊跟在運(yùn)算符后面,而字段后面又跟著一個(gè)或多個(gè)值(或函數(shù))。運(yùn)算符比較字段的一個(gè)或多個(gè)值,使得查詢語(yǔ)句僅返回正確的結(jié)果。
字段列表:
- Due
- Environment
- Epic Link
- Filter
- Fix Version
- Issue Key
- LastViewed
- Level
- Original Estimate
- Parent
Due
根據(jù)某個(gè)具體的截止日期之前或之后(或某個(gè)時(shí)間段)來(lái)搜索問(wèn)題。注意截止日期僅和日期(而不是時(shí)間)有關(guān)。格式如下:
"yyyy/MM/dd"
"yyyy-MM-dd"
或使用"w"(周)或"d"(天)指定當(dāng)前日期,記住要使用雙引號(hào)。該字段不支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
due
別名:
dueDate
字段類型
DATE
支持的運(yùn)算符

當(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日前截止的所有問(wèn)題:
due < "2010/12/31"
- 查找截止到2010年11月31日的所有問(wèn)題:
due <= "2011/01/01"
- 查找明天截止的所有問(wèn)題:
due = "1d"
- 查找所有在2011年1月這個(gè)月截止的問(wèn)題:
due >= "2011/01/01" and due <= "2011/01/31"
- 查找所有在2011年1月15日這天截止的問(wèn)題:
due = "2011/01/15"
Environment
查找Environment字段包含某個(gè)特定文本的問(wèn)題,也可用JIRA文本搜索。注:該字段不支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
environment
字段類型
TEXT
支持的運(yùn)算符

- n/a
- 查找Environment字段包含"Third floor"的問(wèn)題(模糊匹配):
environment ~ "Third floor"
- 查找Environment字段包含完整"Third floor"語(yǔ)句的問(wèn)題:
environment ~ "\"Third floor\""
Epic Link
僅適用于JIRA Agile 6.1.2或以后的版本。
查找屬于JIRA Agile中某個(gè)具體Epic的問(wèn)題,可以根據(jù)Epic名稱、問(wèn)題鍵或問(wèn)題ID進(jìn)行查詢。注:該字段不支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
"epic link"
字段類型
Epic Link Relationship (這是通過(guò)JIRA Agile 創(chuàng)建的自定義類型).
支持的運(yùn)算符

當(dāng)使用IN 或 NOT IN 運(yùn)算符時(shí), epic鏈接支持:
- issueHistory()
- linkedIssues()
- votedIssues()
- watchedIssues()
- 查找屬于名為"Jupiter",問(wèn)題鍵為ANERDS-317的epic的問(wèn)題:
"epic link" = ANERDS-317
或
"epic link" = Jupiter
Filter
你可以使用保存的過(guò)濾器來(lái)縮小搜索范圍,通過(guò)過(guò)濾器名稱或過(guò)濾器的ID進(jìn)行搜索。
注:
- 在保存的過(guò)濾器中鍵入的高級(jí)搜索-字段參考聲明將覆蓋ORDER BY聲明。
- 不能運(yùn)行或保存可能引起無(wú)限循環(huán)的過(guò)濾器(例如:你不能參考已保存的參考正在運(yùn)行的過(guò)濾器的過(guò)濾器)。
- 支持自動(dòng)填寫(xiě)功能。
filter
別名:
request
savedFilter
searchRequest
字段類型
FILTER
支持的運(yùn)算符

- n/a
- 查詢ID為12000,名稱為"My Saved Filter"的過(guò)濾器授權(quán)給jsmith用戶的問(wèn)題:
filter = "My Saved Filter" and assignee = jsmith
或
filter = 12000 and assignee = jsmith
Fix Version
查詢某個(gè)具體修復(fù)版本的問(wèn)題,可通過(guò)版本名稱或版本ID進(jìn)行查詢。注:該字段支持自動(dòng)填寫(xiě)。
語(yǔ)法
fixVersion
字段類型
VERSION
支持的運(yùn)算符

當(dāng)使用 IN 和 NOT IN 運(yùn)算符時(shí),該字段支持:
- releasedVersions()
- latestReleasedVersion()
- unreleasedVersions()
- earliestUnreleasedVersion()
- versionMatch()
- 查找修復(fù)版本為3.14或4.2的問(wèn)題:
fixVersion in ("3.14", "4.2")
(注意保留字符要加雙引號(hào)) - 查詢修復(fù)版本為"Little Ted"的問(wèn)題:
fixVersion = "Little Ted"
- 查詢修復(fù)版本ID為10001的問(wèn)題:
fixVersion = 10001
- 查詢修復(fù)版本為15.2或其子版本的問(wèn)題:
fixVersion in (versionMatch("15.2.*"))
Issue Key
通過(guò)具體的問(wèn)題鍵或問(wèn)題ID查詢問(wèn)題。注:該字段不支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
issueKey
別名:
id
issue
key
字段類型
ISSUE
支持的運(yùn)算符

當(dāng)使用IN 或 NOT IN 運(yùn)算符時(shí),該字段支持:
- issueHistory()
- linkedIssues()
- votedIssues()
- watchedIssues()
- 查找問(wèn)題鍵為"ABC-123"的問(wèn)題:
issueKey = ABC-123
LastViewed
查找最后一次某個(gè)具體的日期或時(shí)間段瀏覽過(guò)的問(wèn)題,默認(rèn)午夜00:00為時(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í)間。注:該字段不支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
lastViewed
字段類型
DATE
支持的運(yùn)算符

當(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月12日之前的所有問(wèn)題:
lastViewed < "2010/12/12"
- 查找最后一次瀏覽是在2010年12月12日當(dāng)天或之前的所有問(wèn)題:
lastViewed <= "2010/12/13"
- 查找最后一次瀏覽是在2010年12月12日這一天并且是在下午2點(diǎn)之前的所有問(wèn)題:
lastViewed > "2010/12/12" and created < "2010/12/12 14:00"
- 查找最后一次瀏覽是在一天以前的問(wèn)題:
lastViewed > "-1d"
- 查找最后一次瀏覽是在2011年1月的所有問(wèn)題:
lastViewed > "2011/01/01" and created < "2011/02/01"
- 查找最后一次瀏覽是在2011年1月15日這一天的問(wèn)題:
lastViewed > "2011/01/15" and created < "2011/01/16"
Level
僅當(dāng)Issue Level Security被JIRA管理員啟用時(shí)可用。
通過(guò)具體的安全級(jí)別查找問(wèn)題,可通過(guò)問(wèn)題安全級(jí)別名稱或ID進(jìn)行查詢。注:該字段支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
level
字段類型
SECURITY LEVEL
支持的運(yùn)算符

- n/a
- 查找問(wèn)題安全級(jí)別為"Really High"或"level1"的問(wèn)題:
level in ("Really High", level1)
- 查找問(wèn)題安全級(jí)別ID為123的問(wèn)題:
level = 123
Original Estimate
僅當(dāng)JIRA管理員啟用時(shí)間追蹤后可用。
通過(guò)具體的初始估計(jì)值(是數(shù)字,而不是日期或日期范圍)查找問(wèn)題。使用"w", "d", "h"和"m"來(lái)指定周、天、時(shí)、分。注:該字段不支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
originalEstimate
別名:
timeOriginalEstimate
字段類型
DURATION
支持的運(yùn)算符

- n/a
- 查找初始估計(jì)為1小時(shí)的問(wèn)題:
originalEstimate = 1h
- 查找初始估計(jì)大于2天的問(wèn)題:
originalEstimate > 2d
Parent
僅當(dāng)JIRA管理員啟用子任務(wù)后可用。
查找某個(gè)具體問(wèn)題的所有子任務(wù),可通過(guò)問(wèn)題鍵或問(wèn)題ID進(jìn)行查找。注:該字段不支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
parent
字段類型
ISSUE
支持的運(yùn)算符

- n/a
- 查找TEST-1234問(wèn)題的子任務(wù):
parent = TEST-1234
相關(guān)產(chǎn)品購(gòu)買請(qǐng)咨詢""。