JQL语法及Python查询 Jira issue信息

一、JQL语法

1.1 JQL语法简介

JIRA 的 JQL 语法由以下几个元素组成：

• field (字段) ： 就是要搜索的JIRA Issue 的各个字段
• operator(运算符或者也叫操作符)：如 =, < , > , in 等
• value(值)：具体要查询的字段匹配的值
• keyword(关键字)： keyword这个字面上理解可能会带来些歧义， 主要有以下作用
  （1）连接两个表达式，即通常我们所说的逻辑运算符：AND， OR， NOT
  （2）排序运算符：ORDERBY
  （3）还有一部分就是表示空的关键字： NULL 和 EMPTY，这两个貌似才是通常意义上的关键字
• function(方法)：即JIRA提供的一些方法，如 now()表示当前时间，currentUser()表示当前用户等

语法示例如下：

其中field可用接口中获取：

1.2 Jira中常用的JQL搜索语句

二、查询issue信息

2.1 安装JIRA依赖库

pip3 install jira
1

2.2 登录JIRA

JIRA都有访问限制，在访问Jira项目时首先要进行认证，Jira Python库提供了3种认证方式：

• 通过Cookis方式认证（用户名，密码）
• 通过Basic Auth方式认证（用户名，密码）
• 通过OAuth方式认证

from jira import JIRA
# 通过jira域名和账户密码登录
jira = JIRA('https://jira.xxx.xxx/', basic_auth=('username', 'password'))
1
2
3

创建JIRA对象需要server处传入公司JIRA服务器的IP，basic_auth里传入登入用户名和密码

2.3 查询JIRA的project信息

from jira import JIRA

jira = JIRA('https://jira.xxx.xxx', basic_auth=('username', 'password'))
# 查询project信息
print(jira.projects())  #获取所有的projets

project = jira.project('KKQA') #获取projet为KKQA的信息
print(project.key)             # 获取项目key
print(project.name)            # 获取项目名称
print(project.lead)            # 获取项目负责人
print(project.description)     # 项目描述
print(project.components)      # 获取项目组件
print(project.raw)             # 获取项目的原始API数据
1
2
3
4
5
6
7
8
9
10
11
12
13

2.4 查询JIRA的issue信息

可以查询到信息有：

• 所属项目
• 问题类型和状态
• 标题和描述
• 干系人
• 时间点
• 附件和评论等

from jira import JIRA

jira = JIRA('https://jira.xxx.xxx', basic_auth=('username', 'password'))
issue = jira.issue('KKQA-57857')
print(issue)                # jiraID
print(issue.id)             # internalID
print(issue.fields.project) # 所属项目
print('-----------------------------------')

print(issue.fields.issuetype)    # 问题类型
print(issue.fields.status)       # 问题状态
print(issue.fields.timetracking) # 时间跟踪
print(issue.fields.issuelinks)   # 链接的问题
print('-----------------------------------')

print(issue.fields.creator)           # 创建人
print(issue.fields.reporter)          # 报告人
print(issue.fields.assignee)          # 经办人
print(issue.fields.customfield_10202) # 缺陷类型（自定义字段）
print(issue.fields.labels)            # 标签
print(issue.fields.created)           # 创建时间
print(issue.fields.updated)           # 修改时间
print(issue.fields.lastViewed)        # 最后查看时间
print(issue.fields.summary)           # 主题
print(issue.fields.description)       # 描述
print(issue.fields.attachment)        # 附件
print(issue.fields.comment.comments)  # 备注
print('-----------------------------------')

print(issue.fields.issuetype.avatarId) # 类型ID
print(issue.fields.components)         # 模块
print(issue.fields.priority)           # 优先级
print(issue.fields.versions)           # 影响版本
print(issue.fields.fixVersions)        # 解决版本
print(issue.fields.resolution)         # 解决结果
print(issue.fields.resolutiondate)     # 解决时间
print(issue.fields.environment)        # 环境
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

2.5 搜索Jira issue

Jira有一套专门的搜索语言，称为JQL(Jira Query Language)，Jira的Python库便是基于JQL语法进行搜索的，返回的是搜索到的问题列表。使用语句为：

jira.search_issues('JQL语句')
1

默认最大结果数为1000，可以通过maxResults参数配置，参数为-1时不限制数量，返回所有搜索结果。

from jira import JIRA

jira = JIRA('https://jira.xxx.xxx', basic_auth=('username', 'password'))
jql = 'status in (等待修复, 修复中, 自测中) AND affectedVersion = A7.60.0'
issues = jira.search_issues(jql, 0, 9999, 1, '', '', '')
print(issues)
for issue in issues:
    print(f'经办人: {issue.fields.assignee}, {issue.fields.summary}')
1
2
3
4
5
6
7
8

参考文档：
https://doc.devpod.cn/jira/jql-3244098.html
https://blog.csdn.net/alice_tl/article/details/101784046