Skip to content

Notification Settings in HyLabs

HyLabs supports e-mail notifications to all registered users, provided SMTP servers are configured correctly in HyWorks and Notifications Settings are configured correctly in HyLabs Portal. Detailed information about notification is given in this section.

Notification Settings

Notification Settings allows the administrator to define e-mail alert configurations for different events.

  1. Self-study Reservations: Defining the self-study events on which e-mail notifications will be sent and what type of HyLabs users should receive notifications. The following events can be configured:

    1. When created: When a reservation is made in HyLabs.

    2. Before Start: X minutes before the self-study reservation starts, send alerts to the participant, creator, and/or the admin.

    3. When Ready: When the self-study reservation is ready, send alerts to the participant, creator, and/or admin.

    4. When Modified: When the self-study reservation is modified, send alerts to the participant, creator and admin.

    5. When Cancelled: When a self-study reservation is canceled, send alerts to the participant, creator or admin.

    6. When Failed: When self-study reservation fails, send alerts to the participant in charge and admin.

    7. When Deleted: When a user deletes the self-study reservations, send alerts to the participant, creator and admin.

    8. When Ended: When the self-study reservation gets ended, send alerts to the participant, creator and admin.

    9. When Expirted: When the self-study reservation gets expired, send alerts to the participant, creator and admin. !!! note

      If configuration "SMTP email sender" has been updated from HyWorks Controller Management Console > SMTP Settings, the RMS service has to be restarted to make use of the updated configuration. Until restarted, HyLabs reservation notifications will continue to come from the previous SMTP Email sender.

  2. Course Reservations: Defining the course reservation events on which e-mail notifications will be sent and what type of HyLabs users should receive notifications. The following events can be configured:

    1. Send Email [N] minutes before reservation starts.

    2. Send Email [N] days before Reservation expires.

    3. Mail Events:

      1. When Created: When a reservation is created, send alerts to incharges, assistants, participants, administrators, and creators.

      2. Before Start: X minutes before the course reservation starts, send alerts to the incharges, assistants, participants, administrator, and creator.

      3. When Ready: When course reservations are ready, send alerts to incharges, assistants, participants, administrators, and creators.

      4. When Modified: When course reservation is modified, send alerts to incharges, assistants, participants, administrators, and creators.

      5. When Cancelled: When a course reservation is canceled, send alerts to incharges, assistants, participants, administrators, and creators.

      6. When Failed: When course reservation fails, send alerts to incharges, assistants, participants, administrators, and creators.

      7. When deleted: When course reservation is deleted from HyLabs.

      8. Befor Expiry: Send notifications before x days of reservation expiry to the selected audience (incharges, participants, assistants, admins, creators)

      9. When Ended: Send notifications on reservation schedule end to the selected audience (incharges, participants, assistants, admins, creators).

      10. When Expired: Send notifications on reservation expiry to the selected audience (incharges, participants, assistants, admins, creators).

  1. CSV Import Settings: Defining the CSV Import events (Pass/Fail) on which e-mail notifications will be sent to the configured administrator’s e-mail IDs.

  2. E-mail Address: E-mail addresses for CSV Import and Reservations are to be configured here.

Email Templates in HyLabs

HyLabs supports email notifications for all HyLabs events to selected user types as described in previous sections. For notifications HyWorks uses pre-defined templates. In HyWorks v4.0, the email templates can now be customized from HyLabs portal itself, against the previous mechanisms of management of file based email templates from HyLabs/ HyWorks installation directory.

By default HyLabs will be using the file based templates in HyLabs/ HyWorks installation directory. But the HyLabs portal email templates can be enabled using following steps.

Enabling Email template settings

  1. Login as HyLabs admin into HyLabs portal

  2. On HyLabs portal Navigate to HyLabs configurations > Default reservation settings

  3. Find the option Use Email Templates and enable it and save the settings.

  4. HyLabs will now start using templates as available in the HyLabs portal.

In the next section, details of HyLabs Portal Email Templates will be provided.

Email Templates from HyLabs Portal (v4.0)

A new page is introduced with HyWorks controller v4.0 where admin can update templates through HyLabs portal itself

HyLabs portal > HyLabs Configurations > Email Template Settings

The email recipient users can be kept into following two categories

  • HyLabs Admin users: Includes Admin, Incharge, Assistants and creators role associated with the reservation.

  • HyLabs Participants: Users which are added as Participants in the reservation.

There are two ways to use the email templates:

  1. Use System pre-defined templates

    1. Following system defined templates are available which can be modified as per requirement.
    Template Name Reservation Type Target Users
    Default Course Template for HyLabs Admin Users Course HyLabs admin type users
    Default Course Template for HyLabs Participants Course HyLabs participant type users
    Default Self-Study Template for HyLabs Admin Users Self-study HyLabs admin type users
    Default Self-Study Template for HyLabs Participants Self-study HyLabs participant type users

  2. Create a template for specific event and role.

Customizing System defined Email Templates

  1. Login as HyLabs admin into HyLabs portal

  2. On HyLabs portal Navigate to HyLabs configurations > Email template settings page

  3. List of System defined template will be listed as below.

    • Default Course Template for HyLabs Admin Users: Default course reservation template being used for Admins, incharges, assistants, creators.

    • Default Course Template for HyLabs Participants: Default course reservation template being used for participants of the reservations.

    • Default Self-Study Template for HyLabs Admin Users: Default self-study and course self-study reservation template being used for Admins, Creators.

    • Default Self-study Template for HyLabs Participants: Default self-study and course self-study reservation template being used for participants.

  4. Select any template and click Edit, Edit template settings wizard will get opened.

  5. Admin can customize the email content sent to users for course reservation events using the keywords listed below. Details of the Keywords:

    {Name}: Full name of the user receiving the email. {Addition_Info}: Any additional notes or instructions related to the reservation. {Action}: The type of action taken (e.g., confirmed, cancelled, rescheduled). {Reservation_Name}: The name of the reservation. {Course_Name}: The name of the course. {Course_Code}: Unique code or identifier for the course. {Class_Name}: Name of the specific class/session. {Next_Start_DateTime}: Start date and time of the upcoming reservation. {Next_End_DateTime}: End date and time of the upcoming reservation.

  6. Admin can use any keyword from the above and rearrange them to change the email content as per your customization needs. A separate text window will be provided to rearrange, format the settings as per customization needs.

  7. Click on Save. After this when next reservation event users will get notified as per customized templates.

Important

As there is one email template for each type of reservation, all reservations will use the same modified template and thus system defined templates should be modified with caution.

Manually adding email template for specific event

If it requires to have specific email template for specific event, then the below provided steps can be used to

  1. Login as HyLabs admin into HyLabs portal.

  2. On HyLabs portal Navigate to HyLabs configurations > Email template settings page > Click on Add.

  3. Wizard to add new email template will get invoked.

    1. Name: Provide a distinguish name for template as per the event

    2. Email recipient type: Select option for which we want to send the notifications

      • HyLabs Admin users: Includes Admin, Incharge, Assistants and creators role associated with the reservation

      • HyLabs Participants: Users which are added as Participants in the reservation

    3. Template for: Select option Course If the template os for course reservation and select option self-study If template is for self-study or course self-study.

    4. Notification trigger: Select the event type from list of triggers.

      Important

      Admin can create one template per trigger per email recipient type and reservation type.

    5. Customize or rearrange the keyword templates as per need in the provided textbox and Click on Save.

    6. Next reservation deployment will start getting updated customized notifications as per the configurations.

Email Template Usage Fallback Sequence

  1. Use Email templates: Disabled (Configurable from Default reservation settings)

  2. Use the notification settings from templates from HyLabs/HyWorks installation directory as earlier.

  3. Use Email templates: Enabled (Configurable from Default reservation setting)

    • Priority# 1: Event specific template (if created)

    • Priority# 2: Default templates on HyLabs portal.

Email Notification Examples

Below is the screenshot of course reservation email notification on create event based on the default template for course reservation for participants.

File Based Email Templates (HyLabs/HyWorks Installation Directory)

Every notification email from HyLabs is created using a pre-defined template. These templates are generated automatically whenever a relevant operation (CSV Import, Self-study reservation, or course reservation) is initiated. Each template is stored in a different file, which can be edited by logging into the HyWorks controller using RDP or console access.

The E-mail templates are default kept with HyWorks Controller Service and HyLabs Service in the following folders:

  • HyLabs Service: C:\Program Files (x86)\Accops\HyWorks\RMSService\EmailTemplate

  • Controller Service: C:\Program Files (x86)\Accops\HyWorks\Service\EmailTemplate

Keywords in Email Templates

Standard keywords can be embedded in each template to include details like course name, schedule, etc. Following are the standard keywords that can be used in email templates:

  1. {Reservation_Name}: Name of reservation

  2. {Course_Name}: Course Name

  3. {Next_Start_DateTime}: Next start time.

  4. {Next_End_DateTime}: Next end time

  5. {Action}: Type of change

Type of Email Templates

Course Email

File location: C:\Program Files (x86)\Accops\HyWorks\Service\EmailTemplate\Course\Course This email template is used when:

  1. A Reservation is created.

  2. A Reservation has been updated, and its schedule has been changed.

  3. A Reservation has been canceled.

  4. A Reservation fails during deployment.

  5. A Reservation is deleted.

CSV Import

File location: C:\Program Files (x86)\Accops\HyWorks\Service\EmailTemplate\CSV\CSVImport This email template is used to send the result of a CSV import. Once the import is completed, the result, including the number of records imported or failed, is sent via this email.

Self-study

File location: C:\Program Files (x86)\Accops\HyWorks\Service\EmailTemplate\SelfStudy\SelfStudy This email template is used when emailing participants about their self-study reservations.

Customizing Email Contents

As email templates are located at both HyWorks controller and HyLabs Service, an administrator can modify them from any of the below locations, but the updated template must also be copied to another location.

Default location of Email Templates

  • HyLabs Service: C:\Program Files (x86)\Accops\HyWorks\RMSService\EmailTemplate

  • Controller Service: C:\Program Files (x86)\Accops\HyWorks\Service\EmailTemplate

To update Email Templates for customized E-mail notifications, follow the below steps:

  1. Log in to the HyWorks controller using RDP/ Console access.

  2. Delete existing email template files.

  3. Create new files and place them in appropriate folders as original files. Please save the files in the same encoding format as the HyWorks email encoding setting.

  4. Make sure to set the correct encoding from the HyWorks management console.

  5. Repeat steps 1-3 for the secondary HyWorks controller also.

To restore the original email template files, delete the files from the location. HyWorks will automatically create default email template files when creating a new reservation.

Note

If HyWorks Controller and HyLabs Services are running in HA on different Windows Servers, then Email Templates must be copied on all Controller and HyLabs Servers.

Customizing Email Format

Encoding standards tell the web browser or email application how to interpret the text characters in your HTML or the body of the email. The default Email format is:

  • Email Type: HTML

  • Email Encoding: The encoding format is read from the OS settings.

To determine the appropriate format used by your email server, look at the char-set attribute in the email header content-type field.

Date: Wed, 16 Mar 2018 14:12:33 -0820
To: test@accops.com
From: testfrom@accops.com
Subject: Test
Message-ID: e0irfueknwie94837dndmfkf@www.accops.com
X-Priority: 2
X-Mailer: office365
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Content-Type: text/html; charset="UTF-8"

To configure email format and encoding, please follow these steps: 1. On HyWorks Controller Management Console > Settings > General > Advanced Config

  1. Find the option "HyLabs Email HTML Body" and set its value to false to use plain text email format.

  2. Find the option "HyLabs Email Encoding Type" and set the encoding type of the email. The various options are provided below:

    1. UTF-8 (Most Recommended)

    2. ISO-8859-1

    3. ISO-2022-JP (Only Japanese users)

    4. Shift_JIS (Only Japanese users)

    5. EUC-JP (Only Japanese users)

  3. Click Update Click to save the advanced configurations.

  4. The settings are automatically synced with the secondary controller, so there is no need to make the same settings on the secondary controller. Please note that the email template files must also be updated (or copied) manually on the secondary controller.

Important

Make sure the email template file files are stored in the same encoding format as specified in the Email Encoding setting. It is advised to use UTF-8 as email encoding, create the email template files in Notepad, and store them with UTF-8 encoding using the save-as option in Notepad.