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. 以大於零的值指定 maxHeaderSize 參數，如以下範例所示：

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

   其中 jmqnotify 是外掛程式的名稱，

   而 1024 是可傳送的標頭大小上限。maxHeaderSize 的預設值為 0，表示傳送的郵件無標頭資訊。

3. 以大於零的值指定 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. 以大於零的值指定 maxHeaderSize 參數，如以下範例所示：

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

   其中 jmqnotify 是外掛程式的名稱，

   而 1024 是可傳送的標頭大小上限。maxHeaderSize 的預設值為 0，表示傳送的郵件無標頭資訊。

22.2.2.1 配置郵件狀態變更的通知

您可以配置通知郵件，使其在電子郵件變更狀態時進行傳送。

郵件旗標通知中遞送的資訊

每次電子郵件的狀態旗標變更為以下其中之一時，會產生郵件旗標通知：

• Answered

• Flagged

• Deleted

• Seen (read)

• Draft

傳送郵件旗標通知時，該通知會帶有以下特性：

• 在電子郵件狀態變更前設定的旗標

• 在電子郵件狀態變更後設定的旗標

此資訊隨附在 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 會停用通知。