Page tree
Skip to end of metadata
Go to start of metadata

Security Note: These Settings Require Administrative Access

To access the System Settings views, your 25Live user must have administrative security permissions (be in the -1 security group). If you would like any of the described settings changed for your instance of 25Live, contact your 25Live administrator.

Note: This Feature Was Previously a Part of BPEs

This feature is a partial replacement for the features that were included in business process extensions (BPEs), but with improved functionality and an easier, more convenient interface.

Event Save Email allows 25Live administrators to set up scenarios outlining the rules under which custom emails will be sent. Once you specify all your desired parameters, you can choose or create email templates, including report attachments. One or more emails can be triggered upon event save, either when creating or editing.

For example, you can create the following complex email triggers with just one scenario and two templates.

If:

  • A member of the Requestor - Faculty and Staff Edits an event 
  • With Event Type Meeting
  • And the Event State is Confirmed

Then:

  • Send the email template with the occurrence list with locations and resources
  • To the Scheduler
  • And email the Requestor the Confirmation Report
Scenario ExampleTemplates Used

Event Save Email scenario section

First template email example Second template email example

Images: Example of the scenario and the template used for it.

Best Practices: Converting Old Configuration Utility Emails

In our Customer Resources knowledgebase, we have outlined the best practices for Replacing the Emails from the Configuration Utility (Series25 Customer Resources login required).

How to Create a Scenario

1. Go to the System Settings View, and Access the Event Save Email Section

The More menu in the top navigation bar
Image: The More menu in the top navigation bar has a link to the System Settings view.

After logging into 25Live as an administrator or user with permissions to access System Settings (-1), open the More menu in the top navigation bar.

System Settings link in More menu
Image: The System Settings link is in the More menu.

Use the menu link to go to the System Settings view, then tap or click on Event Save Email to reveal the section.

Event Save Email link
Image: Tap or click on Event Save Email to access the scenario and template settings.

2. Create a Scenario

Within the Event Save Email section, there are links to Edit Scenario or Create Scenario. Start by providing a unique name (maximum of 40 characters, one blank name is allowed in your library of scenarios). This name will not display in the email. The name is only for managing and editing the scenario.

3. Activate Scenario and Choose Triggering Actions

Creating Scenario
Image: Scenarios can be marked active or inactive to save for later and can trigger upon creation, editing, or both.

Set the Active toggle to Yes. An active scenario will trigger an email if it matches the actions and criteria for an event.

Next, choose when you want to trigger the sending email(s) with the Send Email On choices. Choose from:

Tip: Allowing Silent Save in Event Configurations to Reduce Emails


Image: Setting the "Allow Silent Save" option in your event configuration(s) can prevent extra emails. 

 If you set your scenario to Send Email On "Event Edit," then you should consider using the "Allow Silent Save" option in Event Configurations in order to prevent too many emails going out unnecessarily.


Last, you can choose how to Send Email From with options to have the email trigger from actions in the:

4. Complete Criteria Fields

Tip: Save Anytime

Use the Save Scenario button at any time to save a scenario that you want to come back to edit later in System Settings > Event Save Email > Edit Scenario.

Resources selector in criteria
Image: Criteria fields use standard 25Live search and selection controls, such as this search for Resources containing "chair."

Optional Event Save Email scenario criteria include:

  • Event States (includes inline editing from Event Details)
    • Note: This choice corresponds to the Event State saved after creation or edit.
  • Event Types
  • Location(s) event was requested for
  • Resource(s) event was requested with
  • Primary Organization
  • Security Group of the user that will be taking the action when the email is triggered

When Will the Scenario Trigger an Email?

If no top-level field (Event State, Event Type, Location, Resource, etc.) is selected, that field will not limit the rules and will match for ANY value. A single criterion for a field will also match.

If multiple criteria are selected within a field (such as specific locations within the Locations field), then AT LEAST ONE of the choices need to be met for the email to trigger.

Example Criteria and How They Will Process

Example 1: No Event Type, One Location, Multiple Resources

Example of selections
Image: In this example, the email(s) will trigger no matter which Event Type, only for the specified location, and for any of the two resources.

Example 2: No Resources, No Organizations, Multiple Security Groups

Example scenario criteria
Image: In this example, the email(s) will trigger for any Primary Organization (because none were specified).

Example 3: Multiple Selections in All Types of Fields

Example criteria
Image: In this example, the email(s) will trigger for Confirmed and Tentative Event States that are Tutoring or Study Session Event Types in the Student Center (MSC).

Example 4: Email Send Based On Location Approval in Tasks

Example of scenario based on tasks
Image: When this task was completed to approve the location, an email scenario will be triggered.

Note: Preferences Can Be Included

When adding Locations and Resources to be a part of the criteria for a scenario, each section also has a No/Yes toggle available to Include Location Preferences and/or to Include Resource Preferences.

5. Choose or Create a New Email Template

If you already have email templates created in your library, use the Add Templates button to check which template(s) you want to send using the criteria in this scenario. When a scenario is triggered with matching rules, 25Live will send all emails specified in the Templates section.

Adding template to scenario
Image: The selected email template will send if the rules in the scenario match.

Tip: A Scenario Can Trigger Multiple Emails

If you wish to send more than one email using the rules in your scenario, you have that option. For example, you could send one email template to the event requestor and a different template to the event scheduler.

If you don't have any email templates in your library, use the Create New Template button. Specific templates may be restricted by security group in the Series25 Group Administration tool.

Read Details About Creating and Editing Templates

If you need to edit an existing email template, go back to System Settings > Event Save Email > Edit Template.

Selecting template to edit
Image: Edit an existing template by going to the Edit Template section.

Note: For Experts, Advanced Editing Is Also Available With Code View

If you have advanced skills and wish to work in JavaScript using the Code View:

  • The Convert to Code View button will take any form input and convert it to JavaScript, overwriting any customized code already entered in code view.
  • Using the Switch to Code View button will open the Code View without overwriting any code already entered.

Two versions of any scenario or template can exist at any time, the Form View and the Code View. The system will use the version that was last saved.

If you wish to go back, a Back to Form View button will be available.

Code View is available for technical experts who know how to write code. Troubleshooting these customizations in this advanced mode is beyond the scope of our technical support.

6. Optionally Preview Your Scenario and Template(s)

Note: Previews Need Appropriate Actions

Because you will use an existing (not new) event in the preview, it will only trigger for scenarios with the Send Email On action set to Event Edit or Both.

Preview section
Image: The Preview option requires an Event Reference ID.

25Live gives you the opportunity to preview your scenario using an internal Event Reference ID, which is in the format of:

 Four-digit yearDashSix uppercase letters
2021-AAZHZA

When you preview from within a scenario, 25Live will first check if the event meets the criteria and then display any email(s) with their content that would be sent.

Preview example
Image: Example of an Event Save Email scenario preview.


Tip: How to Find an Event Reference

Event details example
Image: You can find an event reference ID in the Event Details View.

7. Save the Scenario

Use the Save Scenario button to save your completed Event Save Email Scenario.

From here, you can also delete the scenario if necessary.

Warning: Saving a Blank Scenario

If you save a blank scenario (one with no triggering actions or criteria), it will fire upon every event save and edit. While you could use this as a feature to send a standard success message, please ensure you don't save a blank scenario accidentally without a planned expectation.


Editing or Deleting a Scenario


Image: Choose an existing scenario, then editing a scenario uses the same form interface and fields that are used to create a scenario.

You can access your library of Event Save Email scenarios in System Settings > Event Save Email > Edit Scenario. Choose a scenario to edit from the dropdown menu. Your previously created scenarios are in the dropdown menu displayed in alphabetical order. Then, follow the same steps as used in How to Create a Scenario section above.

From here, you can also delete the scenario using the Delete Scenario button.



Copyright © 2021 CollegeNET, Inc.  Note: This information is for CollegeNET Series25 customer use only.
Series25 Customer Resources • Terms of Use •  Privacy Policy • Learn About Series25 • Contact CollegeNET