页面树结构

版本比较

标识

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

...

内容区目录
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.

按照 自定义字段(链接到Atlassian网站)中设置的 '级联选择列表'值来查找问题。

一级列表值 是必选参数。 二级列表值 是可选参数。

关键字 "none" 可以用来搜索级联列表值为空的问题。The keyword "none" can be used to search for issues where either or both of the options have no value.

语法
代码块
cascadeOption(parentOption)

或者

代码块
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. 如果你没有登录JIRA, 必须指定用户。

语法
代码块
componentsLeadByUser()

代码块
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.

查找指定项目负责人负责的问题。

你可以指定一个用户,或者不指定用户,JIRA会自动按照当前用户查找。

如果你没有登录JIRA, 你必须指定一个用户来执行这个函数。 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
  • 查找项目负责人是Bill,并且状态为Open的问题:
    代码块
    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.

注意只有登录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.

查找你 正在关注的问题。 请查看 关注人(Watcher)字段。

只有登录用户才能使用这个函数。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()

parentheses
parentheses

Setting Precedence of Operators

You can use parentheses in complex JQL statements to enforce the precedence of #operators.

控制运算顺序

你可以在复杂的JQL语句中使用括号来控制 运算符的运算顺序。

例如, 如果你想查找SysAdmin项目中所有问题解决的问题,或者分配给系统管理员(bobsmith)的问题, 你可以使用括号来控制运算顺序, 例如For example, if you want to find all resolved issues in the SysAdmin project as well as all issues (any status, any project) currently assigned to the system administrator (bobsmith), you can use parentheses to enforce the precedence of the boolean operators in your query, i.e.:

代码块
(status=resolved AND project=SysAdmin) OR assignee=bobsmith

Note that if you do not use parentheses, the statement will be evaluated left-to-right.

如果你不使用括号, 表达式运算顺序将从左到右逐一运算。

你也可以使用括号将表达式分组, 方便地在表达式前使用否定(NOT)运算符,否定整个表达式的结果。 You can also use parentheses to group clauses, so that you can apply the #NOT operator to the group.

text
text

Performing Text Searches

You can use Lucene's text-searching features when performing searches on the following fields, using the #CONTAINS operator:

执行文本搜索

当搜索下面的文本字段时,你可以在查询表达式中使用包括这样的 Lucene 文本搜索特性运算符:

更多详细说明, 请查看 执行文本搜索页面, 该页面包括以下章节For details, please see the page on Performing Text Searches, which includes the following sections:

包含摘录
quickstart:Performing Text Searches
quickstart:Performing Text Searches
nopaneltrue

auto-complete
auto-complete

Using Auto-complete

使用自动完成

当你输入以下条件的查询语句时, JIRA 会自动根据上下文提供一些建议As you type your query, JIRA will recognise the context and offer a list of "auto-complete" suggestions as follows:

内容区目录
locationtop
typelist

建议列表按照字母顺序提供最多15个可选项。JIRA不会提供函数参数的自动完成建议列表。

信息
titlePlease note:

不是所有字段都提供自动完成建议列表。 点击 字段 参考查看哪些字段支持自动完成。

如果你在查询语句的起始输入了空格

The list of auto-complete suggestions is displayed alphabetically and includes the first 15 matches. Note that auto-complete suggestions are not offered for #function parameters.

信息
titlePlease note:
  • If no auto-complete suggestions are offered, your administrator may have disabled the "JQL Auto-complete" feature for your JIRA instance.
  • If you prefer not to be offered auto-complete suggestions, click the "Turn off auto-complete" link below the "#Query" box.

Auto-complete suggestions are not offered for all fields. Check the #fields reference to see which fields support auto-complete.

If you type a space at the start of your query
...

...JIRA will offer a list of all available fields, e.g.会自动提供所有可用字段的列表, 例如:

If you type one or more characters
如果你输入了超过1个字符...

...JIRA will offer a list of matching fields, e.g.会列出可能匹配的字段列表, 例如:

If you type a field then a space
如果你输入了一个字段并输入了空格...

...JIRA will offer a list of valid #operators, e.g.会列出可用的 运算符列表, 例如:

If you type a field, then an operator, then a space...
如果你输入了一个字段, 接着输入了一个运算符, 然后又输入了一个空格...

...JIRA 会提供有效的字段值列表, 例如...JIRA will offer a list of valid values, e.g.:

If you type a field, then an operator, then one or more characters
如果你输入了一个字段, 接着输入了一个运算符, 然后又输入了1个字符...

...JIRA will offer a list of valid values (if your #field supports this) and 会提供可用字段值的列表 (如果你输入的 字段 值支持列表) 以及可用的and valid functions for the field/operator combination, e.g.:


...

然而, 使用'高级搜索' 创建的查询条件不一定能够翻译成 '简单搜索'的查询条件, 特别是:

  • 查询语句中包括 或者(OR) 运算符 (使用在但是在...之内(IN)运算符也可以被翻译成简单模式查询条件运算符可以被翻译成简单模式查询条件, 如 project in (A, B))
    • i.e. even though this query虽然这个查询语句: (project = JRA OR project = CONF) is equivalent to this query 与这个查询语句:(project in (JRA, CONF)), only the second query will be translated.
  • the query contains a NOT operator
  • the query contains an EMPTY operator
    • 一样, 但是只有第二个查询语句才能被翻译成简单搜索语句。
  • 查询语句中包含 NOT 运算符
  • 查询语句中包含 EMPTY 运算符
  • 查询语句中包括比较运算符the query contains any of the comparison operators: !=, IS, IS NOT, >, >=, <, <==
  • 查询语句中指定了与项目有密切关系的字段和字段值 (例如 版本, 模块, 自定义字段),但是又没有在查询条件中明确地指定项目 (例如,只输入了the query specifies a field and value that is related to a project (e.g. version, component, custom fields) and the project is not explicitly included in the query (e.g.
    fixVersion = "4.0", without the 而没有输入 AND project=JRA). This is especially tricky with custom fields since they can be configured on a Project/Issue Type basis. The general rule of thumb is
    that if the query cannot be created in the 'Simple Search' form, then if it is created using 'Advanced Search' it will not be able to be translated to 'Simple Search'. , 尤其是设置了项目/问题类型的自定义字段。
    查询语句翻译的标准规则是:
    如果查询语句无法在 '简单搜索' 模式中设置, 而需要在 '高级搜索' 模式中输入的查询语句,是无法翻译为'简单搜索' 查询条件的。

characters
characters

保留的字符

...