页面树结构

版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

...

内容区目录
maxLevel4
minLevel4
locationtop
typelist

affectedVersion
affectedVersion

AffectedVersion
AffectedVersion

影响版本

搜索指定影响版本的问题。 你可以按照版本名称或版本ID(JIRA自动为版本分配的数值)搜索 。

信息
title按照版本ID搜索比按照版本名称搜索更准确

不同的项目可能有相同名称的版本, 所有按照版本名称搜索可能会搜索到多个项目的问题。 当JIRA管理员更改版本的名称, 会使依赖版本名称的 过滤器 失效。 Version ID是唯一且无法修改的。

注意: 这个字段支持 自动完成

语法
代码块
affectedVersion
字段类型

版本 VERSION

支持的操作符
包含页面
quickstart:__JQL Operators supported by Numeric Fields
quickstart:__JQL Operators supported by Numeric Fields
nopaneltrue

注意比较运算符 (如 ">") 使用 版本排序(链接到Atlassian网站) 只按照JIRA管理员设置的顺序, 而不按照数值或字母顺序。

支持的函数

当使用 在...之内(IN)不在...之内(NOT IN) 运算符时, affectedVersion 支持:

示例
  • 查找影响版本是 3.14的问题:
    代码块
    affectedVersion = "3.14"
    (注意点(.)是保留 #字符, 所以你需要用引号括起来。)
  • 查找影响版本是"Big Ted"的问题:
    代码块
    affectedVersion = "Big Ted"
  • 查找影响版本ID是 10350的问题:
    代码块
    affectedVersion = 10350

Assignee
Assignee

经办人

搜索经办人是指定用户的问题。 你可以使用用户全名、ID或电子邮件地址。

注意: 这个字段支持 自动完成

语法
代码块
assignee
字段类型

用户 USER

支持的运算符
包含页面
quickstart:__JQL Operators supported by Select Fields
quickstart:__JQL Operators supported by Select Fields
nopaneltrue
支持的函数

当使用 #IN#NOT_IN 运算符时, assignee 支持:

当使用 等于不等于 运算符时, assignee 支持:

示例
  • 搜索分配给John Smith的问题:
    代码块
    assignee = "John Smith"
    代码块
    assignee = jsmith
  • 搜索经办人邮件地址是 "bob@mycompany.com"的问题:
    代码块
    assignee = "bob@mycompany.com"
    (注意句号(.)和 "@" 符号是保留 #字符, 所以需要用引号将邮件地址括起来。)

Category
Category

类别

搜索属于指定项目类别的项目下的所有问题。

注意: 这个字段支持 自动完成

语法
代码块
category
字段类型

类别 CATEGORY

支持的运算符
包含页面
quickstart:__JQL Operators supported by Select Fields
quickstart:__JQL Operators supported by Select Fields
nopaneltrue
支持的函数

n/a

示例
  • 搜索属于 "内部项目"类别下的所有问题:
    代码块
     category = "内部项目"

Comment
Comment

Comments
Comments

备注

搜索备注中包含指定字符的问题。

可以使用JIRA 文本搜索语法

注意: 这个字段不支持 自动完成

语法
代码块
comment
字段类型

文本 TEXT

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Fields (excluding IS)
quickstart:__JQL Operators supported by Text Fields (excluding IS)
nopaneltrue
支持的函数

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
Component

模块

搜索一个项目中的指定 模块的问题。 你可以按照模块名称或模块ID (JIRA自动分配给模块的数字)搜索。

信息
title搜索模块ID搜索比搜索模块名称更准确

不同的项目可能有相同的模块名称, 所以按照模块名称搜索可能会返回多个项目的问题。 JIRA管理员一旦修改了模块名称, 以模块名称为条件的 过滤器将无法使用。 模块ID是唯一且不能修改的。

注意: 这个字段支持自动完成

语法
代码块
component
字段类型

模块 COMPONENT

支持的运算符
包含页面
quickstart:__JQL Operators supported by Select Fields
quickstart:__JQL Operators supported by Select Fields
nopaneltrue
支持的函数

当使用 在...之内(IN)不在...之内(NOT IN) 运算符时, component 支持:

示例
  • 查找模块是 "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
Created

CreatedDate
CreatedDate

createdDate
createdDate

创建日期

按照指定的创建日期范围搜索问题。

包含页面
quickstart:__JQL Date Formats
quickstart:__JQL Date Formats
nopaneltrue

注意: 这个字段不支持 自动完成

语法
代码块
created

或者:

代码块
createdDate
字段类型

日期 DATE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Numeric Fields
quickstart:__JQL Operators supported by Numeric Fields
nopaneltrue
支持的函数

当使用 等于, 不等于, 大于, 大于等于, 小于小于等于 运算符时, createdDate 支持:

示例
  • 查找2008年12月12日 00:00之前创建的问题(包括00:00):
    代码块
    created <= "2008/12/12"
  • 查找1天以前创建的问题:
    代码块
    created > "-1d"
  • 查找2009年1月创建的问题:
    代码块
    created > "2008/12/31" and created < "2009/02/01"
  • 查找2009年1月15日创建的问题:
    代码块
    created > "2009/01/14" and created < "2009/01/16"

custom
custom

自定义字段

只有当JIRA管理员已经创建了 自定义字段(链接到Atlassian网站)才有效

按照指定自定义字段值查找问题。

你可以按照自定义字段名称或自定义字段ID(JIRA自动为自定义字段分配的数值)搜索。

信息
title搜索自定义字段ID比搜索自定义字段名称更准确

JIRA中自定义字段名称可能会与系统字段名称相同, 这种情况下,如果按照自定义字段名称搜索,JIRA只会搜索系统个字段,而不搜索自定义字段。 一旦JIRA管理员修改了自定义字段名称, 以自定义字段名称为搜索条件的 过滤器 将无法工作。自定义字段ID是唯一且无法修改的。

注意:

  • JIRA文本搜索语法 可以用于'文本'类型的自定义字段。
  • 自动完成 支持选择器类型、用户组选择器类型, 选择列表类型 (不包括 '级联选择类型'), 复选框类型和单选按钮类型的自定义字段。
语法
代码块
CustomFieldName

或者:

代码块
cf[CustomFieldID]
字段类型

依赖于自定义字段(链接到Atlassian网站)的配置。

支持的运算符

不同类型的自定义字段支持不同的 运算符。 对于默认的自定义字段(链接到Atlassian网站), 支持下面的运算符:

  • 数值和日期/时间类型字段:
    包含页面
    quickstart:__JQL Operators supported by Numeric Fields
    quickstart:__JQL Operators supported by Numeric Fields
    nopaneltrue
  • 选择器, 选择列表, 复选框和单选按钮类型字段:
    包含页面
    quickstart:__JQL Operators supported by Select Fields
    quickstart:__JQL Operators supported by Select Fields
    nopaneltrue
  • 文本类型字段:
    包含页面
    quickstart:__JQL Operators supported by Text Fields
    quickstart:__JQL Operators supported by Text Fields
    nopaneltrue
支持的函数

不同类型的自定义字段支持不同的 函数。 对于默认的自定义字段(链接到Atlassian网站), 支持下面的函数:

示例
  • 查找自定义字段 "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
Description

描述

搜索 描述中包含指定字符的问题。

可以使用JIRA文本搜索语法

注意: 这个字段不支持 自动完成

语法
代码块
description
字段类型

文本 TEXT

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Fields
quickstart:__JQL Operators supported by Text Fields
nopaneltrue
支持的函数

n/a

示例
  • 模糊搜索描述中包含 "Please see screenshot" 的问题:
    代码块
    description ~ "Please see screenshot"
  • 精确搜索描述中包含 "Please see screenshot" 的问题:
    代码块
    description ~ "\"Please see screenshot\""

Due
Due

DueDate
DueDate

dueDate
dueDate

逾期日期 Due

按照问题的逾期日期范围搜索问题。

包含页面
quickstart:__JQL Date Formats
quickstart:__JQL Date Formats
nopaneltrue

注意逾期日期只能根据 日期 计算 (不能根据时间计算)。

注意: 这个字段不支持 自动完成

语法
代码块
due

或者:

代码块
dueDate
字段类型

日期 DATE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Numeric Fields
quickstart:__JQL Operators supported by Numeric Fields
nopaneltrue
支持的函数

当使用 等于, 不等于, 大于, 大于等于, 小于小于等于 运算符时, dueDate 支持:

示例
  • 搜索截止2009年1月1日逾期的问题:
    代码块
    due <= "2008/12/31"
  • 查找明天到期的问题:
    代码块
    due = "1d"
  • 查找2009年1月到期的问题:
    代码块
    due > "2008/12/31" and due < "2009/02/01"
  • 查找2009年1月15日到期的问题:
    代码块
    due > "2009/01/14" and due < "2009/01/16"

Environment
Environment

环境

搜索 环境 字段中包含指定字符的问题。

可以使用JIRA文本搜索语法

注意: 这个字段不支持 自动完成

语法
代码块
environment
字段类型

文本 TEXT

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Fields
quickstart:__JQL Operators supported by Text Fields
nopaneltrue
支持的函数

n/a

示例
  • 模糊搜索环境中包括 "Third floor"的问题:
    代码块
    environment ~ "Third floor"
  • 精确匹配环境中包含"Third floor"的问题:
    代码块
    environment ~ "\"Third floor\""

filter
filter

过滤器

你可以直接在JQL中使用 保存的过滤器 。 可以使用过滤器名称或过滤器ID(JIRA自动为过滤器分配的数值)搜索。

信息
title搜索过滤器ID 比搜索过滤器名称更精确

一旦修改了过滤器名称, 以过滤器名称为条件的其他过滤器将失效。 过滤器 ID是唯一且不能更改的。

注意:

  • 输入的查询语句中的 排序 (ORDER BY) 表达式将会代替过滤器中的 ORDER BY 表达式。
  • 你不能执行或保存一个无限循环的过滤器 (例如 当一个被引用的过滤器中又引用的当前的过滤器,是无法执行的。)。
  • 这个字段支持 自动完成
    语法
    代码块
    filter
    或者:
    代码块
    request
    代码块
    savedFilter
    代码块
    searchRequest
字段类型

过滤器 FILTER

支持的运算符
包含页面
quickstart:__JQL Operators supported by Select Fields (excluding IS)
quickstart:__JQL Operators supported by Select Fields (excluding IS)
nopaneltrue
支持的函数

n/a

示例
  • 返回过滤器 "My Saved Filter" (过滤器ID是 12000)中经办人是jsmith的问题:
    代码块
    filter = "My Saved Filter" and assignee = jsmith
    代码块
    filter = 12000 and assignee = jsmith

FixVersion
FixVersion

fixVersion
fixVersion

修复版本

按照指定的 修复版本搜索问题。 你可以使用版本名称或版本ID (JIRA自动为版本分配的数值)搜索。

信息
title按照版本ID搜索比按照版本名称搜索更准确

不同的项目可能有相同名称的版本, 所有按照版本名称搜索可能会搜索到多个项目的问题。 当JIRA管理员更改版本的名称, 会使依赖版本名称的 过滤器 失效。 Version ID是唯一且无法修改的。

注意: 这个字段支持自动完成

语法
代码块
fixVersion
字段类型

版本 VERSION

支持的运算符
包含页面
quickstart:__JQL Operators supported by Numeric Fields
quickstart:__JQL Operators supported by Numeric Fields
nopaneltrue

注意比较运算符 (如 ">") 使用 版本排序(链接到Atlassian网站) 只按照JIRA管理员设置的顺序, 而不按照数值或字母顺序。

支持的函数

当使用 在...之内(IN)不在...之内(NOT IN) 运算符时, fixVersion 支持:

示例
  • 查找修复版本是 3.14 或 4.2的问题:
    代码块
     fixVersion in ("3.14", "4.2")
    (注意句号(.)是JIRA保留 #字符, 所以你需要用引号将其括起来。)
  • 查找修复版本是 "Little Ted"的问题:
    代码块
    fixVersion = "Little Ted"
  • 查找修复版本ID 是10001的问题:
    代码块
    fixVersion = 10001

Issue
Issue

问题键值

按照指定的 问题键值 或问题ID (JIRA自动为问题分配的数值)。

注意: 这个字段不支持 自动完成

语法
代码块
issueKey

或者:

代码块
id
代码块
issue
代码块
key
字段类型

问题 ISSUE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Numeric Fields
quickstart:__JQL Operators supported by Numeric Fields
nopaneltrue
支持的函数

当使用 在...之内(IN)不在...之内(NOT IN) 运算符时, issueKey 支持:

示例
  • 查找键值是 "ABC-123"的问题:
    代码块
    issueKey = ABC-123 

Level
Level

安全级别

只有当JIRA管理员 开启了问题安全级别(链接到Atlassian网站)时才有效

按照指定的 安全级别(连接到Atlassian网站)搜索问题。 你可以按照问题安全级别或问题安全级别ID(JIRA自动为问题安全级别分配的数值)搜索。

信息
title搜索安全级别ID比搜索安全级别名称更准确

一旦JIRA管理员修改了安全级别名称, 以安全级别名称为条件的 过滤器 将无法工作。 安全级别ID是唯一且不能被修改的。

注意: 这个字段支持自动完成

语法
代码块
level
字段类型

安全级别 SECURITY LEVEL

支持的运算符
包含页面
quickstart:__JQL Operators supported by Select Fields
quickstart:__JQL Operators supported by Select Fields
nopaneltrue
支持的函数

n/a

示例
  • 搜索安全级别是 "Really High" 或 "level1"的问题:
    代码块
    level in ("Really High", level1)
  • 搜索安全级别ID 是123的问题:
    代码块
    level = 123

originalEstimate
originalEstimate

OriginalEstimate
OriginalEstimate

初始预估时间

只有JIRA管理员 开启了事件跟踪 才有效

按照 初始预估时间 的值(只能是数字, 不能是日期或日期范围)搜索问题

使用 "w", "d", "h" 和 "m" 来指定周, 日, 小时或分钟。

注意: 这个字段不支持 自动完成

语法
代码块
originalEstimate

或者:

代码块
timeOriginalEstimate
字段类型

期间 DURATION

支持的运算符
包含页面
quickstart:__JQL Operators supported by Numeric Fields
quickstart:__JQL Operators supported by Numeric Fields
nopaneltrue
支持的函数

n/a

示例
  • 查找初始预估时间为1小时的问题:
    代码块
    originalEstimate = 1h
  • 查找初始预估时间大于2天的问题:
    代码块
    originalEstimate > 2d

Parent
Parent

父问题

只有当JIRA管理员 开启子任务(连接到Atlassian网站) 才有效

搜索指定问题的所有 子任务。 你可以按照 问题键值 或问题ID (JIRA自动为问题分配的数值)搜索。

注意: 这个字段不支持 自动完成

语法
代码块
parent
字段类型

问题 ISSUE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Select Fields (excluding IS)
quickstart:__JQL Operators supported by Select Fields (excluding IS)
nopaneltrue
支持的函数

n/a

示例
  • 搜索问题 TEST-1234的所有子任务:
    代码块
    parent = TEST-1234

Priority
Priority

优先级

按照指定的 优先级搜索问题。 你可以使用优先级名称或优先级ID (JIRA自动为优先级分配的数值)搜索。

信息
title搜索优先级ID比搜索优先级名称更准确

一旦JIRA管理员修改了优先级名称, 以优先级名称为搜索条件的 过滤器将无法工作。 优先级ID是唯一且无法更改的。

注意: 这个字段支持自动完成

语法
代码块
priority
字段类型

优先级 PRIORITY

支持的运算符
包含页面
quickstart:__JQL Operators supported by Numeric Fields
quickstart:__JQL Operators supported by Numeric Fields
nopaneltrue
支持的函数

n/a

示例
  • 搜索优先级时 "High"的问题:
    代码块
     priority = High
  • 搜索优先级ID是10000的问题:
    代码块
    priority = 10000

Project
Project

项目

搜索指定 项目 中的问题。

你可以按照 项目名称(链接到Atlassian网站), 或 项目键值(链接到Atlassian网站) 或项目ID (JIRA自动为项目分配的数值)搜索。

注意: 这个字段支持自动完成

语法
代码块
project
字段类型

项目 PROJECT

支持的运算符
包含页面
quickstart:__JQL Operators supported by Select Fields
quickstart:__JQL Operators supported by Select Fields
nopaneltrue
支持的函数

当使用 在...之内(IN)不在...之内(NOT IN)运算符时, project 支持:

示例
  • 查找项目名称是 "ABC Project"的问题:
    代码块
     project = "ABC Project" 
  • 查找项目键值是 "ABC"的问题:
    代码块
    project = "ABC"
  • 查找项目ID是 "1234"的问题:
    代码块
    project = 1234

remainingEstimate
remainingEstimate

RemainingEstimate
RemainingEstimate

剩余预估时间

只有JIRA管理员 开启了事件跟踪 才有效

按照 剩余预估时间 的值(只能是数字, 不能是日期或日期范围)搜索问题

使用 "w", "d", "h" 和 "m" 来指定周, 日, 小时或分钟。

注意: 这个字段不支持 自动完成

语法
代码块
remainingEstimate

Alias:

代码块
timeEstimate
字段类型

期间 DURATION

支持的运算符
包含页面
quickstart:__JQL Operators supported by Numeric Fields
quickstart:__JQL Operators supported by Numeric Fields
nopaneltrue
支持的函数

n/a

示例
  • 查找剩余预估时间大于4小时的问题:
    代码块
     remainingEstimate > 4h 

Reporter
Reporter

报告人

按照指定的报告人(创建人)搜索问题。

你可以按照用户全称、ID或邮件地址搜索。

注意: 这个字段支持自动完成

语法
代码块
reporter
字段类型

用户 USER

支持的运算符
包含页面
quickstart:__JQL Operators supported by Select Fields
quickstart:__JQL Operators supported by Select Fields
nopaneltrue
支持的函数

当使用 在...之内(IN)不在...之内(NOT IN) 运算符时, reporter 支持:

当使用 等于不等于 运算符时, reporter 支持:

示例
  • 搜索由Jill Johns创建的问题:
    代码块
    reporter = "Jill Jones"
    代码块
    reporter = jjones
  • 搜索报告人邮件地址是"bob@mycompany.com"的问题:
    代码块
    assignee = "bob@mycompany.com"
    (注意句号(.)和 "@" 符号是JIRA保留 #字符, 所以你需要用引号将其括起来。)

Resolution
Resolution

解决结果

按照指定的 解决结果搜索问题。

你可以将解决结果的名称和ID(JIRA自动为解决结果分配的数值)作为搜索条件。

信息
title搜索解决结果ID比搜索解决结果名称更准确

一旦JIRA管理员更改了解决结果的名称, 以解决结果名称为条件的 过滤器 将无法工作。 而解决结果ID是唯一且不能修改的。

注意: 这个字段支持自动完成

语法
代码块
resolution
字段类型

解决结果 RESOLUTION

支持的运算符
包含页面
quickstart:__JQL Operators supported by Numeric Fields
quickstart:__JQL Operators supported by Numeric Fields
nopaneltrue
支持的函数

n/a

示例
  • 查找解决方法为"Cannot Reproduce" 或 "Won't Fix"的问题:
    代码块
     resolution in ("Cannot Reproduce", "Won't Fix")
  • 查找解决方法ID为5的问题:
    代码块
    resolution = 5
  • 查找还没有解决的问题:
    代码块
    resolution = unresolved

Resolved
Resolved

ResolutionDate
ResolutionDate

resolutionDate
resolutionDate

解决日期

按照指定的解决日期或解决日期的范围查找问题。

包含页面
quickstart:__JQL Date Formats
quickstart:__JQL Date Formats
nopaneltrue

注意: 这个字段不支持 自动完成

语法
代码块
resolved

或者:

代码块
resolutionDate
字段类型

日期 DATE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Numeric Fields
quickstart:__JQL Operators supported by Numeric Fields
nopaneltrue
支持的函数

当使用 等于, 不等于, 大于, 大于等于, 小于#LESS_THAN_EQUALS 运算符时, resolved 支持:

示例
  • 查找2008年12月31日00:00之前解决的问题:
    代码块
    resolved <= "2008/12/31"
  • 查找2009年1月解决的问题:
    代码块
    resolved > "2008/12/31" and resolved < "2009/02/01"
  • 查找2009年1月15日解决的问题:
    代码块
    resolved > "2009/01/14" and resolved < "2009/01/16"
  • 查找前一小时之内解决的问题:
    代码块
    resolved > -1h

Status
Status

状态

按照指定的 状态查找问题。

你可以按照状态名称或状态ID(JIRA自动为状态分配的数值)搜索问题。

信息
title搜索状态ID比搜索状态名称更准确

一旦JIRA管理员更改了状态名称,按照状态名称为搜索条件的 过滤器 将无法工作。 状态ID是唯一且无法更改的。

注意: 这个字段支持自动完成

语法
代码块
status
字段类型

状态 STATUS

支持的运算符
包含页面
quickstart:__JQL Operators supported by Select Fields
quickstart:__JQL Operators supported by Select Fields
nopaneltrue
支持的函数

n/a

示例
  • 查找状态是"Open"的问题:
    代码块
     status = Open
  • 查找状态ID 是1的问题:
    代码块
    status = 1

Summary
Summary

主题

按照主题中指定的字符查找问题。

可以使用JIRA 文本搜索语法

注意: 这个字段不支持自动完成

语法
代码块
summary
字段类型

文本 TEXT

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Fields
quickstart:__JQL Operators supported by Text Fields
nopaneltrue
支持的函数

n/a

示例
  • Find issues where the Summary contains text that matches 模糊查找主题中包含 "Error saving file" (i.e. a "fuzzy" match)的问题:
    代码块
    summary ~ "Error saving file"
  • Find issues where the Summary contains the exact phrase 精确查找主题中包含 "Error saving file"的问题:
    代码块
    summary ~ "\"Error saving file\""

text
text

Text
Text

Text

文本

可以在以下文本字段内容中查找包含指定字符的问题This is a "master-field" that allows you to search all text fields, i.e.:

包含页面
quickstart:__JQL Text Fields
quickstart:__JQL Text Fields
nopaneltrue

Note注意: The text master-field can only be used with the #CONTAINS operator text 只能和 包含 运算符 ("~" and 以及 "!~"). 结合使用。

语法
代码块
text
字段类型

文本 TEXT

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Fields (excluding IS and NOT)
quickstart:__JQL Operators supported by Text Fields (excluding IS and NOT)
nopaneltrue
支持的函数

n/a

示例
  • Find issues where a text field matches the word 查找文本字段中包括"Fred"的问题:
    代码块
    text ~ "Fred"
    or
    代码块
    text ~ Fred
  • Find all issues where a text field contains the exact phrase 精确查找文本字段中包括"full screen"的问题:
    代码块
    text ~ "\"full screen\""

Type
Type

Type

Search for issues that have a particular Issue Type.

问题类型

按照指定的 问题类型搜索问题

你可以按照问题类型名称或问题类型ID (JIRA自动为问题类型分配的数值)搜索问题。 You can search by Issue Type name or Issue Type ID (i.e. the number that JIRA automatically allocates to an Issue Type).

信息
titleIt is safer to search by Type ID than Type name搜索问题类型ID比搜索问题类型名称更准确

一旦JIRA管理员修改了问题类型名称,以问题类型名称为搜索条件的过滤器 将无法工作。 问题类型ID是唯一且不能修改的。It is possible for your JIRA administrator to change the name of a Type, which could break any saved filter which rely on that name. Type IDs, however, are unique and cannot be changed.

注意: 这个字段支持自动完成

语法
代码块
type

Alias或者:

代码块
issueType
字段类型

问题类型 ISSUE_TYPE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Select Fields
quickstart:__JQL Operators supported by Select Fields
nopaneltrue
支持的函数

n/a

示例
  • Find issues with an Issue Type of 查找问题类型是"Bug"的问题:
    代码块
    type = Bug
  • Find issues with an Issue Type of 查找问题类型是"Bug" or "Improvement"的问题:
    代码块
     issueType in (Bug,Improvement)
  • Find issues with an Issue Type ID of 2查找问题类型ID是2的问题:
    代码块
    issueType = 2

TimeSpent
TimeSpent

timeSpent
timeSpent

Time Spent

Only available if time-tracking has been enabled by your JIRA administrator.

实际工作时间

只有当JIRA管理员 开启了时间跟踪(链接到)才有效

按照 实际工作时间 的值 (只能是数字,不能是日期或日期范围)搜索问题。Search for issues where the Time Spent is set to a particular value (i.e. a number, not a date or date range).

使用 "w", "d", "h" 和 "m" 来指定周, 日, 小时或分钟。

注意: 这个字段不支持自动完成

语法
代码块
timeSpent
字段类型

期间 DURATION

支持的运算符
包含页面
quickstart:__JQL Operators supported by Numeric Fields
quickstart:__JQL Operators supported by Numeric Fields
nopaneltrue
支持的函数

n/a

示例
  • Find issues where the Time Spent is more than 5 days查找实际工作时间大于5天的问题:
    代码块
    timeSpent > 5d

Updated
Updated

UpdatedDate
UpdatedDate

updatedDate
updatedDate

Updated

更新日期

按照指定的日期或日期范围查找被更新的问题。 Search for issues that were last updated on, before or after a particular date (or date range).

包含页面
quickstart:__JQL Date Formats
quickstart:__JQL Date Formats
nopaneltrue

注意: 这个字段不支持自动完成

语法
代码块
updated

Alias或者:

代码块
updatedDate
字段类型

日期 DATE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Numeric Fields
quickstart:__JQL Operators supported by Numeric Fields
nopaneltrue
支持的函数

When used with the #EQUALS, #NOT_EQUALS, #GREATER_THAN, #GREATER_THAN_EQUALS, 当使用 等于, 不等于, 大于, 大于等于, 小于#LESS_THAN or #LESS_THAN_EQUALS operators 运算符时, updated supports 支持:

示例
  • Find issues that were updated on or before 12th December 2008 00:00查找2008年12月12日00:00之前更新的问题:
    代码块
    updated <= "2008/12/12"
  • Find issues that were updated more than two weeks ago查找2周之前更新的问题:
    代码块
    updated < "-2w"
  • Find issues that were updated on 15 January 2009查找2009年1月15日更新的问题:
    代码块
    updated > "2009/01/14" and updated < "2009/01/16"
  • 查找2009年1月更新的问题Find issues that were updated in January 2009:
    代码块
    updated > "2008/12/31" and updated < "2009/02/01"

voter
voter

Voter
Voter

Voter

投票人

按照指定的投票人查找问题。 你可以按照用户全名、ID 或电子邮件地址搜索。 需要注意的是,你必须拥有 "查看投票人及关注者"权限(链接到Atlassian网站)才能根据投票人搜索问题, 否则你只能搜索你自己投票的问题。具体内容参见 投票的问题Search for issues for which a particular user has voted. You can search by the user's Full Name, ID or Email Address. Note that you can only find issues for which you have the "View Voters and Watchers" permission, unless you are searching for your own votes. See also #votedIssues.

注意: 这个字段支持自动完成

语法
代码块
voter
字段类型

USER

支持的运算符
包含页面
quickstart:__JQL Operators supported by Select Fields
quickstart:__JQL Operators supported by Select Fields
nopaneltrue
支持的函数

When used with the #IN and #NOT_IN operators, voter supports当使用 在...之内(IN)不在...之内(NOT IN) 运算符时, voter 支持:

When used with the #EQUALS and #NOT_EQUALS operators, voter supports:

当使用 等于 以及 不等于 运算符时, voter 支持:

示例
  • Search for issues for which you have voted搜索你自己投票的问题:
    代码块
    voter = currentUser()
  • Search for issues for which the user 搜索 "jsmith" has voted投票的问题:
    代码块
    voter = "jsmith"
  • Search for issues for which a member of the group 搜索用户组 "jira-developers" has voted所有成员投票的问题:
    代码块
    voter in membersOf("jira-developers")

Votes
Votes

Votes

投票数量

搜索指定投票数量的问题。 Search for issues with a specified number of votes.

注意: 这个字段不支持自动完成

语法
代码块
votes
字段类型

NUMBER

支持的运算符
包含页面
quickstart:__JQL Operators supported by Numeric Fields (excluding IS)
quickstart:__JQL Operators supported by Numeric Fields (excluding IS)
nopaneltrue
支持的函数

n/a

示例
  • Find all issues that have 12 or more votes查找投票数大于等于12的问题:
    代码块
    votes >= 12

watcher
watcher

Watcher
Watcher
Watcher

关注人

按照指定关注人搜索问题。 你可以按照用户全称、ID或电子邮件地址搜索。 需要注意的是,你必须拥有 "查看投票人及关注者"权限(链接到Atlassian网站)才能根据关注人搜索问题, 否则你只能搜索你自己关注的问题。具体信息请参阅 关注的问题Search for issues that a particular user is watching. You can search by the user's Full Name, ID or Email Address. Note that you can only find issues for which you have the "View Voters and Watchers" permission, unless you are searching for issues where you are the watcher. See also #watchedIssues.

注意: 这个字段支持自动完成

语法
代码块
voter
字段类型

USER

支持的运算符
包含页面
quickstart:__JQL Operators supported by Select Fields
quickstart:__JQL Operators supported by Select Fields
nopaneltrue
支持的函数

When used with the #IN and #NOT_IN operators, watcher supports当使用 在...之内(IN)不在...之内(NOT IN) 运算符时, watcher 支持:

When used with the #EQUALS and #NOT_EQUALS operators, watcher supports:

当使用 等于不等于 运算符时, watcher 支持:

示例
  • Search for issues that you are watching搜索你关注的问题:
    代码块
    watcher = currentUser()
  • Search for issues that the user 搜索 "jsmith" is watching关注的问题:
    代码块
    watcher = "jsmith"
  • Search for issues that are being watched by a member of the group 搜索用户组"jira-developers"的成员关注的问题:
    代码块
    watcher in membersOf("jira-developers")

WorkRatio
WorkRatio

workRatio
workRatio

Work Ratio

Only available if time-tracking has been enabled by your JIRA administrator.

Search for issues where the Work Ratio has a particular value.

工作时间比率

只有当JIRA管理员 开启了时间跟踪(链接到)才有效

按照指定的工作时间比率的值搜索问题。

工作时间比率的计算公式是: 工作时间比率 = 实际工作时间 / 初始预估时间Work Ratio is calculated as follows: workRatio = #timeSpent / #originalEstimate) x 100

注意: 这个字段不支持自动完成

语法
代码块
workRatio
字段类型

数值 NUMBER

支持的运算符
包含页面
quickstart:__JQL Operators supported by Numeric Fields
quickstart:__JQL Operators supported by Numeric Fields
nopaneltrue
支持的函数

n/a

示例
  • Find issues on which more than 75% of the Original Estimate has been spent查找实际工作时间占初始预估时间百分比大于75%的问题:
    代码块
     workRatio > 75

function
function

functions
functions

...

函数参考

内容区目录
maxLevel4
minLevel4
locationtop
typelist

cascadeOption
cascadeOption

级联选择列表值 cascadeOption()

Search for issues that match the selected values of a 'cascading select' custom field.

The parentOption parameter matches against the first tier of options in the cascading select field. The childOption parameter matches against the second tier of options in the cascading select field, and is optional.

The keyword "none" can be used to search for issues where either or both of the options have no value.

语法
代码块
cascadeOption(parentOption)

or 或者

代码块
cascadeOption(parentOption,childOption)
支持的字段类型

级联选择列表 CASCADING_OPTION

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • Find issues where a custom field ("Location") has the value "USA" for the first tier and "New York" for the second tier:
    代码块
    location in cascadeOption("USA","New York")
  • Find issues where a custom field ("Location") has the value "USA" for the first tier and any value (or no value) for the second tier:
    代码块
    location in cascadeOption("USA")
  • Find issues where a custom field ("Location") has the value "USA" for the first tier and no value for the second tier:
    代码块
    location in cascadeOption("USA",none)
  • Find issues where a custom field ("Location") has no value for the first tier and no value for the second tier:
    代码块
    location in cascadeOption(none)
  • Find issues where a custom field ("Referrer") has the value "none" for the first tier and "none" for the second tier:
    代码块
    referrer in cascadeOption("\"none\"","\"none\"")
  • Find issues where a custom field ("Referrer") has the value "none" for the first tier and no value for the second tier:
    代码块
    referrer in cascadeOption("\"none\"",none)

componentsLeadByUser
componentsLeadByUser

模块负责人 componentsLeadByUser()

Find issues in components that are lead by a specific user.

You can optionally specify a user, or if the user is omitted the current user (i.e. you) will be used.

Note that if you are not logged in to JIRA, a user must be specified.

语法
代码块
componentsLeadByUser()

or

代码块
componentsLeadByUser(username)
支持的字段类型

模块 COMPONENT

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • Find open issues in components that are lead by you:
    代码块
    component in componentsLeadByUser() AND status = Open
  • Find open issues in components that are lead by Bill:
    代码块
    component in componentsLeadByUser(bill) AND status = Open

currentLogin
currentLogin

当前用户进程 currentLogin()

Perform searches based on the time at which the current user's session began. See also #lastLogin.

语法
代码块
currentLogin()
支持的字段类型

日期 DATE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Date Functions
quickstart:__JQL Operators supported by Date Functions
nopaneltrue
示例
  • Find issues that have been created during my current session:
    代码块
    created > currentLogin()

currentUser
currentUser

当前用户 currentUser()

Perform searches based on the currently logged-in user.

Note that this function can only be used by logged-in users. So if you are creating a saved filter that you expect to be used by anonymous users, do not use this function.

语法
代码块
currentUser()
支持的字段类型

用户 USER

支持的运算符
包含页面
quickstart:__JQL Operators supported by User Functions
quickstart:__JQL Operators supported by User Functions
nopaneltrue
示例
  • Find issues that are assigned to me:
    代码块
    assignee = currentUser()
  • Find issues that were reported to me but are not assigned to me:
    代码块
    reporter = currentUser() and assignee != currentUser()

issueHistory
issueHistory

issueHistory()

Find issues that you have recently viewed, i.e. issues that are in the 'Recent Issues' section of the 'Issues' drop-down menu.

Note:

  • issueHistory() returns up to 50 issues, whereas the 'Recent Issues' drop-down returns only 5.
  • if you are not logged in to JIRA, only issues from your current browser session will be included.
语法
代码块
issueHistory()
支持的字段类型

ISSUE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • Find issues which I have recently viewed, that are assigned to me:
    代码块
    issue in issueHistory() AND assignee = currentUser()

lastLogin
lastLogin

lastLogin()

Perform searches based on the time at which the current user's previous session began. See also #currentLogin.

语法
代码块
currentLogin()
支持的字段类型

DATE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Date Functions
quickstart:__JQL Operators supported by Date Functions
nopaneltrue
示例
  • Find issues that have been created during my last session:
    代码块
    created > lastLogin()

linkedIssues
linkedIssues

linkedIssues()

Perform searches based on issues which are linked to a specified issue.

You can optionally restrict the search to links of a particular type. Note that LinkType is case-sensitive.

语法
代码块
linkedIssues(issueKey)

or

代码块
linkedIssues(issueKey,linkType)
支持的字段类型

ISSUE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • Find issues that are linked to a particular issue:
    代码块
    issue in linkedIssues(ABC-123)
  • Find issues that are linked to a particular issue via a particular type of link:
    代码块
    issue in linkedIssues(ABC-123,"is duplicated by")

membersOf
membersOf

membersOf()

Perform searches based on the members of a particular group.

语法
代码块
membersOf(Group)
支持的字段类型

USER

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • Find issues where the Assignee is a member of the group "jira-developers":
    代码块
    assignee in membersOf("jira-developers")
  • Search through multiple groups and a specific user, e.g:
    代码块
    reporter in membersOf("jira-developers") or reporter in membersOf("jira-administrators") or reporter=jsmith
  • Search for a particular group, but exclude a particular member or members, e.g.:
    代码块
    assignee in membersOf(QA) and assignee not in ("John Smith","Jill Jones")
  • Exclude members of a particular group:
    代码块
    assignee not in membersOf(QA)

now
now

now()

Perform searches based on the current time.

语法
代码块
now()
支持的字段类型

DATE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Date Functions
quickstart:__JQL Operators supported by Date Functions
nopaneltrue
示例
  • Find issues that are overdue:
    代码块
    duedate < now() and status not in (closed, resolved) 

projectsLeadByUser
projectsLeadByUser

projectsLeadByUser()

Find issues in projects that are lead by a specific user.

You can optionally specify a user, or if the user is omitted the current user will be used.

Note that if you are not logged in to JIRA, a user must be specified.

语法
代码块
projectsLeadByUser()

or

代码块
projectsLeadByUser(username)
支持的字段类型

PROJECT

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • Find open issues in projects that are lead by you:
    代码块
    project in projectsLeadByUser() AND status = Open
  • Find open issues in projects that are lead by Bill:
    代码块
    project in projectsLeadByUser(bill) AND status = Open

projectsWhereUserHasPermission
projectsWhereUserHasPermission

projectsWhereUserHasPermission()

Find issues in projects where you have a specific permission.

Note that this function is only available if you are logged in to JIRA.

语法
代码块
projectsWhereUserHasPermission(permission)

For the permission parameter you can specify any of the following:

包含页面
quickstart:__project permissions
quickstart:__project permissions
nopaneltrue
支持的字段类型

PROJECT

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • Find open issues in projects where you have the "Resolve Issues" permission:
    代码块
    project in projectsWhereUserHasPermission("Resolve Issues") AND status = Open

projectsWhereUserHasRole
projectsWhereUserHasRole

projectsWhereUserHasRole()

Find issues in projects where you have a specific role.

Note that this function is only available if you are logged in to JIRA. 注意只有登录JIRA后才能使用这个函数。

语法
代码块
projectsWhereUserHasRole(rolename)
支持的字段类型

PROJECT

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • Find open issues in projects where you have the "Developers" role:
    代码块
    project in projectsWhereUserHasRole("Developers") AND status = Open

releasedVersions
releasedVersions

releasedVersions()

Perform searches based on the released versions (i.e. versions that your JIRA administrator has released) of a specified project.

You can also search on the released versions of all projects, by omitting the project parameter.

语法
代码块
releasedVersions()

or

代码块
releasedVersions(project)
支持的字段类型

VERSION

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • Find issues whose #FixVersion is a released version of the ABC project:
    代码块
    fixVersion in releasedVersions(ABC)
  • Find issues that relate to released versions of the ABC project:
    代码块
    affectedVersion in releasedVersions(ABC)
    or
    代码块
    fixVersion in releasedVersions(ABC)

standardIssuesTypes
standardIssuesTypes

standardIssueTypes()

Perform searches based on "standard" Issue Types, that is, search for issues which are not sub-tasks.

语法
代码块
standardIssueTypes()
支持的字段类型

ISSUE_TYPE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • Find issues that are not subtasks (i.e. issues whose Issue Type is a standard issue type, not a subtask issue type):
    代码块
    issuetype in standardIssueTypes()

subtaskIssuesTypes
subtaskIssuesTypes

subtaskIssueTypes()

Perform searches based on issues which are sub-tasks.

语法
代码块
subtaskIssueTypes()
支持的字段类型

ISSUE_TYPE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • Find issues that are subtasks (i.e. issues whose Issue Type is a subtask issue type):
    代码块
    issuetype in subtaskIssueTypes()

unreleasedVersions
unreleasedVersions

unreleasedVersions()

Perform searches based on the unreleased versions (i.e. versions that your JIRA administrator has not yet released) of a specified project.

You can also search on the unreleased versions of all projects, by omitting the project parameter.

语法
代码块
unreleasedVersions()

or

代码块
unreleasedVersions(project)
支持的字段类型

版本 VERSION

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • Find issues whose #FixVersion is an unreleased version of the ABC project:
    代码块
    fixVersion in unreleasedVersions(ABC)
  • Find issues that relate to unreleased versions of the ABC project:
    代码块
    affectedVersion in unreleasedVersions(ABC)
    or
    代码块
    fixVersion in unreleasedVersions(ABC)

votedIssues
votedIssues

votedIssues()

Perform searches based on issues for which you have voted. Also see the #Voter field.

Note that this function can only be used by logged-in users.

语法
代码块
votedIssues()
支持的字段类型

问题 ISSUE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • 查找你投票的问题:
    代码块
    issue in votedIssues()

watchedIssues
watchedIssues

watchedIssues()

Perform searches based on issues which you are watching. Also see the #Watcher field.

Note that this function can only be used by logged-in users.

语法
代码块
watchedIssues()
支持的字段类型

ISSUE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • Find issues that you are watching:
    代码块
    issue in watchedIssues()
支持的字段类型

问题 ISSUE

支持的运算符
包含页面
quickstart:__JQL Operators supported by Text Functions
quickstart:__JQL Operators supported by Text Functions
nopaneltrue
示例
  • 查找最近刚刚查看过的问题:
    代码块
    issue in issueHistory()

...