Message Server Integration Guide › Exchange, Domino and IIS SMTP Integration › Server-side Interactive Warnings › Message Templates Files › Template Insertion Variables

Template Insertion Variables

CA Data Protection supports the following variables in notification message template files:

%subject% variable

When used in a warning message template, this variable is replaced by the subject of the original email in the message seen by users.

When used in an ‘Unmatched Response’ message template, this variable is replaced by the subject of the user’s reply to the warning message.

This variable can also be typed directly into the UnmatchedResponseTitle registry value on the Exchange server, where this registry value sets the ‘unmatched response’ message title.

%maildatetime% variable

When used in warning message templates, this variable is replaced by the date and time of the original email, relative to the time zone of the host server.

When used in ‘Unmatched response’ message templates, this variable is replaced by the date and time of the user’s reply to the warning message, relative to the time zone of the host server.

The date and time in the message seen by users is displayed in RFC 2822 format. For example, if the template file contains this text:

Your email on %maildatetime% appears to breach corporate guidelines.

It displays like this in the warning:

Your email on Fri, 12 May 2006 16:22:10 -0400 appears to breach corporate guidelines.

Where, in this example, -0400 indicates EDT (Eastern Daylight Time) or four hours behind UTC.

%formattedwarningtext1% variable

When used in warning message templates, this variable is replaced by details of the warnings (or inform events) triggered by the email. For each trigger that activates, this variable returns two text items: a title and message:

• The title derives from the 'Dialog Title - Warnings and Quarantine Events' setting in the System Settings\User Notifications\ policy folder (or for Inform events, the 'Dialog Title - Inform, Notify, and Categorize Events' setting).
• The message is based on the Message To Users setting, included in each policy trigger.

If the sender’s email causes multiple triggers to activate, the %formattedwarningtext1% variable writes to the warning email a ‘title and message’ pair for each trigger, with each pair separated by a blank line:

<Warning dialog title 1>
<Trigger 1 message>
<Blank line>
<Warning dialog title 2>
<Trigger 2 message>

For example, if two triggers activate, the warning email would look like this:

CA Data Protection Advisory
You are not permitted to send emails to these teams: Equity Markets, Debt Markets.

CA Data Protection Advisory
This email refers to ‘Project Alpha’. Such references are normally prohibited in corporate correspondence.

Note: This variable is not suitable for use with the UnmatchedResponseTemplateFile registry value or the UnmatchedResponseTitle message template.

%formattedwarningtext2% variable

When used in warning message templates, this variable is replaced by the details of the warnings (or inform events) triggered by the email. For each trigger that activates, this variable returns a message based on the 'Message To Users' trigger setting.

If the sender’s email causes multiple triggers to activate, %formattedwarningtext2% writes to the warning email a message for each trigger, separated by a blank line:

<warning #1 message>
<blank line>
<warning #2 message>

Note: This variable is not suitable for use with the UnmatchedResponseTemplateFile registry value or the UnmatchedResponseTitle message template.

%to% variable

When used in warning message templates, this variable is replaced by the address(es) in the To field of the original email. For example, if the template file contains:

Your email to %to% breaches corporate rules.

It displays like this in the warning:

Your email to srimmel@unipraxis.com breaches corporate rules.

Note: This variable is not suitable for use with the UnmatchedResponseTemplateFile registry value or the UnmatchedResponseTitle message template.

%cc% variable

When used in warning message templates, this variable is replaced by the address(es) in the Cc field of the original email.

Note: This variable is not suitable for use with the UnmatchedResponseTemplateFile registry value or the UnmatchedResponseTitle message template.