Customizing registration messages

The registration process is a critical part of deployment. You can customize the registration messages involved in this process by editing the registration templates. Registration templates enable you to specify content and basic formatting using HTML markup.

Ivanti EPMM sends multiple messages related to registration:

  • Registration SMS
  • Registration email and reminder email
  • Post registration email

These messages may vary by:

  • Platform
  • Language

In addition, messages may vary by device type:

  • Phones
  • PDAs

To accommodate this range of messages:

  • Separate registration templates are provided for each language/platform combination.
  • Each registration template contains separate text for each registration message type.
  • Each registration template contains separate text for phones and PDAs.
  • For when Ivanti EPMM discovers device users that have not downloaded the MDM profile, reminder email scheduling capabilities are provided

Viewing registration templates

To view Ivanti EPMM message templates:

  1. In Admin Portal, select Settings > Templates.
  2. Select Registration Templates.
  3. Select the View link for the template you want to view.

Editing registration messages

To edit registration messages:

  1. In Admin Portal, select Settings > Templates > Registration Templates.

  2. Select the template you want to edit and select the Edit pencil icon.

    Registration messages are displayed with the HTML markup that provides the basic formatting for the content.

  3. Make changes to the displayed registration messages.

    Do not add the <head> html tag in the registration template fields.

    Editing your registration template dialog box

  4. Select the Variables Supported link in the right corner of the dialog box to display a guide to the supported variables. See Using variables in registration messages for additional details.
  5. Select Save.

Next steps 

Scheduling reminder notifications for completing registration

Using variables in registration messages

Each field in a registration template has a set of supported variables, most of which are required. Supported and required variables also differ by OS. Use the following variables to guide your customization. You can also select the Variables Supported link to display this information. All variables except $BRANDING_COMPANY_NAME$ are also required in the specified field.

Registration message variables

The following table gives the of variables used in types of registration messages.

Table 3.   Variables used in different types of registration messages

Type

Supported Variables

Registration SMS, Phone

$REG_LINK$

Registration Email

 

Registration Email, Subject (Phone)

$ENT_NAME$, $USER, $PHONE$

Registration Email, Subject (PDA)

$ENT_NAME$, $USER, $PHONE$

Registration Email, Body(Phone)

$ENT_NAME$, $BRAND_COMPANY_NAME$, $PHONE$, $INAPP_REG_STEPS$, $REG_LINK$

Registration Email, Body(PDA)

$ENT_NAME$, $BRAND_COMPANY_NAME$, $REG_LINK$, $INAPP_REG_STEPS$

Registration Email, Reminder Subject (Phone)

$ENT_NAME$, $USER$, $PHONE$

Registration Email, Reminder Subject (PDA)

$ENT_NAME$, $USER$, $PHONE$

Registration Email, Reminder Body(Phone)

$ENT_NAME$, $BRAND_COMPANY_NAME$, $PHONE$, $INAPP_REG_STEPS$, $REG_LINK$

Registration Email, Reminder Body(PDA)

$ENT_NAME$, $BRAND_COMPANY_NAME$, $REG_LINK$, $INAPP_REG_STEPS$

Values for $INAPP_REG_STEPS$

 

Server

$SERVER_URL$

Username

$USER_ID$

PIN

$PASSCODE$, $PASSCODE_TTL$

Post-Registration Email

 

Post Registration Email, Subject (Phone)

$BRAND_COMPANY_NAME$, $USER$, $PHONE$

Post Registration Email, Subject (PDA)

$BRAND_COMPANY_NAME$, $USER$, $PHONE$

Post Registration Email, Body (Phones)

$PHONES$, $BRAND_COMPANY_NAME$

Variables used inside registration messages

The following table gives the description of variables used inside registration messages.

Table 4.   Description of Variables used inside Registration Messages

Variable

Description

$BRAND_COMPANY_NAME$

An internal variable.

$ENT_NAME$

The name of the organization using Ivanti EPMM to secure the device. See the field Enterprise Name in Settings > System Settings > General > Enterprise.

$INAPP_REG_STEPS$

Combines $SERVER_URL$, the user’s LDAP password, $PASSCODE$, and $USER_ID$.

$PASSCODE$

The registration PIN generated for the device by Ivanti EPMM.

$PASSCODE_TTL$

The number of hours that the registration PIN remains valid. See the field Passcode Expiry in Settings > System Settings > Users & Devices > Registration.

$PHONE$

The phone number associated with the device.

$REG_LINK$

The URL that users access to complete the registration process (i.e., https://server name:port/i for iOS).

 

$SERVER_URL$

The Ivanti EPMM server address used for registration.

$USER$

The name of the user associated with the device, as displayed in Ivanti EPMM.

$USER_ID$

The user ID for the user associated with the device, as defined in the user account on Ivanti EPMM.

Scheduling reminder notifications for completing registration

This feature works on iOS devices only.

Ivanti EPMM detects whether device users have completed registration or not. To ensure that device users complete their registration, set up notifications to remind device users to complete the registration process. It is recommended that a notification is sent to the device user every hour.

Notifications are only possible if the registration is done within the Mobile@Work registration. No reminders are needed for Apple Device Enrollment registrations because the MDM profile is always installed as part of the Apple Device Enrollments.

Procedure 

  1. In the Admin Portal, select Settings > System Settings.
  2. Select iOS > MDM. The MDM page displays.

  3. Select the Send email to user and notification to client if MDM profile is not installed check box.

    The field expands, displaying additional fields.

  4. Select how often to send a reminder email in the every hour field. If the device user registers within 8 minutes of the hour, the device user will not get a reminder until the next hour.
  5. Select the Maximum Number of Emails / Notifications to be sent. A maximum of 24 emails/notifications can be sent within a 24-hour period.
  6. Select Save.

Next steps 

Send the email invitation to device users. See Administrator invites device users to register

Filtering registration messages

In the Registration Templates page, you can filter registration messages by:

  • Language
  • Platform

Procedure 

  1. If you want to restrict the templates displayed based on language, select the preferred language from the Language list.
  2. If you want to restrict the templates displayed based on device platform, select the preferred platform from the Platform list.

Restoring registration messages to default content

To restore a registration message to the default content provided by Ivanti, Inc:

  1. In the Settings > Registration Templates page, select the template you want to restore.
  2. Select Restore to Factory Default.