Every event in 25Live has a fixed location within your cabinet and folder framework. It's important to understand how this framework is structured so that you can handle event creation effectively and avoid import errors effectively. Please see our article on Best Practices: Cabinets, Folders, and Event Types for more information on recommended cabinets and folders.
If you're having issues with event routing, you might encounter one of the following behaviors:
- Express Scheduling events fail to save
- Choosing a Heading When Saving an Event
- Cannot route import errors
Note that events with a state of Draft are not saved to a folder. The following only applies to events with the state 'Tentative' or 'Confirmed'.
When you create a new event it is automatically placed into a folder based on several criteria. If there is more than one valid folder for the event to be saved, you will be prompted to choose a folder/heading for that event; if there are no valid locations then the event will be saved as a draft, and you will be given a chance to edit its details so that it can be saved to a folder as Tentative or Confirmed later.
If you are importing the event from your SIS rather than creating it manually, then instead you will receive an import error and nothing will be saved. You will need to fix your cabinets or fix your class data so that there is exactly one possible location to import the class.
In both cases, you can avoid trouble by understanding the criteria by which an event is routed into a folder:
- Event Type (must match a valid folder type)
- Object Level Security (user must have permission to save events to folders)
- Dates (must be fully contained within the folder's range)
- Primary Organization (events will route to folders associated with their organization, if possible)
- Event Categories (events will route to folders with matching event categories, if possible)
CollegeNET's Best Practices for cabinets and folders are designed to minimize complications based on these criteria and ensure successful routing.
|The first factor used in routing events is Event Type. An event is always routed to a folder that is of the correct type. Using the example framework below, if you save an event with the type "Conference" then it will route into a folder with the type "Event Group". It is not possible to create Conference events inside a folder of any other type.|
If you have OLS enabled, then you may only save events to folders which your security group has Create Events? = Yes OLS permissions. Folders where you do not have this permission, or folders that you cannot see at all due to security restrictions, are unavailable for routing. If you are importing classes from your SIS, make sure that your Interface user has adequate permissions to save events to all relevant folders. (CollegeNET strongly recommends putting the Interface user in a System Admin group to avoid security concerns.)
If there is no folder where an event can be saved, then section imports will fail with a Cannot route event, no matching rules error.
Every occurrence of the event must fall completely within the date range specified by the cabinet and folder. In Manage Folders area of the 25Live Administration Utility, a quick way to ensure that all your folders have the correct date range is to verify the range on the parent cabinet, then select all the folders in the cabinet and click on 'Inherit'. Verify the folder selection and choose 'Inherit data to folder'. This will set all folders to the same range.
If there is no cabinet with the appropriate date range, then section imports will fail with a Cannot route event, no matching rules error. If there are multiple cabinets with a date range that could fit the section, then the import may fail with a Cannot route event, no unique rule OR no unique match error. One way to resolve that is by setting up event categories to distinguish between the two cabinets. (See below for more information.)
When applicable, an event will route into a folder that has its Primary Organization associated with that folder. For academic cabinets, this is usually one or two organizations per folder, representing different academic subjects or departments. For special event cabinets, a single folder might have dozens of listed organizations, representing student groups, external providers, etc.
If there is no folder with a matching organization, or there are several valid folders with the same organization, you can still manually save an event by choosing a heading when prompted. However, the automatic import by the Series25-SIS Interface will not be able to resolve this ambiguity, resulting in a Cannot route event, no unique rule OR no unique match error.
Primary Organization on Folders
When editing a folder, you have the option to specify one organization as the "primary" organization for that folder. An event will route to a folder where its organization is the "primary" organization if available, treating this as higher priority than a folder where the organization is added but not designated "primary".
This is an option that is typically only used when you have multiple cabinets have overlapping dates, such as two simultaneous academic terms. Event Categories can be used to distinguish between cabinets/folders. (See here for instructions on how to configure this via the Series25-SIS Interface.)
Like Primary Organizations, events will route to a folder with a matching Event Category, if available. If there is no matching folder (or too many folders) then the event may not import due to a Cannot route event, no unique rule OR no unique match error.