How to: Using Variables in Quota Notification Templates

Summary

The notifications that are sent when quotas reach set thresholds are determined by the Notification Template Group selected when the quota is configured. These templates can be edited, new Template Groups created, etc. (Knowledge Base article KB-2920 includes useful information about editing templates in general.) Default templates include certain variables that allow organizations to personalize the notifications and make them more relevent to specific circumstances. This article deals specifically with these notification variables.  

Variables Available

The following variables can be included in notification templates:

Quota Property

Syntax in Template

Server

[DATA:'SERVER']

Quota object

[DATA:'OBJECT']

Quota account

[DATA:'ACCOUNT']

Quota size

[DATA:'QUOTASIZE']

Current quota usage

[DATA:'USAGE']

Current quota usage as %

[DATA:'USAGEPERCENT']

SmartColumn value 1

[DATA:’SMARTCOLUMNVALUE1’]

SmartColumn value 2

[DATA:’SMARTCOLUMNVALUE2’]

SmartColumn value 3

[DATA:’SMARTCOLUMNVALUE3’]

SmartColumn value 4

[DATA:’SMARTCOLUMNVALUE4’]

SmartColumn value 5

[DATA:’SMARTCOLUMNVALUE5’]

 

QUOTA USAGE UNITS
The unit in which quota usage and or size is displayed in the notificaiton (when not shown as a percentage) can be controlled with 'styles'.

The different styles are used by adding the following syntax to the "Data:’QuotaSize’" or "Data:’usage’" variables in the notification templates:

[Data:’QuotaSize’, StyleKiloBytes]
[Data:’QuotaSize’, StyleMegaBytes]
[Data:’QuotaSize’, StyleGigaBytes]
[Data:’QuotaSize’, StyleTeraBytes]
[Data:’QuotaSize’, StyleAutoBytes] where the most appropriate size is automatically selected

Note that the number of decimals shown in the notification is determined by the regional settings on the associated NSS server (the server that holds the notificaiton template being used).

Confirm Results

To confirm successful inclusion of a variable, edit a test quota to use the relevant Notification Template Group then add data to the quota path to force it past the relevant threshold. Verify that the email notification sent is as expected.

Note that any mistake in the syntax of variables used in a notification template will prevent the email notification from being sent, an error will be printed in the Windows Event log highighting the invalid syntax.



ADDITIONAL RESOURCES

  • KB2920 How to: Create New Notification Template and Group
  • KB Article: 2807

    Updated: 8/22/2014

    • Category
      • Usage
    • Affected versions
      • NSS 9.0
      • NSS 9.5

    North America HQ

    NORTHERN Parklife, Inc.
    301Edgewater Place, Suite 100
    Wakefield, MA 01880
    USA

    Voice: 781.968.5424
    Fax: 781.968.5301

    salesUS@northern.net

     

    Additional Contact Information

    EMEA & APAC HQ

    NORTHERN Parklife AB
    St. Göransgatan 66
    112 33 Stockholm
    Sweden

    Voice: +46 8 457 50 00

    salesHQ@northern.net

    Northern Parklife



    ©2018 northern parklife

    privacy statement 
    terms of use