Using Tokens in Content Rules and Policy References

The following tables provide a full list of tokens that can be used in certain What To Do? actions and Policy References.

References to Email policy content are only available when an Email Gateway is included in the peer group.

Tell me about...

Tokens for use in Web Content Rules and References

Use tokens to configure the content of Block Pages, Informs, and Email Alarm Messages by specifying values that are only known at runtime. When the Clearswift Gateway generates a Block Page or Inform, the characteristics represented by tokens are replaced with the actual values. For example, the token %USERADDRESS% is replaced with the IP address of the client machine at runtime.

Token	Where supported	Value
%ADMIN%	Inform	The Clearswift Gateway email address.
%ALARM_DESCRIPTION%	Email Alarm Message	A description of the raised alarm.
%ALARM_TEXT%	Email Alarm Message	The text of the raised alarm.
%ALARM_TYPE%	Email Alarm Message	The type of the raised alarm.
%CONTENTDETECTED%	Block Page Inform	The names of the triggered content rules.
%DIAGNOSTICS%	Block Page Inform	A complete report of the data analysis.
%FORMATTYPE%	Block Page Inform	The type of data recognized.
%FORMATSUBTYPE%	Block Page Inform	The low level type of data recognized.
%HOSTNAME%	Email Alarm Message	The hostname of the machine on which an alarm has been raised.
%IPADDRESS%	Email Alarm Message	The IP address of the machine on which an alarm has been raised.
%PROXY%	Block Page Quota Warning Page	The hostname of the server that initiated the warning page.
%ROUTE%	Block Page Inform	The name of the route that determined the policy.
%ROUTE_QUOTA%	Block Page Quota Warning Page	The total quota time for the current route.
%RULES%	Block Page Inform	A comma separated list of matched rules.
%SERVERADDRESS%	Inform	The hostname of the Clearswift Gateway.
%URL%	Block Page Inform	The full URL of the request.
%URL_CATEGORY%	Block Page Inform Quota Warning Page	The URL category name for the current request.
%USER%	Block Page Inform	The user name, or, if no user name is available, the IP address of the client machine.
%USER_QUOTA_REMAINING%	Block Page Quota Warning Page	The remaining quota time for the user for the current route.
%USER_QUOTA_USED%	Block Page Quota Warning Page	The quota time used by the user for the current route.
%USERADDRESS%	Block Page Inform	The IP address of the client machine.

Tokens for use in Information Governance informs

Token	Description
%DOC_OWNERS_COUNT%	The number of document owners where a match has been found. This token is available in both the subject and the body of a message.
%DOC_SET_OWNERS%	The details of document owners of matched documents.
%DOC_NAMES%	The file name and file location if available of registered documents where a match was found.
%DOC_NAMES_CLASSIFICATION%	The file name and file location if available, and the classification of registered documents where a match was found.
%DOC_NAMES_MATCH%	The file name and file location if available, and the percentage match of registered documents where a match was found.
%DOC_LIST_MATCHES%	The file name and file location if available, and a list of matches for each registered document where a match was found.
%DOC_NAMES_PROPERTIES%	The file name and file location if available, and any custom properties for each registered document where a match was found.
%DOC_SETS%	The collection name where matched registered documents were detected.

When informs are copied to the document owners, tokens will only show information relevant to documents registered for that particular document owner.

Where tokens are supported

Where supported	Meaning
Alert	A Generate an Alert action in a Content Rule
Annotation	A Message Annotation Policy Reference
Block Page	A Block Page Policy Reference
Email Alarm Message	An email message that is sent to a specified address when an alarm is raised, if the Gateway is configured to do so.
Inform	An Inform Policy Reference
Log entry	A Log a Message action in a Content Rule
Quota Warning Page	A Quota Warning Policy Reference
Tag subject	A Tag the Message Subject action in a Content Rule
Add header	An Add a Message Header action in a Content Rule
Notify Sender	An email message that is sent to a sender when a message is released, if the Gateway is configured to do so.
Notify Auditor	An email message that is sent to an auditor when a message is released, if the Gateway is configured to do so.