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()
- 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()
- 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类型:
不同类型的自定义字段支持不同的函数:
- 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\""
相关产品购买请咨询""。