Confluence Jira图表宏

将Jira Charts宏添加到页面，以根据Jira中的信息构建可视化图形和图表。

这非常适用于：

• 团队会议和回顾
• 项目状态报告
• 与组织中不经常使用Jira的人员共享信息

该宏可以显示来自任何已连接的Jira系统数据，包括Jira Software和Jira Service Management。

截图：带有Jira Chart宏的会议纪要页面，按优先级显示一个软件版本中所有Issue的数据。

连接Confluence和Jira

在您可以使用此宏之前，您的Confluence和Jira系统必须通过Application Links来连接。查看页面的人将看到有权限访问的Issue相关的图表。如果您的Jira系统需要验证查看Issue的权限，那么他们需要在查看图表之前进行身份验证。此宏与Jira 5.x及更高版本兼容。

更多信息，请参阅Use Jira applications and Confluence together。

在页面中添加宏

在页面中添加Jira Chart宏：

1. 从编辑器工具栏中，选择插入(Insert) > 其它宏（Other Macros）。
2. 从Development类别中选择Jira Chart。

3. 选择您要创建的报告类型（例如 Pie、Created vs Resolved）

4. 选择您的Jira server。如果您有多个Jira系统链接到Confluence，下拉菜单将默认显示为主链接。

5. 搜索问题 - 您可以用JQL进行查询或将Jira URL直接粘贴到搜索框中。

6. 点击Preview以生成图表。

7. 选择“Display Options”以进一步控制图表的显示方式。

8. 点击Insert。

然后，您可以发布您的页面以查看宏的效果。

要了解有关搜索Issue的更多信息，请参阅Displaying issues using JIRA Query Language (JQL)。

截图：在宏浏览器中配置Jira图表宏。

饼图

饼图可用于报告Issue状态、优先级、经办人等。

进一步控制此图表在您的页面上的显示方式。设置Display options：

宽度 - 定义图表区域的总宽度。 您可以以像素、百分比或留空为单位输入值以自动适应。
显示边框 - 在图表区域周围添加边框。
显示图表信息 - 在图表下方包含一个文本摘要，其中包含总问题计数和值图表。

• Chart by - 选择您想要对饼图进行分组的维度，例如：
  • 状态
  • 修复版本
  • 经办人
  • 优先级
  • 模块
  • Issue类型
• Width - 定义图表区域的总宽度。您可以以像素、百分比为单位输入值，或用空白表示自动适应。
• Show border - 在图表区域周围添加边框。
• Show chart information - 在图表下方包含一个文本概要，其中包含Issue总数和明细。

创建和解决对比图

Created vs Resolved图表可用于显示随着时间的推移创建的问题数量与解决的问题数量之间的差异。

要进一步控制此图表在页面上的显示方式，请设置Display options：

• Period - 选择要报告的时间范围（周、月、季度等）。
• Days previously - 要报告的总天数（从今天开始计算）。
• Cumulative totals - 选择累积显示数值或报告每个时期的值。
• Show unresolved trend - 添加一个子图，显示一段时间内未解决的Issue。
• Show versions - 在图表上以垂直线表示版本发布日期。
• Width - 定义图表区域的总宽度。以像素、百分比为单位输入值，或留空表示自动适应。
• Show border - 在图表区域周围添加边框
• Show chart information - 在图表下方包含一个文本摘要，其中包含Issue总数和明细。

二维表

二维图表可用于在矩阵中显示Issue统计信息。您可以在X轴和Y轴配置这些Issue字段：

• 状态
• 优先级
• 经办人
• 修复版本
• 模块
• Issue类型

例如，您可以使用图表按状态显示不同优先级的Issue数量（如下所示）。

要配置图表轴，请设置Display options：

• X Axis - 要在X轴（列）上显示的Issue字段。
• Y Axis - 要在Y轴（行）上显示的Issue字段。
• Rows to display - 要在图表中显示的最大行数。

禁用Jira Chart宏

该功能由名为“Jira Macros”的系统插件提供。这也用于Jira Issue宏。要使宏在您的网站上不可用，您可以禁用该插件。请参阅Disabling and enabling apps。

注意

HTTPS：如果Confluence服务器配置为接受Jira SSL证书，则Jira Chart宏可以访问在SSL下运行的Jira站点。请参阅Connecting to LDAP or Jira applications or Other Services via SSL。

身份验证：如果查询Issue时需要身份验证，系统将提示用户进行身份验证以查看Confluence页面上的图表。

为了在宏浏览器中搜索问题，您需要进行身份验证。 

其它添加方式

用键盘输入添加宏

通过wiki标记添加宏

您不能使用wiki标记来添加此宏。