Customize the post office email template

We can enable or disable the post office and set the time interval that the post office uses to collect messages to aggregate. We can also customize the email template used to generate the aggregate message that is sent to the recipients.

When you enable the post office, all email notifications are stored until the time interval specified. At that time, the notifications are aggregated into one email message that is sent to the recipients..

The post office email template can use dynamic content. Dynamic content includes dynamic content message tags and JavaScript code. Dynamic content also includes tags that replace variables with other values, or reference a property that allows translation with the use of a CustomLabels.properties file.

The template is applied to the collection of notification messages that the system holds for a specified Group E-mail Topic value and message recipient. This template can be as simple or as complex as required. The Group E-mail Topic value is set in the workflow designer.

To enable the post office and configure a post office aggregation email template...

1. Click Configure System > Post Office. The Post Office page is displayed.

2. On the Post Office page, select the Enable store forwarding check box.
3. In the Collection interval field, enter the number of minutes to pass before the post office aggregates the stored email messages and sends them to the recipients. The value of the collection interval must be an integer 5 - 10080.

4. In the Subject field, enter the text to specify the subject of the email notification that is sent as the aggregate message instead of being sent as an individual email message. The subject can consist of plain text and dynamic content tags.

5. In the Plaintext body field, enter the text to be displayed in the body of the aggregate message. The content can consist of plain text, dynamic content tags, and JavaScript code. These contents are shown to email recipients that do not see HTML email notifications.

6. In the XHTML body field, enter the text to be displayed in the body of the email notification as HTML. The content can consist of plain text, dynamic content tags, and JavaScript code. These contents are shown to email recipients that see HTML email notifications. For the correct aggregation of XHTML bodies of individual email templates with the post office email aggregation template, use an optional attribute ‘escapeentities'. This attribute is in the <JS> tag of Post Office XHTML body template. Set the value to false. See Sample post office email aggregation template for more details.

7. Click OK to save the changes and then click Close.

After the next interval expires, the combined notifications are aggregated and sent as one email notification.

Test the post office email aggregation template that we created before with it to aggregate email notifications that are sent to activity participants.

Parent topic: Post office configuration