JIRA 是 Atlassian 提供的缺陷跟踪和项目管理系统。通过将 JIRA 图表（Chart）宏添加到 Confluence 页面中，你就可以在 Confluence 页面中显示有关 JIRA 的项目饼图。
在你使用这个宏之前，你需要将 JIRA 站点通过 应用链接（Application Links）链接到 Confluence 站点中。用户在查看站点的时候就可以看到 JIRA 站点中的问题饼图了。
如果 JIRA 站点被限制查看的话（用户需要具有查看问题权限），用户需要先进行授权。这个宏能够与 JIRA 5.x 及其更新版本都能被兼容。
向页面中添加 JIRA 图表（Chart）宏
如何向页面中添加 JIRA 图表宏 的快速指南：
- 打开你希望编辑 Confluence 页面，然后单击 编辑（Edit）按钮。页面的编辑模式将会被打开。
- 下一步，在编辑工具栏中单击宏浏览器图标
。这时候宏浏览器将会在屏幕的中间打开。 - 在宏浏览器中，在窗口的右上角的对话框中输入你希望插入的宏的名称。当找到与你输入的宏名称接近的宏后将会在中间的面板上显示。单击需要的宏然后来查看可用进行配置的宏选项，在这里你可以对需要插入的宏设置相关参数，然后单击 插入（insert）来将需要的宏插入到页面中。
使用 JIRA 图表宏
向页面中添加 JIRA 图表宏：
- 插入 JIRA 图表宏（查看上面）。
选择你的 JIRA 服务器。
如果你有多个 JIRA 实例链接到 Confluence 的话，默认选的是是主程序链接。
- 查找问题 - 你可以在查询中输入 JQL 或者将 JIRA URL 直接粘贴到查找对话框中。
- 选择 预览（Preview ）来差饼图。
- 选择 插入（Insert）。
有关 JIRA 问题进行查找的相关内容，请参考页面： 通过 JIRA Query Language (JQL) 查找显示问题。
你可以控制如何在页面中显示 JIRA 图标宏。选择 显示选项（Display options）：
- 由谁创建（Chart by） - 选择您要通过分段饼图的JIRA 字段。
- 宽度（Width） - 定义图表显示宏的总宽度。你可以使用像素或者百分比。如果留空的话将会自动适应宽度。
- 显示边框（Show border） - 为图表区域显示边框。
- 显示图标信息（Show chart information） - 在图表的下面显示文本的介绍，比如总计有多少问题和显示图表的查询方式。
宏浏览器：在宏浏览器中显示的 JIRA 图表宏
禁用 JIRA 图表宏
这个参数由插件 'JIRA Macros' 控制显示。这个宏也可以在 JIRA 问题宏中使用。
希望将 JIRA 图表宏禁用，你需要将这个插件禁用。
备注
HTTPS: JIRA 图表宏可以访问使用了 SSL 安全套接字的 JIRA 站点。Confluence 服务器被配置可以接受 JIRA SSL 套接字证书。
授权（Authentication）：如果查询问题的查询语句要求授权（匿名用户不能在 JIRA 中查看信息），用户在进行查看页面的时候将会得到需要输入用户名和密码的对话框。
希望在宏中查找问题，你需要首先进行授权。在 JIRA 5.x 中你可以不经过授权来搜索匿名的问题。但是，在 JIRA 6.x 中不管是不是匿名问题都需要经过授权后才能查看。
代码示例
下面的代码是提供给希望进一步编辑 Confluence 页面的高级用户使用的。
宏名称： jirachart
宏内容： None
下面的参数在存储格式下可用。
参数名称 | 是否必须 | 默认值 | 参数描述和可接受的值 |
|---|---|---|---|
参数名称 | 是否必须 | 默认值 | 参数描述和可接受的值 |
| Yes | Pie | 图表的显示类型。在当前情况下只有饼图可用，其他的类型可能在后期加到系统中。 |
statType | Yes | Statuses | JIRA 图表拼图显示需要的字段：
|
showinfor | No | False | 在图表下面显示有关图表的文本信息，比如总计有多少问题和显示图表的查询方式。 |
jql | Yes | JIRA 图表宏中显示问题的 JQL 查询。 | |
width | 600 | (blank) | 图表宏区域中显示的总宽度。宽度可用使用像素也可以使用百分比，或者可以留空来自适应可用的空间。 |
border | No | False | 在图表区域中显示边框。 |
存储格式示例
使用 问题类型的 图表 - 注意 Confluence 基于应用链接的设置将会插入 server 和 serverId 参数：
|