JIRA使用教程：高級搜索—字段參考（1/4）

---

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

字段列表：

• Affected Version
• Assignee
• Attachments
• Category
• Comment
• Component
• Created
• Creator
• Custom Field
• Description

Affected Version

搜索特定版本的問題。你可以通過版本名稱或版本ID（JIRA自動分配的版本號）進行搜索。通過版本ID搜索比版本名稱搜索更安全。
不同的項目可能有相同的版本名稱，因此通過版本名稱可能搜索出多個項目。也有可能JIRA的管理員更改了項目版本名稱，破壞了已保存搜索。然而版本ID是獨一無二的，而且不能被更改。
注：這個字段支持自動填寫功能。
語法
affectedVersion
字段類型
VERSION
支持的運算符

注意，比較運算符（如“>”）使用項目管理員設置的版本順序，而不是按數字或字母順序排列的。
支持的函數
當使用IN和NOT IN運算符時，該字段支持：

• releasedVersions()
• latestReleasedVersion()
• unreleasedVersions()
• earliestUnreleasedVersion()
• versionMatch()

示例：

• 查詢AffectedVersion為3.14的問題：
  affectedVersion = "3.14"
  (注意全站點保留字符要用引號)
• 查詢AffectedVersion為"Big Ted"的問題:
  affectedVersion = "Big Ted"
• 查詢AffectedVersion ID為10350的問題:
  affectedVersion = 10350

Assignee

查詢分配給特定用戶的問題。你可以通過用戶的全名、ID或郵件地址進行查詢。
注：該字段支持自動填寫功能。
語法
assignee
字段類型
USER
支持的運算符

支持的函數
當使用IN和NOT IN運算符時，該字段支持：

• membersOf()

當使用EQUALS和NOT EQUALS運算符時，該字段支持：

• currentUser()

示例：

• 查找分配給John Smith的問題:
  assignee = "John Smith"
  或
  assignee = "John Smith"
• 查找當前或已經分配給John Smith的問題:
  assignee WAS "John Smith"
  或
  assignee WAS jsmith
• 查找分配給郵箱為"bob@mycompany.com"的用戶的問題:
  assignee = "bob@mycompany.com"
  (注意全站點字符和“@”符號是保留字符，因此郵箱要加引號。)

Attachments

查詢帶有附件或沒有附件的問題。你可以僅使用該字段的EMPTY或IS NOT EMPTY運算符進行查詢。
注：該字段支持自動填充功能。
語法
attachments
字段類型
ATTACHMENT
支持的運算符

支持的函數
無
示例：

• 查詢帶有附件的問題：
  attachments IS NOT EMPTY
• 查詢不帶附件的問題：
  attachments IS EMPTY

Category

查詢某個具體分類項目里的問題。
注：該字段支持自動填寫功能。
語法
category
字段類型
CATEGORY
支持的運算符

支持的函數

• n/a

示例：

• 查找屬于"Alphabet Projects"類的項目的問題：
  category = "Alphabet Projects"

Comment

查找包含特定文本評論的問題。也可以使用JIRA文本搜索語法。
注：該字段不支持自動填寫功能。
語法
comment
字段類型
TEXT
支持的運算符

支持的函數

• n/a

示例：

• 查找評論里包含有"My PC is quite old"的問題（模糊匹配）：
  comment ~ "My PC is quite old"
• 查詢評論里含有完整語句"My PC is quite old"的問題：
  comment ~ "\"My PC is quite old\""

Component

查找某個項目特定分組里的問題。你可以通過組名和組ID（JIRA自動分配的）進行查詢。通過組ID查詢比組名更安全，因為組ID是唯一的。
注：該字段支持自動填寫功能。
語法
component
字段類型
COMPONENT
支持的運算符

支持的函數
當使用IN和NOT IN運算符時支持：

• componentsLeadByUser()

示例：

• 查找在"Comp1"或"Comp2"中的問題：
  component in (Comp1, Comp2)
• 查找同時在"Comp1"和"Comp2"中的問題：
  component in (Comp1) and component in (Comp2)
  或
  component = Comp1 and component = Comp2
• 查找組ID為20500的問題：
  component = 20500

Created

查找某個特定日期前或后創建的問題（或某個日期范圍）。注意，如果沒有指定具體時間，默認為凌晨00:00。查詢結果是根據你的JIRA服務器設置的時區。
使用如下格式：
"yyyy/MM/dd HH:mm"
"yyyy-MM-dd HH:mm"
"yyyy/MM/dd"
"yyyy-MM-dd"
或者使用"w" (周), "d" (天), "h" (小時)或"m" (分鐘)來指定相對于當前時間的日期。默認為“M”（分鐘）。一定要使用引號（“）;如果省略了引號標記，你提供的數字將被解釋為紀元（1970-1-1）之后的毫秒。
注：該字段不支持自動填寫功能。
語法
created
別名：
createdDate
字段類型
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月12日00:00點之前創建的所有問題：
  created < "2010/12/12"
• 查找2010年12月12日創建或2010年12月12日之前創建的所有問題：
  created <= "2010/12/13"
• 查找2010年12月12日下午2點之前創建的所有問題：
  created > "2010/12/12" and created < "2010/12/12 14:00"
• 查找創建不足一天的問題：
  created > "-1d"
• 查找在2011年1月創建的所有問題：
  created > "2011/01/01" and created < "2011/02/01"
• 查找在2011年1月15日創建的所有問題：
  created > "2011/01/15" and created < "2011/01/16"

Creator

查找具體某個用戶創建的問題，可以通過用戶的全名、ID或郵件地址進行查詢。
注：該字段支持自動填寫功能。
語法
Creator
字段類型
USER
支持的運算符

支持的函數
當使用IN和NOT IN運算符時，該字段支持：

• membersOf()

當使用EQUALS和NOT EQUALS運算符時，該字段支持：

• currentUser()

示例：

• 查找Jill Jones 創建的所有問題：
  creator = "Jill Jones"
  或
  creator = jjones
• 查找郵箱為"bob@mycompany.com"的用戶創建的所有問題：
  creator = "bob@mycompany.com"

Custom Field

只有在JIRA管理員已創建自定義字段的情況下可用。
查找某個具體值的自定義字段的問題。你可以通過自定義字段名稱或自定義字段ID（JIRA自動分配的）進行查找。
通過ID查找比按名稱查找更安全，因為ID是唯一的。
注：
JIRA文本搜索語法可用于類型為“Text”的自定義字段。
自動填寫功能支持自定義字段的picker, group picker, select, check-box and radio button字段類型。
語法
CustomFieldName
別名：
cf[CustomFieldID]
字段類型
取決于自定義字段的配置。
支持的運算符
不同類型的自定義運算符支持不同的運算符。
Number和date/time類型:

Picker, select, check-box and radio button類型: Text類型: 支持的函數
不同類型的自定義字段支持不同的函數：

• Date/time類型: 當使用EQUALS, NOT EQUALS, GREATER THAN, GREATER THAN EQUALS, LESS THAN或LESS THAN EQUALS 運算符時，該字段支持：
  • currentLogin()
  • lastLogin()
  • now()
  • startOfDay()
  • startOfWeek()
  • startOfMonth()
  • startOfYear()
  • endOfDay()
  • endOfWeek()
  • endOfMonth()
  • endOfYear()
• Version picker類型: 當使用IN 和 NOT IN 運算符時，該字段支持：
  • releasedVersions()
  • latestReleasedVersion()
  • unreleasedVersions()
  • earliestUnreleasedVersion()
  • versionMatch()

示例：

• 查找自定義字段"Location"值為"New York"的問題：
  location = "New York"
• 查找ID為10003的自定義字段值為"New York"的問題：
  cf[10003] = "New York"
• 查找名為"Location"的自定義字段值為"London"或"Milan"或"Paris"的問題：
  cf[10003] in ("London", "Milan", "Paris")
• 查找名為"Location"自定義字段的所有問題：
  location != empty

Description

通過描述查找包含具體文本的問題。也可用JIRA文本搜索語法。
注：該字段不支持自動填寫功能。
語法
description
字段類型
TEXT
支持的運算符

支持的函數

• n/a

示例：

• 查找描述文本里含有"Please see screenshot"的問題（模糊匹配）：
  description ~ "Please see screenshot"
• 查找描述文本里含有完整語句"Please see screenshot"的問題：
  description ~ "\"Please see screenshot\""

相關產品購買請咨詢""。