JIRA使用教程:高級(jí)搜索—字段參考(1/4)
JQL中的字段是JIRA中的字段(或已在JIRA中定義過(guò)的自定義字段)。在一個(gè)查詢語(yǔ)句中,字段緊跟在運(yùn)算符后面,而字段后面又跟著一個(gè)或多個(gè)值(或函數(shù))。運(yùn)算符比較字段的一個(gè)或多個(gè)值,使得查詢語(yǔ)句僅返回正確的結(jié)果。
字段列表:
- Affected Version
- Assignee
- Attachments
- Category
- Comment
- Component
- Created
- Creator
- Custom Field
- Description
Affected Version
搜索特定版本的問(wèn)題。你可以通過(guò)版本名稱或版本ID(JIRA自動(dòng)分配的版本號(hào))進(jìn)行搜索。通過(guò)版本ID搜索比版本名稱搜索更安全。
不同的項(xiàng)目可能有相同的版本名稱,因此通過(guò)版本名稱可能搜索出多個(gè)項(xiàng)目。也有可能JIRA的管理員更改了項(xiàng)目版本名稱,破壞了已保存搜索。然而版本ID是獨(dú)一無(wú)二的,而且不能被更改。
注:這個(gè)字段支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
affectedVersion
字段類型
VERSION
支持的運(yùn)算符
支持的函數(shù)
當(dāng)使用IN和NOT IN運(yùn)算符時(shí),該字段支持:
- releasedVersions()
- latestReleasedVersion()
- unreleasedVersions()
- earliestUnreleasedVersion()
- versionMatch()
- 查詢AffectedVersion為3.14的問(wèn)題:
affectedVersion = "3.14"
(注意全站點(diǎn)保留字符要用引號(hào)) - 查詢AffectedVersion為"Big Ted"的問(wèn)題:
affectedVersion = "Big Ted"
- 查詢AffectedVersion ID為10350的問(wèn)題:
affectedVersion = 10350
Assignee
查詢分配給特定用戶的問(wèn)題。你可以通過(guò)用戶的全名、ID或郵件地址進(jìn)行查詢。
注:該字段支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
assignee
字段類型
USER
支持的運(yùn)算符
當(dāng)使用IN和NOT IN運(yùn)算符時(shí),該字段支持:
- membersOf()
- currentUser()
- 查找分配給John Smith的問(wèn)題:
assignee = "John Smith"
或assignee = "John Smith"
- 查找當(dāng)前或已經(jīng)分配給John Smith的問(wèn)題:
assignee WAS "John Smith"
或
assignee WAS jsmith
- 查找分配給郵箱為"bob@mycompany.com"的用戶的問(wèn)題:
assignee = "bob@mycompany.com"
(注意全站點(diǎn)字符和“@”符號(hào)是保留字符,因此郵箱要加引號(hào)。)
Attachments
查詢帶有附件或沒(méi)有附件的問(wèn)題。你可以僅使用該字段的EMPTY或IS NOT EMPTY運(yùn)算符進(jìn)行查詢。
注:該字段支持自動(dòng)填充功能。
語(yǔ)法
attachments
字段類型
ATTACHMENT
支持的運(yùn)算符
無(wú)
示例:
- 查詢帶有附件的問(wèn)題:
attachments IS NOT EMPTY
- 查詢不帶附件的問(wèn)題:
attachments IS EMPTY
Category
查詢某個(gè)具體分類項(xiàng)目里的問(wèn)題。
注:該字段支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
category
字段類型
CATEGORY
支持的運(yùn)算符
- n/a
- 查找屬于"Alphabet Projects"類的項(xiàng)目的問(wèn)題:
category = "Alphabet Projects"
Comment
查找包含特定文本評(píng)論的問(wèn)題。也可以使用JIRA文本搜索語(yǔ)法。
注:該字段不支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
comment
字段類型
TEXT
支持的運(yùn)算符
- n/a
- 查找評(píng)論里包含有"My PC is quite old"的問(wèn)題(模糊匹配):
comment ~ "My PC is quite old"
- 查詢?cè)u(píng)論里含有完整語(yǔ)句"My PC is quite old"的問(wèn)題:
comment ~ "\"My PC is quite old\""
Component
查找某個(gè)項(xiàng)目特定分組里的問(wèn)題。你可以通過(guò)組名和組ID(JIRA自動(dòng)分配的)進(jìn)行查詢。通過(guò)組ID查詢比組名更安全,因?yàn)榻MID是唯一的。
注:該字段支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
component
字段類型
COMPONENT
支持的運(yùn)算符
當(dāng)使用IN和NOT IN運(yùn)算符時(shí)支持:
- componentsLeadByUser()
- 查找在"Comp1"或"Comp2"中的問(wèn)題:
component in (Comp1, Comp2)
- 查找同時(shí)在"Comp1"和"Comp2"中的問(wèn)題:
component in (Comp1) and component in (Comp2)
或component = Comp1 and component = Comp2
- 查找組ID為20500的問(wèn)題:
component = 20500
Created
查找某個(gè)特定日期前或后創(chuàng)建的問(wèn)題(或某個(gè)日期范圍)。注意,如果沒(méi)有指定具體時(shí)間,默認(rèn)為凌晨00:00。查詢結(jié)果是根據(jù)你的JIRA服務(wù)器設(shè)置的時(shí)區(qū)。
使用如下格式:
"yyyy/MM/dd HH:mm"
"yyyy-MM-dd HH:mm"
"yyyy/MM/dd"
"yyyy-MM-dd"
或者使用"w" (周), "d" (天), "h" (小時(shí))或"m" (分鐘)來(lái)指定相對(duì)于當(dāng)前時(shí)間的日期。默認(rèn)為“M”(分鐘)。一定要使用引號(hào)(“);如果省略了引號(hào)標(biāo)記,你提供的數(shù)字將被解釋為紀(jì)元(1970-1-1)之后的毫秒。
注:該字段不支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
created
別名:
createdDate
字段類型
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日00:00點(diǎn)之前創(chuàng)建的所有問(wèn)題:
created < "2010/12/12"
- 查找2010年12月12日創(chuàng)建或2010年12月12日之前創(chuàng)建的所有問(wèn)題:
created <= "2010/12/13"
- 查找2010年12月12日下午2點(diǎn)之前創(chuàng)建的所有問(wèn)題:
created > "2010/12/12" and created < "2010/12/12 14:00"
- 查找創(chuàng)建不足一天的問(wèn)題:
created > "-1d"
- 查找在2011年1月創(chuàng)建的所有問(wèn)題:
created > "2011/01/01" and created < "2011/02/01"
- 查找在2011年1月15日創(chuàng)建的所有問(wèn)題:
created > "2011/01/15" and created < "2011/01/16"
Creator
查找具體某個(gè)用戶創(chuàng)建的問(wèn)題,可以通過(guò)用戶的全名、ID或郵件地址進(jìn)行查詢。
注:該字段支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
Creator
字段類型
USER
支持的運(yùn)算符
當(dāng)使用IN和NOT IN運(yùn)算符時(shí),該字段支持:
- membersOf()
- currentUser()
- 查找Jill Jones 創(chuàng)建的所有問(wèn)題:
creator = "Jill Jones"
或creator = jjones
- 查找郵箱為"bob@mycompany.com"的用戶創(chuàng)建的所有問(wèn)題:
creator = "bob@mycompany.com"
Custom Field
只有在JIRA管理員已創(chuàng)建自定義字段的情況下可用。
查找某個(gè)具體值的自定義字段的問(wèn)題。你可以通過(guò)自定義字段名稱或自定義字段ID(JIRA自動(dòng)分配的)進(jìn)行查找。
通過(guò)ID查找比按名稱查找更安全,因?yàn)镮D是唯一的。
注:
JIRA文本搜索語(yǔ)法可用于類型為“Text”的自定義字段。
自動(dòng)填寫(xiě)功能支持自定義字段的picker, group picker, select, check-box and radio button字段類型。
語(yǔ)法
CustomFieldName
別名:
cf[CustomFieldID]
字段類型
取決于自定義字段的配置。
支持的運(yùn)算符
不同類型的自定義運(yùn)算符支持不同的運(yùn)算符。
Number和date/time類型:
不同類型的自定義字段支持不同的函數(shù):
- Date/time類型: 當(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()
- Version picker類型: 當(dāng)使用IN 和 NOT IN 運(yùn)算符時(shí),該字段支持:
- releasedVersions()
- latestReleasedVersion()
- unreleasedVersions()
- earliestUnreleasedVersion()
- versionMatch()
- 查找自定義字段"Location"值為"New York"的問(wèn)題:
location = "New York"
- 查找ID為10003的自定義字段值為"New York"的問(wèn)題:
cf[10003] = "New York"
- 查找名為"Location"的自定義字段值為"London"或"Milan"或"Paris"的問(wèn)題:
cf[10003] in ("London", "Milan", "Paris")
- 查找名為"Location"自定義字段的所有問(wèn)題:
location != empty
Description
通過(guò)描述查找包含具體文本的問(wèn)題。也可用JIRA文本搜索語(yǔ)法。
注:該字段不支持自動(dòng)填寫(xiě)功能。
語(yǔ)法
description
字段類型
TEXT
支持的運(yùn)算符
- n/a
- 查找描述文本里含有"Please see screenshot"的問(wèn)題(模糊匹配):
description ~ "Please see screenshot"
- 查找描述文本里含有完整語(yǔ)句"Please see screenshot"的問(wèn)題:
description ~ "\"Please see screenshot\""
相關(guān)產(chǎn)品購(gòu)買請(qǐng)咨詢"在線客服"。