Customizing Event Center messages

The Event Center sends emails, SMSes, and push notification messages based on triggering events. When you configure events, you can use the default message template or create a new one. Event Center templates enable you to specify content and basic formatting using HTML markup.

Displaying Event Center templates

To display Event Center templates:

  1. In the Admin Portal, go to Settings > Templates.

    Event Center templates dialog box

  2. Select Event Center Templates.

    This list includes the default templates for each Event Center type. Default templates are not editable.

  3. Select the View link for the message template you want to view.

    List of the default templates for each Event Center type

The $SERVER_IDENT variable was removed from the $DEFAULT_POLICY_VIOLATION_MESSAGE variable and is now part of the Event Center template. Add the $SERVER_IDENT variable to the template to display server identity in an alert message. The $SERVER_IDENT variable is also a substitution variable in compliance actions. Use of this variable depends on whether the compliance action was updated from version 1 to version 2. For V1 actions, include this variable in the Event Center template or as part of the alert message text in the compliance action. For V2 actions, include this variable only as part of the alert message text in a compliance action.

Adding custom Event Center messages

To add a custom Event Center message:

  1. Select the event type from Settings > Templates > Event Center Templates > Add New. The Add New Event Center Template dialog box displays.

    Add New Event Center Template dialog box

  2. Event Center messages are displayed with the HTML markup that provides the basic formatting for the content.
  3. In the Name field, enter a name for the template.

    The name must be unique for events of the same type.

  4. In the Edit Template for field, select the language this template will be used for.

    Note that only those languages that have been enabled for the system will be displayed in this list.

  5. Make changes to the displayed messages.

For creating a company-branded Event Center email, you can copy and paste an HTML email message into the Email Body field. For more information, see Sending a company-branded email.

  1. Select Save.

Adding other types of templates

There are "Other" types of events that have templates that you can modify and use. The "Other" list includes the default template for: Action on Device, App Distribution, Selective Wipe, and Wipe. Default templates are not editable.

Procedure 

  1. Go to Settings > System Settings.

  2. Select Templates > Others.

    The Others template page displays.

  3. Find the language you want the template to display in and then select the Edit icon.

    The Edit Template dialog box opens. For this example, the Edit Template: Wipe (English) dialog box opens.

    Edit Template: Wipe (English) dialog box

  4. Enter the information in the form.

    • Email Subject - Modify the default text or enter a short phrase that gives a summary of the message.

    • Email Body - Modify the provided text for your needs. See Using variables in Event Center messages

  5. When finished, select Save.

Customizing registration messages

Using variables in Event Center messages

Supported and required variables for Event Center messages vary by the type of message. The following table summarizes these variables. You can also select the Variables Supported link to display this information. Note that, unlike variables used for registration variables, Event Center variables do not end with $.

Table 125.  Variables in Event Center messages

Template Type

Required Variables

International Roaming

$CURRENT_COUNTRY

$HOME_COUNTRY

$PHONE_NUMBER

$SEVERITY

$USER_NAME

Threshold Reached

$PHONE_NUMBER

$SEVERITY

$THRESHOLD_ON

$THRESHOLD_TYPE

$THRESHOLD_UNIT

$THRESHOLD_VALUE

$USED_VALUE

$USER_NAME

SIM Changed

$CURRENT_PHONE_NUMBER

$NEW_PHONE_NUMBER

$SEVERITY

$USER_NAME

Memory Size Exceeded

$FREE_MEMORY_SIZE

$MEMORY_SIZE_LIMIT

$PHONE_NUMBER

$SEVERITY

$TOTAL_MEMORY_SIZE

$USER_NAME

System Event

$DEFAULT_SYSTEM_MESSAGE

$SERVER_IP

$SERVER_NAME

$SEVERITY

Policy Violation

$DEFAULT_POLICY_VIOLATION_MESSAGE

$PHONE_NUMBER

$SEVERITY

$USER_NAME

Variable descriptions

The following table describes the variables used in Event Center messages.

 

Table 126.  Variable descriptions

Variable

Description

$CURRENT_COUNTRY

The country in which the device is currently located.

$CURRENT_PHONE_NUMBER

The phone number currently associated with the device in Ivanti EPMM, but not matching the phone number currently used by the device.

$DEFAULT_POLICY_VIOLATION_MESSAGE

The hard-coded message associated with the policy violation that triggered the alert.

Due to the length limits of SMS and APNs, the text might be truncated.

$DEFAULT_SYSTEM_MESSAGE

The third-party system message or error that triggered the alert.

$FREE_MEMORY_SIZE

The amount of free memory currently available on the device.

$HOME_COUNTRY

The home country of the device.

$MEMORY_SIZE_LIMIT

The threshold set for the device memory.

$NEW_PHONE_NUMBER

The phone number replacing the $CURRENT_PHONE_NUMBER$ as a result of a SIM change.

$PHONE_NUMBER

The phone number used by the device.

$SERVER_IP

The IP address of the server triggering a system event alert.

$SERVER_NAME

The hostname of the server triggering the system event alert.

$SEVERITY

The defined severity of the system event, i.e., Information, Warning, or Critical.

$THRESHOLD_ON

The total used for calculations, i.e., International Roaming or Total Usage.

$THRESHOLD_TYPE

The type of usage measured, i.e., SMS, Data, or Voice.

$THRESHOLD_UNIT

The unit associated with the type of usage, i.e., minutes, messages, or MB.

$THRESHOLD_VALUE

The defined threshold value for this event, e.g., 1000 (voice minutes).

$TOTAL_MEMORY_SIZE

The total memory reported by the device.

$USED_VALUE

The amount of memory currently used on the device.

$USER_NAME

The display name of the user associated with the device.

Specifying which template to use

When you create or edit an event, you specify which template to use for resulting alerts. To select a template:

  1. Create or edit an event.
  2. Select a template from the drop-down or select the Create button to create a new template.

Filtering Event Center messages

In the Event Center Templates page, you can filter messages by event type. Just select the preferred event type from the Event Type drop-down.

Editing Event Center messages

You can edit your custom Event Center templates. However, default Event Center templates are not editable.

To edit a custom Event Center template:

  1. In Admin Portal, go to Settings > Templates > Event Center Templates.

  2. Select the edit icon for the custom template you want to edit.
  3. Make your changes. See Sending a company-branded email
  4. Select Save.

Deleting Event Center messages

You can delete any of the Event Center messages you have created:

  1. In Admin Portal, go to Settings > Templates > Event Center Templates.
  2. Select the items you want to delete.
  3. Select Delete.