logo 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
支持的运算符

JIRA搜索字段
注意,比较运算符(如“>”)使用项目管理员设置的版本顺序,而不是按数字或字母顺序排列的。
支持的函数
当使用INNOT 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
支持的运算符

JIRA搜索字段
支持的函数
当使用INNOT IN运算符时,该字段支持:
  • membersOf()
当使用EQUALSNOT 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
支持的运算符

JIRA搜索字段
支持的函数

示例:
  • 查询带有附件的问题:
    attachments IS NOT EMPTY
  • 查询不带附件的问题:
    attachments IS EMPTY

Category

查询某个具体分类项目里的问题。
注:该字段支持自动填写功能。
语法
category
字段类型
CATEGORY
支持的运算符

JIRA搜索字段
支持的函数
  • n/a
示例:
  • 查找属于"Alphabet Projects"类的项目的问题:
    category = "Alphabet Projects"

Comment

查找包含特定文本评论的问题。也可以使用JIRA文本搜索语法。
注:该字段不支持自动填写功能。
语法
comment
字段类型
TEXT
支持的运算符

JIRA搜索字段
支持的函数
  • 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
支持的运算符

JIRA搜索字段
支持的函数
当使用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
支持的运算符

JIRA搜索字段
支持的函数
当使用 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
支持的运算符

JIRA搜索字段
支持的函数
当使用INNOT 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]
字段类型
取决于自定义字段的配置。
支持的运算符
不同类型的自定义运算符支持不同的运算符。
Numberdate/time类型:

JIRA搜索字段
Picker, select, check-box and radio button类型:
JIRA搜索字段
Text类型:
JIRA搜索字段
支持的函数
不同类型的自定义字段支持不同的函数:
  • 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类型: 当使用INNOT 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
支持的运算符

JIRA搜索字段
支持的函数
  • n/a
示例:
  • 查找描述文本里含有"Please see screenshot"的问题(模糊匹配):
    description ~ "Please see screenshot"
  • 查找描述文本里含有完整语句"Please see screenshot"的问题:
    description ~ "\"Please see screenshot\""

相关产品购买请咨询"在线客服"。