Email - Create

Emails can be created to communicate important information to recipients. The Create New Email page is separated into the following four sections:

  • Languages
  • Title and Address
  • Recipient and Availability
  • Message

To create an email, go to Admin > Tools > Core Functions > Email Management. Then, click the Add Email icon in the Options column of the email action for which you would like to create an email. This opens the Create New Email page.

Notes Regarding Email Modification

Modifications to an email trigger will not affect any emails that have already been queued to be sent. Only Reminder type emails will enter the email queue.

  • Reminder Type: Before Event - These emails are added to the email queue at the time the object is associated with the user. For example, if a Reminder type email is configured to be sent two weeks before a learning object's due date, then that email is added to the queue when the user registers for the learning object (LO).
  • Reminder Type: After Event - These emails are added to the email queue when the event occurs. For example, if a Reminder type email is configured to be sent two days after a LO's due date, then that email is added to the queue when that LO's due date has passed.

If an email is not a Reminder type email, then the email will not enter the email queue, and it will inherit the email configurations that are set at the time the email is triggered. For example, a Training is Completed - Confirmation type email will automatically be sent when a user completes their LO, and the email that is sent will match the current configurations for the email trigger.

If an object is configured to use Custom Emails, then only emails that are configured specifically for that object are utilized. For example, LOs configured via the Course Catalog to use Custom Emails will only use emails as they are configured for the LO in Course Catalog. Another example is that performance review tasks that are configured in the Review Workflow step to use Custom Emails will only use emails as they are configured for the performance review task in the Review Workflow step. In both examples, administrators must manually enable each email they want to fire in the Custom Emails section.

Language

Field Name Description
Send emails using default language when preferred language is not available

This option is only available if multiple languages are enabled for the portal. When this option is selected, users whose languages are not localized in the template will receive the email in the default language specified in the Change Default Language field. The default language is also displayed within the description of this option. When unchecked, users whose languages are not localized in the template will not receive the email.

Change Default Language

This option is only available if multiple languages are enabled for the portal. This option provides the ability to select the default language for the email template. If the email template is not available in a user's language, the email is displayed in the template's default language. Note: The default language can only be changed when creating or copying an email template.

The default language of the email is displayed next to the Email Title, Subject, and Message fields inside the email template.

Title and Address

Complete the following information in the Title and Address section:

Field Name Description
Email Title Enter a title for the email. If multiple languages are enabled for the portal, a Translate (Globe) icon is available to the right of the Email Title field. Administrators can select this icon to translate the title into other available languages. Note: When editing or copying an email template, this field is always displayed in the email template's default language. To view the field text in a different language, select the Translate icon.
Active Check the Active box to activate the email. If checked, the email becomes live upon clicking Save.
From Address Enter the from address. Note: You must have the appropriate permission to edit this field.
  • A default address can be configured for the From Address field through a backend setting which pre-populates all new emails with the same From address. To enable this functionality, contact Global Product Support.
  • Email addresses must be entered in a valid email address format.
Reply-To-Address Enter the address to which recipients can reply to the email. Email addresses must be entered in a valid email address format.
Type

Select an email type from the Type drop-down. Some types may not be available for the email trigger. The following types may be available:

  • Confirmation - This email type confirms that an action has taken place, such as registration or cancellation. The Confirmation, Notification, and Promotional email types are used for organizational purposes so that administrators can categorize email triggers and more quickly locate certain email triggers when searching from the Email Management page.
  • Notification - This email type notifies the recipient that something has occurred, such as when an approver makes a training decision. The Confirmation, Notification, and Promotional email types are used for organizational purposes so that administrators can categorize email triggers and more quickly locate certain email triggers when searching from the Email Management page.
  • Promotional - This email type can be used to advertise or promote some message or functionality. For example, the Training is Completed email trigger could be configured to promote an upcoming conference or training seminar when a completes a training. The Confirmation, Notification, and Promotional email types are used for organizational purposes so that administrators can categorize email triggers and more quickly locate certain email triggers when searching from the Email Management page.
  • Reminder - This email type serves as a reminder before or after any action, providing extra notice of upcoming events or deadlines. When "Reminder" is selected, additional options appear that allow you to determine the amount of time before or after the action to send a reminder. Emails that typically work as a reminder are those with predefined dates. Some examples include: ILT Start Date, Training is Due, Certification Period Expiration, and task reminder emails.
    • Use Case: An administrator would like a reminder email to be sent the day before a training item is due. She selects "Reminder" in the Type field. She enters "1" in the days field and selects the Before Event option. These settings will trigger the email to be sent one day before the training is due.

To configure the settings for a Reminder type email:

  1. Select "Reminder" from the Type field. This enables the reminder options to appear.
  2. Enter a number of days in the days field to define the number of days before or after the event occurs that the email is triggered. This refers to calendar days.
  3. Enter a number of days in the Hours field to define the number of hours before or after the event occurs that the email is triggered.
  4. Enter a number of days in the mins field to define the number of minutes before or after the event occurs that the email is triggered.
  5. Select the Before Event option to trigger the email the selected number of days/hours/minutes before the event occurs.
  6. Select the After Event option to trigger the email the selected number of days/hours/minutes after the event occurs.

Note: The word "Event" for reminder emails does not refer specifically to ILT events. The word refers to the action that triggers the reminder email to be sent.

Calendar Options

Available for the ILT Session Register email trigger, this option allows the email creator to specify what sort of calendar invitation will be sent to users. The following options are available:

  • Meeting Invite
  • Calendar Attachment
  • None
Email Format

For the ILT Session Register email trigger, Email Format options are available. The administrator can choose between the following two radio button options:

  • Outlook - Select this option to ensure the email meeting invitation will be formatted correctly for Outlook.
  • Other - Select this option to ensure the email meeting invitation will be formatted correctly for other email providers, such as Gmail, Yahoo, and others. This option is selected by default.

Recipient and Availability

Complete the following information in the Recipient and Availability section:

Field Name Description
Send To

Select either a specific user to receive the email, or select from the drop-down a list of relevant job roles. Depending on what type of email you previously chose, the job role drop down may populate with different fields. Once you have selected a user or a role, you must click the Add button.

Cc

Select either a specific user or select a recipient from the drop-down list. Once you have selected a user or a role, you must click the Add button. Note: The users that are cc'd are not included in the email log file. Only the users in the Send To field appear in the email log file.

Note: The Cc field does not observe availability rules. To enforce availability rules, recipients should be added to the Send To field.

  • Users or groups already selected in the Send To field cannot be added to the Cc field.
  • Adding recipients to the Cc field will add these users to the Cc field of each Email that is sent.
  • If a group is listed in the Cc field, a separate Email is sent to every user in that group. Only one user from that group will be cc'd on each Email sent out; cc'ing a group does not mean that one Email will be sent with everybody in that group listed in the Cc field.
  • The system will link the relationship between the user in the Send To and the users in the Cc field. For example, if the Training Request Approver, Cost Center Approver, User's Manager are all related to the Student. If User's Manager is listed in the Sent To field and Student and Cost Center Approver are listed in the Cc field, then one Email will be sent out for each user's manager. Each Email sent to a user's manager will have the student and the student's cost center approver in the Cc field.
  • An Email cannot be sent out that does not have a user in the Send To field. If the user does not have a manager, then no Email will be sent.
  • If two groups are listed in the Send To field, then a separate email is sent to each user in both groups. The users in the Cc field are cc'd on both of those Emails. For example, if User's Manager and Student are listed in the Send To field and Cost Center Approver is listed in the Cc field, then an email will be sent to every student's manager and every student. The Cost Center Approver of the student will be cc'd on the email to the manager and on the email to the student.
Availability

Choose to restrict the availability of the email to a specific OU.

Message

Complete the following information in the Message section:

Field Name Description
Tags Click the Display a list of tags link to view tags available to use in the Subject or Message fields. The tags that are available to include are dependent upon the email type selected. When the email is sent, the tags are replaced with actual information. The tags must be entered exactly as they are listed, and they are case sensitive. For example, to address the email to the trainee (the person who must take the training), enter: "Dear TRAINEE.FIRST.NAME TRAINEE.LAST.NAME,". The field would be replaced with the relevant information.
Subject Enter a subject for the email message. The subject is displayed to the recipient. Tags can be used in this field. If multiple languages are enabled for the portal, a Translate (Globe) icon is available to the right of the Subject field. Administrators can select this icon to translate the subject into other available languages. Note: When editing or copying an email template, this field is always displayed in the email template's default language. To view the field text in a different language, select the Translate icon.
Message

Enter the message for recipient. The following options are available for configuring the message:

  • Tags - Tags may be used in this field. To view a list of available tags, click the Display a list of tags link.
  • WYSIWYG Tool - The WYSIWYG (What You See Is What You Get) tool provides configuration tools, such as images, fonts, colors, formatting, and tables. There is also a Copy from Word feature that enables administrators to import from Microsoft Word, preserving the formatting used in the Word document. HTML code can also be used. Only certain HTML tags will be rendered. All other tags will not be rendered and the tags will display as text. See the Whitelisted Customizable Elements topic in Online Help for more information.
    • The top toolbar of the WYSIWYG tool contains configuration options. The bottom toolbar is used to switch from design to HTML mode, as well as preview the email.
    • Note: Documents cannot be deleted from the Document Manager once they are added. This is because the document may be in use in emails that have already been sent to users. This prevents errors with document links after emails are sent.
    • See the WYSIWYG Tool Considerations below for important considerations when using the WYSIWYG tool.

When configuring emails, a message appears in red at the top of the page, alerting you that files uploaded through the Image or Document Manager are stored on a publicly accessible server. The maximum file size is 3MB.

If multiple languages are enabled for the portal, a Language drop-down is available above the Message field. Administrators can select a language from this drop-down to translate the email message into other available languages. Note: When editing or copying an email template, this field is always displayed in the email template's default language. To view the field text in a different language, select the appropriate language from the Language drop-down menu.

Once all fields have been completed, click Save.

Modification History

A Modification History section is available when editing an email template. This section captures each time an email template is created or modified. This section displays the name of the user who created or modified the template and the date and time at which this occurred.

Conditions

Conditions can be set for an email trigger so that the email is only triggered when certain conditions are met. For example, the Session Transcript Status Changed by Roster Submission email grigger can be configured so that the email is only triggered if the student's LO is in a specific Transcript status, such as Pending Evaluation or No Show.

  • STUDENT.TRANSCRIPT.STATUS==TRANSCRIPT.STATUS.[Enter the desired status here (e.g., NOSHOW, PENDINGEVALUATION)]

The Conditions section is only available if the email trigger can utilize conditions.

Impacts of Localization on Critical Emails

It is important to note that an email may not be sent to a recipient depending on the configuration and localization of the email template. The behavior of the email trigger depends on the configuration of the email template.

  • If the email template is localized in the recipient's language, then the system sends the email in this language.
  • If the email template is not localized in the recipient's language, then the behavior depends on whether the Send emails using default language when preferred language is not available option is selected.
    • If this option is selected, then the system sends the email in the template's default language.
    • If this option is not selected, then the email is not sent to the recipient.

While this is important for all emails, it is extra important to keep this in mind for the following email triggers:

  • Admin Password Change
  • Forget Password
  • Forget Username
  • Login Message Email
  • User Password Change

WYSIWYG Tool Considerations

The following are important considerations when using the WYSIWYG tool:

  • The Telerik editor demo website (http://demos.telerik.com/aspnet-ajax/editor/examples/default/defaultcs.aspx) is provided for reference purposes only. The editor available in Email Administration is a different version than the demo editor on the website, and there may be features that work differently or are missing. Hence, all features of the editor may not function in the same way as demonstrated in the demo editor.
  • Editor Limitations:
    • Microsoft Outlook does not display media files embedded in the editor.
    • The paste feature may not paste some HTML content when done in the Design mode, for example "iframes." This can be done via HTML mode instead.
    • Some media file codes are taken in by the editor but may not display in the emails received by the user.
    • HTM files successfully uploaded via the Document Manager in the editor may not be displayed accurately in Outlook.
    • Preview may not be identical to how a specific email client renders the email.
    • "Paste" may not always paste the entire HTML content in design mode.
    • "Select All" does not select all the content in design mode.
  • Known Browser Limitations:
    • Firefox
      • The remove alignment button is not compatible with Firefox.
      • "Select All" does not select the horizontal lines when the editor is used in Firefox.
      • The Add button within Document Manager does not allow for multiple selection of documents in Internet Explorer and Firefox.
      • The "Remove Alignment" feature may not work as expected in Firefox.
    • Internet Explorer
      • In Internet Explorer 8, the HTM file that is uploaded may show as distorted in design mode.
      • In Internet Explorer, when a user uploads a HTM file using the Template Manager while setting up an email, the uploaded HTM file may have a slightly different layout and formatting.
      • The Add button within Document Manager does not allow for multiple selection of documents in Internet Explorer and Firefox.
  • CSS Limitations: Some features such as tables, CSS classes, and styles may not be displayed as expected in certain email programs. As a best practice, please avoid the use of the CSS options.
    • The CSS class is not applied for the Document Manager if they are nested CSS classes.
    • The following reference link provides details about which email clients support which type of CSS: http://www.campaignmonitor.com/css/. Users can view the email using a browser to show the entire contents of the email properly.
  • Portal Security - If you have not requested to allow HTML tags, CSS, JavaScript, etc on your portal, you may see that some parts of the system no longer allow unsafe elements. You can opt out of this security measure by logging a case with Global Product Support (GPS) to enable bypass XSS validation. By bypassing this validation, Cornerstone will require you to agree to the security risk exposure this may cause. For more details on supported customizable elements, please see the Whitelisted Customizable Elements topic in Online Help.

Note: A detailed demo of all features in the editor is available at http://demos.telerik.com/aspnet-ajax/editor/examples/default/defaultcs.aspx. Descriptions of each option in the toolbar are provided at http://demos.telerik.com/aspnet-ajax/editor/examples/default/defaultcs.aspx.

Email Email Email Email Email Email Email Email Email Email Email Email Email Email Email

Trigger Trigger Trigger Trigger Trigger Trigger Trigger Trigger Trigger

Outlook Outlook Outlook Outlook Outlook Outlook Outlook Outlook Outlook Outlook Outlook Outlook Outlook Outlook Outlook