精通JQL查询jira-ruby让你轻松筛选和导出JIRA问题数据【免费下载链接】jira-rubyA Ruby gem for the JIRA REST API项目地址: https://gitcode.com/gh_mirrors/ji/jira-rubyjira-ruby 是一个面向 JIRA REST API 的 Ruby 库gem。借助它对 JQLJIRA Query Language的原生支持你可以在 Ruby 脚本里直接执行JQL 查询按任意条件筛选Issue、Project 等数据并把结果一键导出为 CSV 或 JSON轻松完成 JIRA 数据批量处理 为什么用 jira-ruby 做 JQL 查询JQL 是 JIRA 内置的查询语言语法类似 SQL。日常在页面上筛选问题很方便但一旦涉及批量导出、定时报表、数据迁移界面操作就显得力不从心页面导出上限低几千条问题就捉襟见肘无法自动化每天重复手点筛选条件很枯燥导出的字段不可定制拿不到自定义字段jira-ruby 将 JIRA REST API 的 JQL 搜索接口封装成了几行 Ruby 代码核心实现在 lib/jira/resource/issue.rb 的self.jql方法中让你用写脚本的方式完成原本要手点几十下的操作 ⚡快速安装一分钟接入 JIRA安装非常简单一条命令即可gem install jira-ruby然后用你的账号和 API Token 初始化客户端配置项定义在 lib/jira/client.rbrequire jira-ruby options { :username myuser, :password my_api_token, :site https://yourcompany.atlassian.net/, :context_path , :auth_type :basic } client JIRA::Client.new(options) 提示Jira Cloud 已不再支持直接用密码登录请在 JIRA 个人设置中生成 API Token 填入:password。用一行 JQL 筛选问题数据连接成功后调用Issue.jql就能执行任意 JQL 查询# 查询 SAMPLEPROJECT 项目下所有未解决的 Bug bugs client.Issue.jql(project SAMPLEPROJECT AND issuetype Bug AND resolution is EMPTY) bugs.each do |issue| puts #{issue.key} - #{issue.summary} - #{issue.status.name} end返回的是一个 Issue 对象数组每个对象都能直接按属性取值key、summary、created等完全不用手动解析 JSON。只取需要的字段让查询更轻量如果数据量大可以指定只返回部分字段既省流量又提速issues client.Issue.jql( created -30d, fields: [:summary, :status, :created, :assignee] )遇到自定义字段如customfield_10021时先执行一次字段映射之后就能用字段名代替 IDclient.Field.map_fields client.Issue.jql(project SAMPLEPROJECT, fields: [:summary, :release_date])字段映射逻辑在 lib/jira/resource/field.rb它会自动处理重名字段的冲突。把 JQL 查询结果导出成 CSV 或 JSON拿到数组后导出 CSV 只需十来行代码require csv issues client.Issue.jql(project SAMPLEPROJECT AND sprint is not EMPTY, fields: [:summary, :status, :assignee, :created]) CSV.open(jira_issues.csv, w) do |csv| csv %w[Key Summary Status Assignee Created] issues.each do |i| csv [i.key, i.summary, i.status.name, i.assignee.displayName, i.created] end endJSON 导出同理issues.map { |i| i.attrs }.to_json即可。配合系统定时任务你就拥有了一个自动运行的 JIRA 数据导出管道 大数据量场景分页查询与计数Issue.jql内部已做了自动翻页通过nextPageToken一次性把全量结果取回内存。如果你的数据集特别大可以改用分页版本jql_paged逐页处理、降低内存压力result client.Issue.jql_paged(client, project BIGPROJECT, max_results: 100) puts 本页 #{result[:issues].size} 条共 #{result[:total]} 条另外把max_results设为0时方法只返回总条数而不返回数据非常适合做统计total client.Issue.jql(status Done AND created -90d, max_results: 0) puts 本季度完成 #{total} 个问题直接复用 JIRA 中已保存的过滤器团队在 JIRA 页面上保存的 Filter过滤器同样可以拿来用——每个 Filter 本身就带一条 JQL取回后调用issues方法即可执行filter client.Filter.find(123) issues filter.issues # 内部自动用该过滤器的 JQL 执行查询实现见 lib/jira/resource/filter.rb这让页面筛选 脚本导出无缝衔接。常用 JQL 条件速查表需求JQL 写法指定项目的所有 Bugproject SAMPLEPROJECT AND issuetype Bug某人负责且未完成assignee 张三 AND resolution is EMPTY近 7 天新建的问题created -7d带特定标签的问题labels urgent优先级为最高priority Highest标题包含关键词summary ~ 登录某版本中修复的问题fixversion 1.2.0把这些条件直接传给Issue.jql即可实现各种灵活的筛选与导出。常见问题排查查询返回空结果先用 JIRA 页面的高级搜索验证同一条 JQL确认语法和项目 Key 无误自定义字段取不到确认已执行client.Field.map_fields且fields中写的是字段名而非customfield_xxx查询很慢通过fields只取必需字段或用max_results限制条数认证失败检查:site地址、:context_pathatlassian.net 上一般为空字符串以及 API Token 是否过期。小结jira-ruby 把 JQL 查询、字段映射、分页与过滤器复用都封装成了简洁的 Ruby API。无论是每周自动导出项目进度表还是批量清洗 JIRA 数据几行代码就能搞定——JIRA 数据筛选与导出的自动化从引入这个 gem 开始就非常简单 ✅【免费下载链接】jira-rubyA Ruby gem for the JIRA REST API项目地址: https://gitcode.com/gh_mirrors/ji/jira-ruby创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考