JQL 速查表
将这份 Jira JQL 速查表用作您的综合指南,它可帮助您掌握在 Atlassian 的项目管理工具中进行高级搜索和筛选所用的 Jira 查询语言。
Jira 查询语言 (JQL) 简介
JQL 查询的基本结构
常见的 JQL 运算符
了解 JQL 运算符对于创建有效的查询至关重要。它们构成了 JQL 的支柱,使用户能够进行精确的搜索,这样可从大量的数据中筛选,准确地找到他们需要的内容。JQL 中的常见运算符包括:
=
:精确匹配。示例:Project = “Marketing Campaign”
。此查询将返回属于“营销活动”项目的所有事务。!=
:不等于。示例:assignee != currentUser( )
。此查询将查找未分配给当前用户的所有事务,这有助于确定可能需要其他人注意的任务。AND
:将多个条件组合在一起(所有条件都必须为“true”)。示例:priority = High AND status = Open
。此查询将只返回待处理状态下的高优先级事务,这有助于确定需要立即注意的关键任务。OR
:将多个条件组合在一起(至少有一个条件必须为“true”)。示例:component = “User Interface” OR component = “API”
。此查询将查找与用户界面或 API 组件相关的事务,这样可让您查看不同系统部件的相关工作。IN
:匹配指定列表中的任何值。示例:status IN (“In Progress”, “Under Review”, “Testing”)
。此查询将返回这三种状态中的任何一种状态下的所有事务,这提供了一种查看所有活动工作项的快速方法。
关键 JQL 函数及其使用方法
JQL 函数可让用户执行更复杂的运算、对结果进行排序,并根据动态条件进行筛选,从而增强了查询功能。这些函数包括:
-
ORDER BY
:对结果进行排序。示例:project = "Marketing" ORDER BY created DESC
。此查询将返回营销项目中的所有事务,按创建日期从最新到最旧的顺序排序,这使您可以快速确定最近的任务。 WAS
:查找曾经处于特定状态的事务。示例:status WAS "Resolved" AND status = "Open"
。此查询将查找曾经已解决但后来又重新打开的所有事务,这有助于跟踪反复出现的问题。CHANGED
:确定在某一时间范围内发生了修改的事务。示例:status CHANGED AFTER -1w
。此查询将返回状态在上周发生了变化的所有事务,这对于查看项目的最近进展或变化很有用。MEMBERSOF
:按群组成员身份进行筛选。示例:assignee IN MEMBERSOF("developers")
。此查询将查找分配给“开发人员”群组中任何人的所有事务,这使您可以查看整个团队的工作量。
常见 Jira 用例的 JQL 示例
下面是在 Jira 中使用 JQL 的几种方法。
- 查找分配给您的所有高优先级事务:
priority = High AND assignee = currentUser()
- 列出特定项目中的过期事务:
project = "Customer Support" AND duedate < now() AND status != Closed
- 显示最近创建的事务:
created >= -7d ORDER BY created DES
高级 JQL 技巧
将高级搜索与 JQL 配合使用,以利用自定义字段和复杂的查询。
- 使用自定义字段:
"Custom Field Name" ~ "search term"
。使用 JQL 在自定义字段中搜索,这样可根据您企业的独特数据结构进行定制程度更高且更具体的查询。 - 子查询:
project IN subTaskIssueTypes() AND assignee = currentUser()
。使用 JQL 创建嵌套查询,这样可让您根据另一个查询的结果来筛选事务,这对于项目中复杂的层次关系特别有用。 - 特定事务类型:
issuetype = Epic AND status != Done
。使用 JQL 针对特定的事务类型及其状态进行查询,这样可帮助您跟踪和管理项目中的特定工作类别。
成为 JQL 专家
有了这份 Atlassian JQL 速查表,您将能够轻松驾驭高级搜索与 JQL,并增强您的项目管理技能。
掌握 JQL 可让您获得关键项目洞察信息,并回答与您团队相关的关键问题。Jira 中的三种搜索方式(快速、基本和高级)可帮助您查找有关项目的关键信息。此外,查询结果可以保存并用作 Jira(包括面板)中的筛选器和视图。
准备好详细了解 JQL 在 Jira 中的灵活性了吗?