22.2.2 使用多个 configutil 参数指定通知邮件

对于大部分通知邮件，您可以通过运行单个 local.store.notifyplugin 命令指定邮件。

但是，以下通知邮件使用（或可以使用）多个 local.store.notifyplugin 命令配置：

1. NewMsg

2. UpdateMsg

3. DeleteMsg

4. MsgFlags

以下过程介绍了如何设置这些通知邮件。

配置带有邮件标题和邮件正文的新邮件和更新邮件通知

有新的或更新的电子邮件时，您可以将邮件标题和邮件正文添加到发送的通知邮件文本。

可以选择包括邮件标题还是邮件正文；可以两个功能都包括、仅包括一个功能，或者都不包括。默认情况下发送不带邮件标题和邮件正文的邮件。

1. 指定新邮件或更新邮件通知：

   configutil -o local.store.notifyplugin.jmqnotify.NewMsg.enable -v 1

   configutil -o local.store.notifyplugin.jmqnotify.UpdateMsg.enable -v 1

   其中 jmqnotify 是插件的名称

   而 -v 1 为这些邮件启用通知。值为 0 禁用通知。

2. 用大于 0 的值指定 maxHeaderSize 参数，如下例所示：

   configutil -o local.store.notifyplugin.jmqnotify.maxHeaderSize -v 1024

   其中 jmqnotify 是插件的名称

   而 1024 是要发送的邮件标题的最大大小。maxHeaderSize 的默认值为 0，表示不随邮件发送标题信息。

3. 用大于 0 的值指定 maxBodySize 参数，如下例所示：

   configutil -o local.store.notifyplugin.jmqnotify.maxBodySize -v 1024

   其中 jmqnotify 是插件的名称

   而 5120 是要发送的邮件正文的最大大小。maxBodySize 的默认值为 0，不随邮件发送正文信息。

配置带有邮件标题的删除邮件通知

在删除电子邮件消息时，您可以将邮件标题添加到发送的通知邮件文本中。

包含邮件标题是可选的。默认情况下发送不带邮件标题的通知。

1. 在删除电子邮件时发送通知：

   configutil -o local.store.notifyplugin.jmqnotify.DeleteMsg.enable -v 1

   其中 jmqnotify 是插件的名称

   而 -v 1 为此邮件启用通知。值为 0 禁用通知。

2. 指定 ExpungeHeaders 参数：

   configutil -o local.store.notifyplugin.jmqnotify.ExpungeHeaders -v 1

   其中 jmqnotify 是插件的名称

   而 -v 1 使删除邮件通知能够包含邮件标题。ExpungeHeaders 的默认值为 0，禁止删除邮件通知包含标题信息。

   必须配置 ExpungeHeaders 参数启用 DeleteMsg 邮件包含邮件标题的功能。

3. 用大于 0 的值指定 maxHeaderSize 参数，如下例所示：

   configutil -o local.store.notifyplugin.jmqnotify.maxHeaderSize -v 1024

   其中 jmqnotify 是插件的名称

   而 1024 是要发送的邮件标题的最大大小。maxHeaderSize 的默认值为 0，表示不随邮件发送标题信息。

22.2.2.1 配置邮件状态更改通知

可以配置一个在电子邮件更改状态的时候发送的通知邮件。

在邮件标志通知中传送的信息

邮件标志通知在状态标志更改时生成，这种更改是因为电子邮件：

• 已回复

• 已标记

• 已删除

• 已读（已阅读）

• 存为草稿

发送邮件标志通知时，通知包含以下属性：

• 在电子邮件状态更改之前为其设置的标志

• 在电子邮件状态更改之后为其设置的标志

此信息包含在两个属性（oldflags 和 newflags）中，它们是包含 5 个字符的字符串。

有关这两个属性值的说明，请参见newflags 和 oldflags 属性的语法。

邮件标志通知所需的 configutil 参数

要启用邮件标志通知，必须配置以下 configutil 参数：

• local.store.notifyplugin.MsgFlags

• local.store.notifyplugin.*.MsgFlags.enable

第一个 MsgFlags 参数启用 IMAP 服务器和消息存储，以标识和跟踪状态标志更改的值，以便在通知邮件中传送此信息。

此参数应用于所有通知插件。因此，如果任何通知插件使用邮件标志通知，您必须启用此参数。如果没有插件使用邮件标志通知，请确保禁用此参数（其默认值）。

第二个参数 *.MsgFlags.enable 允许为某个特定的插件库发送邮件标志通知。

要为邮件标志启用通知，您必须两个参数都配置。

在邮件状态标志更改时启用通知

1. 跟踪状态标志并使邮件标志通知包含状态信息：

   configutil -o local.store.notifyplugin.MsgFlags -v 1

   其中 -v 1 使邮件标志信息能够与邮件标志通知一起发送。值为 0 禁用此通知。

2. 使邮件标志通知由特定的插件发送：

   configutil -o local.store.notifyplugin.jmqnotify.MsgFlags.enable -v 1

   其中 jmqnotify 是插件的名称

   而 -v 1 为此插件启用邮件标志通知。值为 0 禁用通知。