测试工程师-测试管理与工具-JIRA_JIRA高级查询语言(JQL).docx

PAGE1

PAGE1

JIRA高级查询语言(JQL)入门

1JQL的基本语法

JIRA高级查询语言（JQL），作为JIRA平台的强大工具，允许用户以更精细、更灵活的方式查询和过滤JIRA中的问题。不同于基本的查询界面，JQL提供了更多的可能性，包括使用逻辑运算符、日期运算符以及字段选择，使用户能够构建复杂的查询语句，以满足特定的项目管理和报告需求。

1.1字段选择

JQL中的查询主要基于问题的字段。字段可以是任何存储在问题中的数据，包括但不限于key（问题键），summary（问题摘要），assignee（指派人），status（状态），created（创建日期），updated（更新日期），resolved（解决日期），project（项目），type（问题类型），priority（优先级）等。

1.1.1示例代码

假设我们有一个项目ABC，并且我们对所有指派给JohnDoe的Bug问题感兴趣。我们可以用以下的JQL查询：

project=ABCANDtype=BugANDassignee=JohnDoe

此处，project=ABC表示我们限制查询范围在ABC项目内，type=Bug表示我们只关注Bug类型的问题，assignee=JohnDoe则表示我们查找所有指派给JohnDoe的问题。

1.2逻辑运算符

逻辑运算符用于连接不同的查询条件，使查询更加复杂和精确。JQL支持以下几种逻辑运算符：

AND：所有连接的条件必须同时满足。

OR：满足任意一个条件即可。

NOT：否定接下来的条件。

1.2.1示例代码

若我们想要找到所有在ABC项目下，状态为Open或InProgress，并且优先级为High的问题，我们可以使用以下的JQL查询：

project=ABCANDstatus=OpenORstatus=InProgressANDpriority=High

为了使查询语句更简洁，我们可以使用括号()来分组条件：

project=ABCAND(status=OpenORstatus=InProgress)ANDpriority=High

1.3日期运算符

日期运算符允许我们基于具体的时间点或时间范围来过滤问题。JQL支持以下日期运算符：

=,!=,,,=,=：用于比较具体的日期。

after：查找在指定日期之后创建或更新的问题。

before：查找在指定日期之前创建或更新的问题。

changed：查找某个日期字段发生过变化的问题。

today,yesterday,today-7d,tomorrow:这些关键词用于基于相对时间进行查询。

1.3.1示例代码

如果我们要查询所有在一周前created的问题，我们可以使用以下的JQL：

created=today-7d

这表示我们只查找那些在当前日期向前7天内创建的问题。

1.4数字运算符

对于JQL中的数字字段，如votes，timeestimate等，我们同样可以使用数字运算符来进行过滤。JQL支持以下几种数字运算符：

=,!=,,,=,=：用于比较具体的数值。

in,notin：用于检查数值是否在指定的集合中。

between,notbetween：用于检查数值是否在一个指定的范围内。

1.4.1示例代码

假设我们需要查找所有在ABC项目中，估计时间超过10小时的问题，我们可以使用以下的JQL：

project=ABCANDtimeestimate10h

1.5通配符

JQL还支持使用通配符进行查询，这对于寻找包含特定字符的字段值特别有用。*和~是最常用的通配符。

*：匹配任意字符序列，包括空字符。

~：用于模糊匹配，寻找字段值中包含特定字符串的问题。

1.5.1示例代码

如果我们想查询所有摘要中包含database的ABC项目下的问题，我们可以使用以下的JQL：

project=ABCANDsummary~database

这将返回所有摘要字段中包含database字符串的问题。

2使用JQL进行基础查询

掌握JQL的基本语法后，我们就可以开始进行一些基础的JQL查询了。以下是一些常见的JQL查询示例，它们涵盖了项目管理的多个方面：

2.1查询指派给特定用户的未解决的Bug

type=BugANDassignee=JohnDoeANDstatusnotin(Resolved,Closed)

在这个例子中，statusnotin(Resolved,Closed)确保我们只查找那些状态既不是Resolved也不是Closed的问题，