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)算符

支持的函數(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日前截止的所有問(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)算符

支持的函數(shù)

• 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)算符

支持的函數(shù)
當(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ě)功能。

語(yǔ)法
filter
別名：
request
savedFilter
searchRequest
字段類型
FILTER
支持的運(yùn)算符

支持的函數(shù)

• 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)算符

支持的函數(shù)
當(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)算符

支持的函數(shù)
當(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)算符

支持的函數(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月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)算符

支持的函數(shù)

• 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)算符

支持的函數(shù)

• 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)算符

支持的函數(shù)

• n/a

示例

• 查找TEST-1234問(wèn)題的子任務(wù)：
  parent = TEST-1234

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