如何获取JIRA（含Structure Plugin）历史数据并对接Power BI分析？

一、用经典JIRA API搞定核心需求 #

你要的问题持久化历史数据和变更分析，经典JIRA API完全能覆盖：

• 批量拉取多项目问题：调用GET /rest/api/3/search，指定jql=project in (PROJ1, PROJ2)筛选目标项目，加上expand=changelog参数，就能拿到每个问题的完整变更历史（状态、字段、经办人等所有变更记录）。
• 增量同步实现持久化：每次拉取时用jql=updated >= "上次同步时间"过滤，只拉取更新过的问题，避免重复拉全量数据，慢慢攒出完整的历史数据集。
• Power BI里解析变更记录：把返回的JSON数据导入后，展开issues数组，再展开changelog.histories，把每条变更拆成单独行，就能提取变更时间、操作人、变更字段、前后值这些分析需要的字段。

二、Structure Plugin API的正确打开方式（如果需要结构层级） #

如果你的分析要用到Structure插件里的自定义层级（比如Epic/Story的嵌套、分组结构），可以这么用Structure API：

• 先调用GET /rest/structure/1.0/structure拿到所有结构的ID，找到你要分析的那个结构ID。
• 再调用GET /rest/structure/1.0/structure/{structureId}/items，获取该结构下的问题列表和层级关系（通过parentId字段识别父问题）。
• 要注意：调用Structure API需要你有Structure Viewer及以上权限，而且返回的结构数据可以通过issueId和经典API的问题数据关联起来，一起导入Power BI做联合分析。

三、Power BI连接与数据处理步骤 #

1. 打开Power BI，选「获取数据」→「Web」，输入API请求URL（比如经典API的搜索接口）。
2. 配置请求头：加Authorization字段，值是Basic {base64编码的用户名:API令牌}——JIRA云用API令牌，服务器版直接用密码，先把用户名和密码/令牌用base64编码好。
3. 解析JSON：把返回的issues数组展开，再展开changelog.histories数组，把每条变更记录拆成单独行，提取你需要的字段：created（变更时间）、author.displayName（操作人）、items.field（变更字段）、items.fromString/items.toString（变更前后值）。
4. 持久化存储：设置增量刷新规则，基于updated字段定期同步新的变更记录，不用每次都拉全量数据，既省时间又避免重复。

四、常见问题排查 #

• Structure API调用失败：先检查自己的权限够不够，再确认API版本（不同Structure版本的API路径可能有差异，比如v1和v2），可以先用Postman测试请求能不能正常返回数据。
• 历史数据不全：确保经典API请求里加了expand=changelog参数，另外问问JIRA管理员，系统有没有清理旧的变更记录，有些实例会自动删除太久之前的变更日志。
• 请求超时：批量拉取时用maxResults参数分页，比如每次拉1000条，别一次拉太多数据导致超时。

内容的提问来源于stack exchange，提问作者RaphaelSchnizler