Policy Guide › User Definitions

User Definitions

User definitions, also known as 'replaceable strings' are variables that can be referenced by any settings in the current user policy that have a text value (for example, trigger names, address lists, search text lists, messages to users). For example, you can define a 'Disclaimer' user definition and reference this as %Disclaimer% in any Trigger Name setting.

Example

For example, you can add a 'Disclaimer' user definition and set its value to:

Unipraxis distributes this document for informational purposes only.

You can then reference this definition as %Disclaimer% in any other policy trigger. For example, you can include this definition in the explanatory message that users see when their email is blocked, for example:

"Your email has been blocked because it does not include the mandatory corporate disclaimer: %Disclaimer%"

To set up a user definition

1. Open the policy you want in the Administration console.
2. In the Policy Editor screen, browse to the System Settings folder.
3. In the Definitions policy folder, select the User Definitions setting and the User Definition you want to configure.
4. Enter a name for the user definition, such as 'Disclaimer'.

   Note: This name is case sensitive and must not contain spaces or a percentage symbol (%).

5. Enter a value for the definition, such as:

   Unipraxis distributes this document for informational purposes only.

6. This user definition can now be referenced as a string value in any other policy trigger, for example, in a Message To Users setting:

   "Your email attachment has been blocked, as it is missing its mandatory corporate disclaimer: %Disclaimer%"

Notes:

• If you inadvertently define multiple User Definitions with the same name, then any duplicate definitions are ignored and an error is written to the Activity log.

User definitions can themselves contain variables specified by other user definitions. Ensure that you do not create circular references. For example, if User Definition 1 references User Definition 2, User Definition 2 must not reference User Definition 1.