通知

通知将事件(包括系统事件和自定义事件)与电子邮件收件人相关联。当事件被触发和接收时,就会发送电子邮件。通知类型定义了电子邮件的收件人。例如,您可以将其设置为只向特定用户或给定用户组的所有成员发送电子邮件。您可以为给定事件添加多个通知。

Jira 随附了一个全面的通知类型(即收件人)列表,可以满足您的许多需求。下表列出了所有可用的通知类型及其工作方式:

Table 1. Figure 8.3 – Notification types
通知类型 描述

Current Assignee

这是该问题的当前受让人。

Reporter

这是该问题的报告者(通常是创建该问题的人)。

Current User

这是触发该事件的用户。

Project Lead

这是该问题所属项目的负责人。

Component Lead

这是问题所属组件的线索。

Single User

这表明 Jira 中存在的任何用户。

Group

这表明所有用户都属于指定组。

Project Role

这表明所有用户都属于指定的项目角色。

Single Email Address

这表明任何电子邮件地址。

All Watchers

这表明所有用户都在关注这个问题。

User Custom Field Value

这表明在用户类型自定义字段中指定的用户。例如,如果您有一个名为“收件人”的用户选择器自定义字段,则在自定义字段中选择的用户如果有权访问该问题,将会收到通知。

Group Custom Field Value

这表明属于组类型自定义字段中的组的所有用户。例如,如果您有一个名为“批准者”的组选择器自定义字段,则在自定义字段中选择的组(有权访问该问题)中的所有用户都将收到通知。

正如您所看到的,该列表包含从问题报告人到自定义字段中包含的值等多种选项。任何可以表示用户(如项目负责人)或包含用户值(如用户自定义字段值)的内容都可以选择接收通知。

如果一个用户属于一个事件的多个通知,Jira 会确保只发送一封邮件,以免用户收到重复邮件。用户必须拥有查看问题的权限才能接收通知。唯一的例外是使用单个电子邮件地址选项时(我们将在 第 9 章 保护 Jira 中讨论安全性)。如果用户没有查看问题的权限,Jira 将不会发送通知邮件。

现在,我们已经可以创建自定义事件、创建和修改邮件模板以及控制事件触发的时间,接下来我们将了解如何为事件添加通知,以便用户可以开始通过通知方案接收邮件。

通知方案

通知方案是一个可重复使用的实体,它将事件与通知联系起来。换句话说,它包含事件与其各自的电子邮件收件人之间的关联。在本节中,我们将介绍通知方案以及如何使用它们在 Jira 中发生事件时发送通知邮件。

要在 Jira 中管理通知方案,请按照以下步骤操作:

  1. 浏览到 Jira 管理控制台。

  2. 选择 问题 选项卡,然后选择 通知方案 选项。这将弹出 通知方案 页面:

image 2023 11 30 14 23 56 837
Figure 1. Figure 8.10 – The Notification Schemes page

在该界面中,您可以看到所有通知方案以及当前使用这些方案的项目的列表。Jira 自带一个通用的默认通知方案。默认方案为所有系统事件设置了通知。这样您就可以在 Jira 中快速启用通知。默认设置有以下通知:

  • Current Assignee

  • Reporter

  • All Watchers

您可以修改默认通知方案,添加自己的通知规则,但随着 Jira 采用人数的增加,最好从头开始创建一个新方案,或复制默认方案并在其中进行修改。

添加通知方案

与工作流方案等其它方案(Jira 会在创建新项目时创建一个工作流方案)不同,所有新项目都将设置为使用 默认通知方案 选项。因此,如果要创建特定于项目的通知,就必须创建新的通知方案。执行以下步骤创建新的通知方案:

  1. 浏览到 通知方案 页面

  2. 点击底部的 添加通知方案 链接

  3. 输入新通知方案的名称和描述

  4. 点击 添加 按钮创建通知方案

创建新通知方案时,您会创建一个空白方案,该方案可以稍后配置,以便您可以添加自己的 通知规则。创建新通知方案后,必须在将方案应用到项目之前配置其通知规则,否则将不会发送通知。本章稍后将介绍如何配置通知规则。

管理通知方案

通知方案包含在 Jira 事件中设置的通知。通知决定了谁会在相应事件触发时收到电子邮件。执行以下步骤添加新通知:

  1. 单击要配置的通知方案的 通知 链接。

  2. 单击 添加通知 链接或您希望添加通知的事件的 添加 链接。这两个操作都将带您进入 添加通知 页面。如果单击 添加 链接,事件选择列表将为您预选事件。

  3. 选择要添加通知类型的事件。

  4. 从可用选项中选择通知类型。

  5. 点击 添加 按钮。例如,下面的截图显示了为 Jira 设置的通知,即在创建和更新问题时向项目负责人发送电子邮件:

image 2023 11 30 14 27 19 012
Figure 2. Figure 8.11 – The Add Notification page

添加完成后,通知将与所选事件相对应。您可以重复相同的步骤,继续为事件添加通知。

您可以选择多个事件来添加通知类型。

当某些事件不再需要通知时,您也可以将其删除。要删除通知,您需要对每个事件逐一删除:

  1. 浏览到要配置的通知方案的 编辑通知 页面

  2. 点击要删除的通知的 删除 链接

  3. 单击 删除 按钮确认删除

删除通知后,受该通知影响的用户将停止接收来自 Jira 的电子邮件。但是,您需要注意您的配置,因为同一事件可能还有其它通知会继续向同一用户发送电子邮件。例如,如果您为问题创建事件创建了两个通知,一个设置为单个用户 John(属于 jira-administrator 组),另一个设置为 jira-administrator 组,而您的目标是阻止向用户 John 发送电子邮件,那么您需要从事件中删除这两个通知,而不是简单地使用 单个用户 选项。

分配通知方案

创建新项目时,会自动指定使用默认通知方案。如果希望项目使用不同的方案,则需要进入项目管理控制台的 通知 部分:

  1. 浏览到要应用通知方案的项目的项目管理页面。

  2. 从左侧面板选择 通知 选项:

    image 2023 11 30 14 30 06 611
    Figure 3. Figure 8.12 – Associating a notification scheme
  3. 操作 菜单中选择 使用不同方案

  4. 选择要使用的通知方案。

  5. 点击 关联 按钮。

通知方案一旦应用到项目,就会立即生效,您将看到针对方案中配置的事件发送的电子邮件。与 Jira 中的其它方案一样,通知方案也可以分配给多个项目,这样它们就可以共享相同的通知行为。

面对如此多的通知,用户往往会被 Jira 发送的电子邮件数量所淹没。在下一节中,我们将介绍如何通过批量处理来减少用户收到的通知邮件数量。