创建图表_如何在Confluence中创建Jira报表和图表

导读：

本文译自一家名为oldstreetsolutions的公司官网上的一篇文章，这是一家专门做Atlassian工具开发的公司，自定义Jira图表插件是他们主要产品之一。当然本文不只是介绍他们的插件，是关于在Confluence中使用Jira图表的一个从基础到复杂的应用介绍。

译者：Tingzi

文末点击”阅读原文“

在Confluence中自定义Jira图表、并共享或汇报给团队其他成员的方法包括： 1.在Confluence页面中创建Jira Issue和过滤宏。 2.利用Jira报表蓝图创建一个修改日志或状态报表。 3.利用Jira图表宏将数据显示为图表，包括饼图、创建vs已解决图表和二维图表。 4.利用Jira组件在页面上显示详细的Jira报表和图表。 5.利用Jira Charts for Confluence插件自定义图表并为其添加功能。 无论你是要与市场营销部门、高级管理层或者整个公司共享冲刺的进度，你都很可能希望使用Confluence共享它。如果Jira是软件团队的一个协同工具，Confluence则是一个为团队每个人共享Jira更新内容的最好的地方，而不用成员每天去登录Jira查看。 接下来是Atlassian的Jira和Confluence报表集成的不同选项、工具、技巧和最佳实践的一个方便指南。我们会先从最简单的集成和报表开始，再逐步介绍复杂的报表使用。Confluence Server版本和Cloud版本有很多明显的不同。在本文中，我们将使用Confluence Cloud版本来截图，并标注出Server版的不同。 开箱即用的Jira和Confluence的集成

• Server and Data Center：在使用这些宏之前，你需要通过 应用链接(Application Links)把Jira和 Confluence关联起来。
• Cloud：Jira和Confluence之间会自动配置应用链接，所以你不需要做任何操作。

在Confluence页面中添加Jira Issue和过滤器宏

在Confluence中可以显示一系列Issue或者单个Issue，这主要由你在宏中输入的JQL搜索条件、过滤器或者URL地址来决定的。你还可以直接在Confluence页面中，利用宏创建新的Jira Issue。这里你还可以在Confluence中选择和显示最近查阅过的Issue。最后，还有一个设置显示Issue数量的选项。

为了插入这个宏，或者其他的宏到Confluence中，有以下几个方法：

• 从快速链接区域选择一个宏

• 从查看所有菜单中查阅所有的宏。

小贴士：你可以利用键盘快捷键⌘+⇧+A(Mac上)或Alt+⇧+A(PC上)直接访问宏页面。 如果你已经知道要使用的宏的名字，最简单的方法是在页面中要使用的地方输入{，然后输入宏的名字。  ☁Cloud：在Cloud页面编辑器中可以使用斜线“/”打开快速搜索框。

从模板中创建Jira报表蓝图 如果你想让这个事情简单点，可以不使用JQL语句来创建一个修改日志或者状态报告。 从模板中创建Confluence页面，可以点击创建页面，搜索Jira，然后选择Jira报表。

在Confluence中创建一个Jira修改日志 创建一个标准的静态修改日志就再简单不过了，首先，选择报表类型修改日志。 

接着选择你想要的Jira项目，并且命名一个标题。

点击“创建”按钮，你会在修改日志中看到一个静态的Jira Issue列表。

如果你想创建一个动态的Jira修改日志，回到选择修改日志的设置界面，并且切换到高级模式。 然后输入JQL查询语句，或者粘贴Jira搜索的URL地址(更多关于JQL的相关内容，请参考Jira文档)。

同样，点击创建按钮，就在Confluence中创建一个动态的报表页面，汇总了你定义好的Jira查询语句返回的Jira Issue列表。无论相关的Issue什么时候更新，这个动态的Confluence宏都会自动更新。

想要获得更多详细的摘要，可查看有关Jira Issues宏的Atlassian文档页面。 在Confluence中创建一个Jira状态报表 像创建修改日志一样，点击创建页面，在搜索框中输入Jira，然后选择Jira报表，但是这次要选择状态报表。

Jira状态报表以饼图的形式显示你所选择的Jira项目进度和修复版本。你也可以使用责任人、项目、组件、报告人、解决方案、冲刺、优先级和Issue类型来绘制图表。状态报表使用的是Jira图表宏，它是基于你输入的信息来展示的，而且它是一个动态的图表。所以当Jira Issue被更新时，你的Confluence报表也会跟着更新。

为了创建你自己的图表，可以编辑一个Confluence页面，在页面中输入{Jira Charts。

这里为你提供了一系列类型的图表供选择：

• 饼图：前面我们已经讲过。
• 创建vs已解决：以线形图的形式比较创建和已解决Issue数量。
• 二维图表：显示一个统计分析的二维表格，展示的维度可以从状态、修复版本、经办人姓名、优先级、组件和 Issue类型等来选择。

在Confluence报表蓝图模板中自定义Jira图表，开箱即用。你能对蓝图模板自定义的功能仅限于：

• 在页面中移动图表，或者删除你不想要的图表。
• 设置每一个图表的宽度。
• 打开或关闭图表边框的显示。
• 选择是否显示图表信息。
• 修改一些标题的名字和修改说明性的文本。

这些“自定义”功能是有限制的，还有一些宏插件可以提供更多的自定义选项，下面介绍两个宏插件。 插件1：Custom Jira Charts for Confluence 此插件提供了以下自定义功能：

• 利用颜色选择器或者十六进制的颜色代码，可以为饼图扇区，漏斗图或者条形图选择颜色。
• 利用点击、拖拽可以重新对每个分区进行排序，从高到低，从低到高，或者任意自定义的顺序。
• 可以使用项目、组件、报告人、解决方案、冲刺、优先级或者Issue类型，甚至用户自定义字段等创建图表。
• 显示或者隐藏你不想看到的分区

一旦成功安装此插件，在宏选择器中输入{Custom或者搜索Charts都可以找到它。

 Confluence中的自定义Jira图表编辑器

要查看和开始使用此插件，可参考文档Custom Jira Charts for Confluence Playground here. 该插件可在Cloud，Server和Data Center版本中使用。

访问Atlassian市场(Custom Jira Charts for Confluence)可以查阅更多关于自定义Jira图表的内容。

插件2：Table Filter and Charts by Stiltsoft. 本例要在Confluence中创建一个用来显示特定时间内所完成任务的Jira图表。对于这个高级报表，你需要一个像Table Filter and Charts(开发者：Stiltsoft)这样的插件，该插件包含多个图表相关的宏，详细介绍请参考最新文档Table Filter and Charts for Confluence 。

首先，本例中要制作的图表需要把其中的Chart from Table和Pivot Table两个宏组合起来使用。 现在，你可以方便地查看这个项目某个时间内有哪些分配的任务已解决。 或者你可以找出某个指定项目在一段时间内最活跃的Issue报告者，并以柱形图的形式显示他们提交的Issue数量。 宏的这种组合移动允许为高级用户提供许多自定义的报表选项。 如果你知道自己在做什么，可以快速方便地使用正确的过滤器，并在页面查看模式下选择正确的数据集，而无需点编辑页面按钮。 因此，正如你所见，Confluence中有许多用于创建Jira Issue图表和报表的选项，具体取决于你的需求。 到目前为止，我们还有很多连接Jira和Confluence的优秀的路线图工具没有讲到。但是，这里有另外一篇博客可供参考，点击Custom Jira Charts for Confluence playground，去看一下你可以利用Jira图表报告中更多的自定义选项做些什么。

---