小工具

小工具 就像 Jira 仪表板上的小型应用程序。它们类似于现在大多数智能手机中的 widget 或大多数门户应用程序中的 portlet。每个小工具都有自己独特的界面和行为。例如,饼图 小工具在饼图中显示数据,而 分配给我 小工具则在表格中列出分配给当前用户的所有未解决的问题。小工具是使用搜索筛选器的另一种方式,它可以将结果直观地展示给最终用户。Jira 开箱即带许多有用的小工具,您还可以通过第三方应用程序向 Jira 添加更多小工具。我们将在 第 12 章 介绍如何安装和管理第三方应用程序。

让我们先来看看如何在仪表板上添加小工具。

将小工具放置在仪表板上

所有小工具都列在 小工具目录 中。Jira 自带了许多有用的小工具,例如您在 系统仪表板 上看到的 分配给我 小工具。下面的截图显示了小工具目录,其中列出了 Jira 中所有捆绑的小工具:

image 2023 11 30 22 25 56 420
Figure 1. Figure 10.19 – Gadget directory

执行以下步骤将小工具放置到仪表板上:

  1. 仪表板 中调出下拉菜单。

  2. 选择您想要添加小工具的仪表板。

  3. 单击右上角的 添加小工具 选项。这将打开 小工具目录 窗口。

  4. 单击 加载所有小工具 链接以显示所有小工具。您只需在第一次加载小工具目录时执行此操作。

  5. 单击您要添加的小工具的 添加小工具 按钮。

  6. 关闭对话框返回仪表板。

根据您选择的小工具,有些小工具需要配置其它选项。对于这些小工具,您将在仪表板上看到它们的配置屏幕。填写选项并点击保存按钮。

让我们看看下面的 筛选结果 小工具配置屏幕截图:

image 2023 11 30 22 27 34 644
Figure 2. Figure 10.20 – Configuring a gadget

在配置屏幕上,您可以选择要显示的搜索过滤器,并控制要显示的结果数量和要包含的字段。一个常用参数是 自动刷新 选项,在这里你可以决定小工具刷新内容的频率,或者在不选中该选项的情况下保持静态。无论何时刷新整个仪表盘,所有小工具都会加载最新数据,但如果在仪表盘上停留较长时间,每个小工具都会自动刷新数据,因此内容不会随着时间的推移而变得陈旧。

添加小工具时,它通常会被添加到仪表板上的第一个可用位置。这有时可能不是你想在仪表板上显示小工具的位置,在其它情况下,你可能想不时地移动现有的小工具。作为仪表板的所有者,您可以通过拖放将仪表板上的小工具移动到所需位置。

编辑小工具

首次将小工具放置在仪表板上时对其进行了配置,之后小工具就会记住这些配置,并使用这些配置来渲染内容。您可以更新配置细节,甚至更新外观和感觉,如下所示:

  1. 浏览到有要更新的小工具的仪表板。

  2. 将鼠标悬停在小工具上,然后单击其右上角的向下箭头按钮。这将弹出小工具配置菜单。

  3. 点击 编辑 选项。

  4. 这将使小工具进入配置模式。

  5. 更新配置选项。

  6. 单击 保存 按钮应用更改。您可以在此查看示例:

image 2023 11 30 22 29 24 816
Figure 3. Figure 10.21 – Editing a gadget

上面的截图显示了 分配给我 小工具的 编辑 菜单。有些小工具会有一个 刷新 选项。由于小工具通过 AJAX 异步获取数据,因此可以使用该选项刷新小工具本身,而无需刷新整个页面。编辑删除颜色 选项只有仪表板的所有者才能使用。

删除小工具

作为仪表板的所有者,您可以在不再需要现有小工具时将其从仪表板中移除。从仪表板中删除小工具时,请注意所有可以访问您仪表板的其它用户都将无法再看到该小工具。执行以下步骤删除小工具:

  1. 浏览到有要删除的小工具的仪表板。

  2. 将鼠标悬停在小工具上,然后单击其右上角的向下箭头按钮。这将弹出小工具配置菜单。

  3. 点击 删除 选项。

  4. 根据提示确认删除。

一旦删除,小工具就会从仪表板上消失。如果您选择在稍后阶段重新添加相同的小工具,则必须再次重新配置。

以上介绍了 Jira 中的搜索、报告和仪表板。在下一节中,我们将为人力资源项目创建一个自定义仪表板。