Variables in User Notifications and Email Replies

Policy Guide › User Notifications › Variables in User Notifications and Email Replies

Variables in User Notifications and Email Replies

When defining the text in a notification dialog, notification email, automatic email reply, or replacement file message to users, you can use variables to represent certain types of information and to customize the text content based on the circumstances of the control event. For example, if a control trigger displays a warning when users browse to various Web sites, you can use the %URL% variable to include the actual URL in your notification message.

Note:

Variables are not case-sensitive. So, for example, you can type %URL% or %url% when defining a notification message.
The exact format of the email address replacement string depends on the type of email address. For SMTP mail it is for example "Spencer Rimmel(spencerrimmel@unipraxis.com)" and for Exchange mail "Spencer Rimmel(spencer rimmel(unipraxis))". This applies to the %address%, %to%, %from%, %cc%, and %bcc% variables.

The supported variables follow:

%Address%

Displays the email address, or addresses, that caused the control trigger to activate. For outgoing emails, this is the recipient addresses; for incoming emails, it is the sender address.

For example, these messages in the policy:

You are not authorized to send emails to %Address%.
You are not authorized to receive emails from %Address%.

Display like this in notification messages:

You are not authorized to send emails to Spencer Rimmel(spencerrimmel@unipraxis.com), Frank Scheffer(frankscheffer@unipraxis.com).
You are not authorized to receive emails from Spencer Rimmel(spencerrimmel@unipraxis.com).

%Application%

Displays the application that activated an Application Monitor control trigger

For example, this message in the policy:

You are not authorized to run %Application%.

Displays like this in a notification message:

You are not authorized to run Netscape.

%ApplicationPath%

Displays the path and executable name of the application that activated an Application Monitor control trigger. For example, this message in the policy:

CA DataMinder has detected %ApplicationPath% starting up.

Displays like this in a notification message:

CA DataMinder has detected c:\program files\netscape\netscp.exe starting up.

%BCC%

Displays any recipients listed in the Bcc: field of a forwarded email.

For example, if the user policy specifies this message for the body text of the notification email:

The attached email has been forwarded to you for approval because the Bcc: addressees include %BCC%.

It displays like this in a notification email:

The attached email has been forwarded to you for approval because the Bcc: addressees include Spencer Rimmel(spencerrimmel@unipraxis.com).

%CC%

Displays any recipients listed in the Cc: field of a forwarded email.

For example, this message in the policy:

You are not authorized to use credit card number %CCN%.

Displays like this in a notification message:

You are not authorized to use credit card number 4100 1234 1234 1234.

Note: The display of credit card numbers in notification messages is subject to the same constraints as elsewhere in CA DataMinder. This is governed by the Sensitive Information Handling setting in the System Settings folder.

%CCN%

Displays the credit card number detected by CA DataMinder and which activated a Credit Card control trigger.

For example, this message in the policy:

You are not authorized to use credit card number %CCN%.

Displays like this in a notification message:

You are not authorized to use credit card number 4100 1234 1234 1234.

%Default%

(For the body text of notification emails and automatic email replies only.)

Displays summary details about the forwarded email. For example, this body text in the policy:

%default%

Displays details like this in the notification email:

The original mail message is:
From: lyndasteel@unipraxis.com
To: Spencer Rimmel <EX:/O=UNIPRAXIS/OU=UK/CN=RIMMEL/CN=SPENCER>
Subject: Corporate Restructing

%From%

Displays the original sender of an email that was detected by a control trigger and forwarded to another address.

For example, if the user policy specifies this message for the body text of a notification email:

An email from %FROM% has been intercepted and forwarded to you for approval.

It displays like this in a notification email:

An email from Lynda Steel(lyndasteel@unipraxis.com) has been intercepted and forwarded to you for approval.

%Keystring%, %Keyword%

Display the word or phrase detected by CA DataMinder in a Web page, email or file and which caused a control trigger to activate.

For example, this message in the policy:

Warning: This email refers to %Keystring%. Such references are normally prohibited in corporate correspondence.

Displays like this in the notification message:

Warning: This email refers to Project Alpha. Such references are normally prohibited in corporate correspondence.

Note: In practice, these variables are interchangeable but you may find notification messages easier to maintain if you use the variables in their 'natural' context. That is, you use %Keyword% to represent single words and %Keystring% for phrases or sentences.

%Keystrength%

Displays the keystrength of the encryption algorithm used on a Web site.

For example, this message in the policy:

This site uses %Keystrength% encryption. You are only permitted to browse sites that use at least 256 bit encryption.

Displays like this in a notification message:

This site uses 128 bit encryption. You are only permitted to browse sites that use at least 256 bit encryption.

Note: %Keystrength% does not return a value when used in a URL control trigger (because the trigger activates as soon as it detects the URL, before CA DataMinder can check the encryption level). Also, be aware of the browser requirements when exempting secure Web sites.

%MailDateTime%

Displays the time and date when an incoming email was received and when outgoing email was sent.

For example, if the user policy specifies this message for the Subject of the notification email:

Unauthorized email detected: %MailDateTime%

It displays like this in the notification email:

Unauthorized email detected: 16/05/2003 8:23

You cannot configure the date and time format from within CA DataMinder. The format shown in a notification email is determined by the short date format defined for the local machine.

%MessageClass%

Displays the message class of a captured email, such as IPM.Schedule.Meeting.Request.

This variable is primarily for testing purposes. Using msgattr lookup commands, you can exclude specific types of email such as read receipts and meeting requests. The %MessageClass% variable lets you confirm that the correct message classes are being detected.

%MessageToUsers%

Displays the value of the Message To Users setting.

For example, you can forward blocked emails to a manager. You can also specify separate notification messages for the original sender and the manager. If the user policy specifies:

This message for the 'Trigger/Message to Users' setting in the trigger:

References to %Keystring% are prohibited in corporate correspondence.

This message for the 'System Settings/User Notifications/Forwarded E-mail Settings/Outgoing Body' setting:
```
The attached mail was blocked. The message displayed to the sender was "%MessageToUsers%".
```

Then, the forwarded email contains this message:

The attached mail was blocked. The message displayed to the sender was "References to Project Alpha are prohibited in corporate correspondence."

%Site%

Displays the 'site' element of a Web site URL or the 'organization' element of an email address. This can be useful if you want to make the notification message easier to read.

For example, these messages in the policy:

You are not authorized to browse the %Site% Web site.
You are not authorized to send emails to %Site%.

Display like this in notification messages:

You are not authorized to browse the Unipraxis Web site.
You are not authorized to send emails to Unipraxis.

%SSN%

Displays the social security number detected by CA DataMinder and which activated a classifier, keystring or attachment trigger.

For example, this message in the policy:

An email containing the social security number %SSN% has been intercepted for review. You are not authorized to send personally identifiable information.

Displays like this in a notification message:

An email containing the social security number 123-45-6789 has been intercepted for review. You are not authorized to send personally identifiable information.

CA DataMinder uses a sophisticated recognition process to cross-check against an imported list of currently available SSNs. That is, the US Social Security High Group File. To ensure that this data is accurate, we recommend you update this text file on a regular basis (for example, monthly).

%Subject%

Displays the Subject of the forwarded email.

For example, if the user policy specifies this message for the body text of the notification email:

The email "%Subject%" has been intercepted and forwarded to you for approval.

It displays like this in the notification email:

The email "Corporate Restructuring" has been intercepted and forwarded to you for approval.

Note the optional use of double-quotes to highlight the Subject reference in the notification email.

%To%

Displays any recipients listed in the To: field of a forwarded email.

For example, if the user policy specifies this message for the body text of the notification email:

The attached email has been forwarded to you for approval because it was addressed to %To%.

It displays like this in a notification email:

The attached email has been forwarded to you for approval because it was addressed to Spencer Rimmel(spencerrimmel@unipraxis.com).

%TriggerName%

Displays the value of the Trigger Name setting.

For example, if the user policy specifies this message for the 'Trigger/Message to Users' setting in the trigger:

This message or the associated attachment(s) you are attempting to send is in possible violation of a corporate intellectual property rights policy called "%triggername%".

Then it displays like this in a notification email:

This message or the associated attachment(s) you are attempting to send is in possible violation of a corporate intellectual property rights policy called "Patent Applications".

%URL%

Displays the URL of the Web site that activated the trigger.

For example, this message in the policy:

You are not authorized to browse %URL%.

Displays like this in a notification message:

You are not authorized to browse http://www.unipraxis.com.

Note: Any query strings are excluded from the URL displayed in the message. This is the part of a URL containing the search parameters when submitting data to a dynamic Web site. For example, id=LogiCard is a query string in this URL:

www.unipraxis.com/solutions.cgi?id=LogiCard.

In the actual notification message, this URL will therefore be represented as:

www.unipraxis.com/solutions.cgi?