UniTime 4.8 Release Notes 4.8.224 Sun, 24 May 2026 Suggestions Compute and populate conflicting constraints when a placement with conflicts is selected from the Suggestions table in the Placements mode. Fixed a problem when an invalid placement is selected for the 2nd or later class from the Selected Assignment, which was causing conflicting placements to get unassigned. Subject Areas: Delete Fixed a Hibernate exception (ObjectDeletedException) when deleting a subject area that has some not-offered courses. Caused by the latest Hibernate upgrade (to version 6.6). Student & Instructor Name Format Fixed an exception that was thrown when a first name or a last name is just a single space for name formats using initials. Add/Edit Subject Area List all available departments (excluding externally managed ones) for a subject area. Instead of those that are being used (have a manager, a room, or another subject). Export: Encrypted URLs Fixed a potential vulnerability problem with encrypted export URLs, allowing an attacker to inject a wrong user ID. It is now possible to specify which exporters allow encrypted URL authorizations (by default, only the iCalendar exports are allowed). This can be configured using the unitime.export.authorizeEncodedQueries application property. 4.8.219 Mon, 27 Oct 2025 Edit Course Offering Fixed a Hibernate error thrown when a course that has been just added in a cross-list is being edited. Caused by the latest Hibernate upgrade (to version 6.6). Class Assignment Fixed a potential Hibernate exception (TransientObjectException) when making a larger change. Caused by the latest Hibernate upgrade (to version 6.6). Course Offering XML Import Fixed a Hibernate exception when importing exams with instructors. Caused by the latest Hibernate upgrade (to version 6.6). 4.8.216 Tue, 9 Sep 2025 Curricula: Add/Edit Curriculum Added an ability to customize the course selection box width (unitime.curricula.courseWidth property, defaults to 130px). The setting gets also used to set the course selection box width on the Add/Edit Reservation page. Instructional Offering Cross Lists Fixed a Hibernate exception when removing/addding a course from/to a cross-list, if the course is listed as demand course on some other course of the cross-list. Caused by the latest Hibernate upgrade (to version 6.6). Multiple Class Setup Fixed a Hibernate exception when removing multiple classes assigned to the same instructor. Caused by the latest Hibernate upgrade (to version 6.6). 4.8.213 Sat, 9 Aug 2025 Instructional Offering Cross Lists Fixed a Hibernate exception when removing a course from a cross-list that has some advisor course recommendations. Likely caused by the latest Hibernate upgrade (to version 6.6). Multiple Class Setup Fixed a Hibernate exception that is sometimes thrown when deleting two or more classes in a parent-child relation. Likely caused by the latest Hibernate upgrade (to version 6.6). Authentication & Authorization: User Name Added an ability to use the student's name from the most recent applicable active academic session as the user name. Enable by setting unitime.authorization.preferStudentName to true (defaults to false). Added an ability to customize user name format by setting unitime.authorization.userNameFormat, defaults to last-first-middle. Data Exchange: Course Offering XML Import Removed a Hibernate session refresh that was occasionally causing the import to fail after the Hibernate upgrade to version 6.6. Student Groups, Solver Parameters Corrected the Export CSV/PDF when the filter is set to All. Roll Forward Session: Roll Exam Configuration Data Fixed the QueryTypeMismatchException when checking for existing examination period. 4.8.204 Thu, 26 Jun 2025 Suggestions, Instructor Survey: Maximize Added an ability to maximize the Suggestions and Instructor Survey dialogs. Course Timetabling: Initial Student Sectioning Added the ability to skip the assignment of a student to the course when there is a reservation for a class or a course that is not being loaded (e.g., distance configuration when solving on-campus students). Enable by setting StudentSectioning.MustFollowReservations in the solver configuration to true (defaults to false, which is the existing behavior). Student Solver Reports, Student Dashboard: Not Available message Added a better explanation of why a course is not available for a student. Applies to the Not-Assigned Course Requests report. Applies to the List of Classes tab when a student is clicked. Data Exchange: Import Avoid an issue with the import file being removed before it is imported by: 1. Renaming the file once it is passed to the data exchange form 2. Remove the file only after the import is finished This resolves the occasional "The system cannot find the file specified" error that may occur during the import. JSON API: Reservations Added an ability to indicate that a given field or class should be excluded from JSON serialization (with the new @ExcludeFromJsonApi annotation). Fixed an issue with both IdName and Subpart/Clazz having a parent field. Fixed an issue with Subpart.config and Clazz.subpart creating a circle. Technology Upgrade Hibernate upgraded to version 6.6. Infinispan upgraded to version 15.0. This fixes the issue with Java 23 or later (ISPN-14375 issue), however, this change also bumps the minimal version to Java 17. Apache Struts upgraded to version 6.7 JGroups upgraded to version 6.5 GWT upgraded to version 2.12 4.8.198 Wed, 16 Apr 2025 Course Timetabling Solver: Exact Times Do not allow for a date pattern & exact time combination that has no meetings. Rooms: Availability Fixed an array index out of bounds when generating the room availability thumbnail icons in some instances. Course Timetabling Solver: Instructor Unavailable Dates Unavailability checking for externally managed classes has been corrected. Use the department of the instructor, not the department for which the instructor is being loaded in. Timetable Grid: Per Date Display Avoid showing incorrect dates when the client is in a different time zone than the server. Examination Solver: Duplicate Instructor Fix Avoid Null exceptions when the same instructor is listed two times on the same exam (under different departments). Add/Edit Examination: Classes / Courses Fix Fixed an issue of the Classes / Courses table not loading courses for a subject area with a course that has a quotation mark in the title. Online Student Scheduling Dashboard: Student PIN On the Students tab, show student PINs for students that have their PIN released. Allow admins and/or advisors to release/suppress student PINs (Student Scheduling Can Release Pin permission needed). For students that do not have PIN filled in, added a custom interface for populating student PINs (unitime.custom.StudentPinsProvider property). Sponsoring Organizations Added an option to make sponsoring organization a mandatory field for special events. Enabled by setting unitime.events.sponsoringOrgRequired to true (defaults to false). When set to true, sponsoring organization must be set when creating a new special event. Data Exchange: Student PIN Added student PIN and PIN released flags in the student and course requests XML imports and exports. Student XML: added pin and pinReleased attributes to the student element. Requests XML: added pin element under updateDemographics with value and released attributes. Timetabling Managers: Short Name Added an ability to customize the short name format which is used, e.g., in the Last Changes component. Can be changed using the unitime.managers.shortNameFormat property, defaults to initial-last. 4.8.182 Thu, 30 Jan 2025 Student Scheduling Solver: Hard Distance Conflicts Added an ability to make some distance conflicts hard (not allowed). To enable, set the solver parameter Sectioning.HardDistanceConflict to true (defaults to false). A distance conflict is considered hard when: The distance between the two classes (or a class and an unavailability) is HardDistanceConflict.DistanceHardLimitInMinutes or more (defaults to 60). The travel time exceeds the time for travel (break time + gap) by more than HardDistanceConflict.AllowedDistanceInMinutes (defaults to 30). So, in other words, a distance conflict with a travel time of 60 or more minutes will be considered hard if the student has less than 30 minutes to travel between the two classes. Scheduling Assistant, Dashboards: Hard/Long Distance Conflicts Long Distance Conflicts: A distance conflict is considered long, when the travel time is HardDistanceConflict.DistanceLongLimitInMinutes (default to 60) minutes. Long distance conflicts show a different icon in the user interface (a red racing car instead of a road runner). When a student cannot be enrolled in a course due to a hard distance conflict, show a Conflicts with X warning message. Just like when the course is conflicting with some other course X due to time overlaps. Allow for hard distance conflicts when student checks the "Include conflicting suggestions" toggle. Instructional Offering Detail: Instructor Requirements Better formatting of the Instructor Requirements table, especially when there is a column with a lot of text. Distribution Preferences Added three new group constraints (distribution types). SAME_STUD_NODST: Students No Distance Constraint This distribution is the same as the Same Students distribution, except there is no distance conflict checking and no work-day limit. Also, the distribution gets ignored when there is the Ignore Student Conflicts distribution between the two classes. To replace DIFF_TIME in General.AutoSameStudentsConstraint This constraint can be used as the Same Student Constraint in the solver configuration, e.g., in the interactive mode, replacing the Different Time constraint which does not ignore cases when there is the Ignore Student Conflicts between two classes in a parent-child relation. DIFF_TIME_IGN_STUDS: Different Time + Ignore Student Conflicts Combination of two constraints, Different Time and Ignore Student Conflicts. Given classes cannot overlap in time, replacing any student conflicts between these classes. When prohibited or (strongly) discouraged: every pair of classes in the constraint must overlap in time. Still, student conflicts are ignored. FOLLOWING_DATES: Following Dates Given classes must be taught on back-to-back dates and in the given order. When prohibited or (strongly) discouraged: given classes must be taught on dates in the given order, with at least one day between the following classes. Note: The primary use for this constraint is for classes that meet only once. The constraint cannot be satisfied when one of the meetings falls on a holiday, and the other does not. Instructor Unavailable Dates Course Timetabling Solver: Consider instructor's department when checking for the unavailable dates. This is to allow for an instructor to have different unavailable dates on each of the departments they are teaching. Class Assignment page: Do not list class times during which the instructor is not available. Either because they have Instructor Unavailable Dates set. Or because instructor event availability is enabled (unitime.events.instructorUnavailability=true). Instructional Offering Detail, Class Detail, Instructor Detail: Include instructor availability in the conflict checking. That is, show a class conflicting warning when the class is placed at a time during which the instructor is not available due to an event, or unavailable dates. Curricula Multiple Majors: Fixed a Hibernate issue when setting up a curriculum with multiple majors. Instructor Distribution Preferences Many course timetabling distributions (group constraint and flexible constraints) have been included in the instructor scheduling problem, namely At Most N Hours A Day: Classes are to be placed in a way that there is no more than given number of hours in any day. Same Weeks: Given classes must be taught during the same weeks (i.e., must have the same date pattern). N Hour Workday: Classes are to be placed in a way that there is no more than given number of hours between the start of the first class and the end of the class one on any day. Minimal Gap Between Classes: Classes need to be placed in a way that there is at least the given number of minutes between any two of them. Max Block: Given classes must be taught in a way there is a break between two blocks of classes. Max Breaks: Limit number of breaks between adjacent classes on a day. Max Days: Limit number of days of a week. Break: There must be a break of a given length in a given time interval. Max Weeks: Limit number of weeks on which an a class can take place. Max Holes: Minimize free time of an instructor during a day (between the first and the last class). Max Half-Days: Limit number of half-days of a week. Max Consecutive Days: Limit number of consecutive days of a week. See https://help.unitime.org/additional-distribution-constraints for more details about the additional distribution constraint types. Events Personal Schedule: All Sessions When All Sessions flag is used on personal schedule, added an ability to lookup classes, exams, and course-related events from all academic sessions. By default, only (previous and past) academic sessions with the same academic initiative are considered. Enable by setting unitime.events.personal.allSessions.skipSessionCheck to true (defaults false). Hibernate Community Dialects Added hibernate-community-dialects dependency to include additional dialects. Namely the org.hibernate.community.dialect.OracleLegacyDialect allowing for older Oracle Database versions. 4.8.170 Fri, 6 Dec 2024 Class Assignment: Room Partitions Consider room partitions when checking room availability (other non-class events). Multiple Class Setup: Room-related Columns In order to be consistent with the Instructional Offering Configuration page, the order of the room-related columns changed to be: Nbr Rooms, Splt Attd, and Room Ratio. Instead of Room Ratio, Nbr Rooms, and Splt Attd. Edit Scheduling Subpart: Subpart Credit Max Units made editable when editing Variable Min/Max credit without the need to change the credit type first (when editing existing credit information). Fixed an issue when no units or max units are provided (for a type that requires units/max units) or when the provided units are not a number. Course Timetabling Solver: Optimization In order for the solver to start optimization even when a complete solution cannot be found, added an ability to halt the initial search phase when a maximum number of non-improving iterations is reached. This can be controlled by the Search.MaxIdleIterations parameter. It defaults to 1000. Set to -1 to disable the ability to halt the initial search phase (previous behavior). Set to 0 to disable the construction heuristics, going directly to the optimization phases. Added an ability to disable the max-idle limitation during the first part of the search, effectively setting up a minimal construction time. Parameter Search.MinConstructionTime, which can be in seconds or in percentage of the total time (Termination.TimeOut). Defaults to 10% of the total time limit. So, if max-idle is enabled, it will not stop construction or the IFS phase during the first 10% time of the solver run. Improved the ability to assign an unassigned class during the optimization phase. To enable this, add ;org.cpsolver.coursett.neighbourhoods.Suggestion@0.1 to the following parameters: HillClimber.AdditionalNeighbours GreatDeluge.AdditionalNeighbours SimulatedAnnealing.AdditionalNeighbours This is especially needed when the construction phase is disabled, or the solver struggles to find a complete solution when one exists. Course Timetabling Solver: Random Student Swap Selection Added a neighborhood selection that attempts to swap a student between alternative sections of a course. To be used with the Hill Climber (HC), Great Deluge (GD), or Simulated Annealing (SA) algorithms. Enable by adding the RandomStudentSwap class to the AdditionalNeighbours properties. The selection is only available/enabled when the solver is using a single thread as student class assignments are not included in the solution/ Course Timetabling Solver: Simulated Annealing Various improvements and changes in an attempt to make the SA algorithm more reliable. Added minimal and maximal temperature. Improved temperature training (when SimulatedAnnealing.InitialTemperature is set to -1) Room Partitions Added support for room partitions in the examination timetabling. Student Scheduling Solver: Linked Classes Allow one class to be present in multiple Linked Classes distributions between the same two courses. This allows for the Linked Classes to overlap with each other, e.g., when most classes can be linked one-to-one, but there are exceptions (e.g., one course has an additional course that can be used with any class of the other course). Lookup Classes/Examination: Bugfix Populate the event filter even when it is not present. This fixes an issue caused by a recent change, having the events and rooms parameters incorrectly interpreted. Edit Event: Meeting Contacts Record which meetings have their contacts changed in the Notes. Data Exchange: Course Offering XML Added an optional attribute class.roomRatio, defaults to 1. Added an optional attribute class.splitAttendance for classes with two or more rooms, defaults to false. Add/Edit Date Pattern: Make Default Added a confirmation dialog when Make Default button is clicked. Added an option to hide Make Default button on this page by setting unitime.pattern.showMakeDefault to false. If Make Default button is disabled, the default date pattern can still be set on the Edit Academic Session page. Scripts: ECMAScript Nashorn is now included in the UniTime distribution. Starting with Java 15, ECMAScript has been removed from JDK. Jython is now included in the UniTime distribution so that Python scripts do work out of the box. 4.8.159 Fri, 27 Sep 2024 Instructional Offering Configuration Delete: Fixed a possible "deleted object would be re-saved by cascade" exception when deleting a configuration that participates in a distribution preference. Delete: Fixed a possible "deleted instance passed to merge" exception when deleting a configuration that has teaching requests. Delete: Skip validation for a configuration that is being deleted. Solution (Database) Save A few changes to make the save faster: Faster computation of number of no-conflict placements in variable info. When General.SaveConstraintInfos is false, do not compute no-conflict placements in variable infos at all. Edit Class/Scheduling Subpart Added an ability to search the list of available date patterns. Enable by setting unitime.classEdit.searchableDatePattern to true (defautls to false). When enabled, the Date Pattern list box is replaced by a text field with suggestions. Extended Student Conflicts Constraint Fixed a concurrency issue. Wait-Listing Position: Consider current enrollment when computing wait-list position. Processing Order: Do not prioritize students wait-listing for a course swap. Student Scheduling Assistant Suggestions: When the Suggestions dialog is opened, include ARIA status labels for drop and wait-list buttons when the buttons are present. Suggestions: Made the Drop and Wait-List buttons easier to get to. Unavailabilities Added unavailability distance conflicts (distance conflicts between sections and unavailabilities). This is particularly useful when unavailabilities from other overlapping academic sessions are enabled. A different max travel time in minutes can be defined for unavailabilities using the new solver parameter Distances.MaxTravelDistanceInMinutes. Added Student Unavailability Conflicts solver report (listing both time and distance conflicts). Batch Scheduling: Visiting F2F Priority Added a new course request priority Visiting F2F that can be used to lower priority of visiting students for getting in face-to-face courses. Can be enabled by identifying visiting students with Load.VisitingStudentFilter (e.g., not campus:XX) A course request is considered face-to-face, if there is at least one possible enrollment that has a face-to-face class. When Load.VisitingFaceToFaceCheckFirstChoiceOnly is set to true (defaults to false), only the first-choice course is checked for face-to-face classes. Only course requests without a priority can have their priority lowered (set to Visiting F2F). Advisor Course Recommendations Show recommendations from the other academic session(s) if a student is advised in two or more parallel sessions. Student Scheduling Assistant / Student Course Requests Available Sessions: Prefer sessions with matching student campus (in the order they are displayed). If two or more academic sessions start on the same date, prefer the academic session whose initiative matches the student's campus. Property unitime.studentScheduling.preferredStudentCampus can be used to provide regular expression for preferred student campuses. Enable by setting unitime.studentScheduling.preferSessionsWithMatchingCampus to true, defaults to false. Student Scheduling Solver: Credit Limits Added an ability to adjust the student's min/max credit limit by their enrollment in other parallel sessions. I.e., sessions with matching academic term and year, but different initiative. Enable by setting the solver parameter Load.DecreaseCreditLimitsByOtherSessionEnrollments to true (defaults to false). Distribution Constraints The examination distribution constraints were rewritten to make them easier to extend and customize. For soft constraints, penalizations are now counted on individual examination pairs. This better ascertains how well the constraint is satisfied, especially for constraints posted between many exams. Personal Schedule: Additional Emails Added an option to disable lookup for events where the person's email is listed in the Additional Emails field. Disable by setting unitime.events.personal.considerAdditionalEmails to false, defaults to true. Event Filter Added an ability to skip computation of most event counts on the filter to make it load and operate faster. To enable set unitime.events.eventFilter.skipCounts to true (defaults to false). GWT-Based Pages: Cookies Avoid using cookies when possible (e.g., to store filter settings). Use HTML5 local/session storage instead. This is to avoid error 400 - Bad Request: Request header is too large when using long texts in the filters. Add/Edit Timetable Manager External Manager Lookup: Only reset the email address (to the one from the LDAP directory) when it is left blank. Data Exchange API Corrected XML import response. 4.8.147 Thu, 25 Jul 2024 Multiple Class Setup Date Pattern: Corrected the name of the default date pattern when a date pattern is set on the scheduling subpart. Add/Edit Room Preference: Do not allow for Required preference (for a department) unless there is already a required department for the room. Required preference set directly on a room usually makes no or very little sense and usually only creates confusion when a room is accidentally marked as required (as no other rooms can be used for the department by the course timetabling solver). Batch Student Solver Reports, Online Student Scheduling Reports Filter: In the filter's drop-down, added Advisor text field and My Students checkbox. This is to make it easier for non-admin users to use. Main page To prevent an XSS vulnerability, sanitize the message when provided as a parameter. 4.8.145 Fri, 19 Jul 2024 Instructional Offerings / Classes Added an experimental user settings that allows for the header row on the Instructional Offerings and Classes pages to freeze (has sticky position). To enable, add stickyTables manager setting with yes and no options (using Default Manager Settings page, sticky table headers are enabled when set to yes). Instructional Offering Configuration When unlimited enrollment is selected, make sure that all classes have zero number of rooms. Reservations, Instructional Offering Detail, Student Scheduling Dashboards Reservations table: Always show the reservation flags such as Allow Time Conflict, Can Assign Over Limit, Student Must Follow, and Do Not Reserve Space. This is to ensure that it is always clear what the reservation/override does. Events: Filter by Day of Week Fixed a Hibernate 6.x issue when filtering by day of the week on MySQL and PostreSQL. Administration: Event Statuses Corrected an issue causing a room sometimes being shown under a wrong department/room type. Batch Student Solver Reports, Online Student Scheduling Reports Added an ability to filter reports using a Filter with similar capabilities as on the dashboard pages. Added Conflicting Course Requests report: variant of Not-Assigned Course Requests report, but only showing course requests with time conflict. Added Not-Used Curriculum Reservations report. Added Reservations report: showing all reservations and their current enrollments / limits. Added XLS export. Batch Student Solver Dashboard, Online Student Scheduling Dashboard Reservation Tooltip: Do not show limit (null) for unlimited classes. Show flags for curriculum override reservations. Individual, Curriculum: Limit the number of restrictions to 5 lines. Added XLS export. Rooms: Custom URL Added an ability to provide custom URLs for rooms (based on their name, building, room number, or external id). For more details, see the unitime.rooms.url properties. 4.8.139 Tue, 18 Jun 2024 Multiple Class Setup Added column with the capacity of the assigned room (Cap). Added mouse-over for assigned rooms. Fixed the ability to clear External Id (when modification of external ids is allowed). Student Email Notifications Created a plain-text template alternative for student scheduling emails. Plain-text student emails can be enabled by setting unitime.enrollment.email.plainText to true (defaults to false). Advisor Course Recommendations Ensure that the advisor's additional notes do not overlap with signature on the generated PDF. Online Student Scheduling Dashboard: Filter The the following checks now allow for partial match using %: area, classification, major, concentration, campus, accommodation, degree, program, minor, primary-area, primary-classification, primary-major, primary-concentration, primary-degree, group, status For example, a:A% matches all areas starting with A. Or, LC:% matches all students that are in a group of LC type. Universal Reservation Override: Student Filter Added a missing check on student minors. The the following checks now allow for partial match using %: area, classification, major, concentration, campus, accommodation, degree, program, minor, primary-area, primary-classification, primary-major, primary-concentration, primary-degree, group, status Roll Forward: Travel Times, Room Partitions Corrected roll forward of room partitions and travel times on Oracle (empty external id check was incorrect). 4.8.134 Wed, 29 May 2024 Extended Student Conflicts Added an experimental global constraint that does not allow any two classes that the same student can attend to have a conflict. The constraint checks any two classes of different offerings that share at least one student and that the student is allowed to take (not restricted by reservations). Class pairs included in the Ignore Student Conflicts constraints are ignored. Some classes may be excluded by using ExtendedStudentConflicts.IgnoreClasses parameter which may contain a regular expression matching class name(s). Pairs of classes of the same offering are checked, too. In this case, the course structure must allow the two classes to be attended together (e.g., they are from the same configuration), and at least one student in the offering is allowed to take both classes. This feature is enabled by default and can be disabled by setting ExtendedStudentConflicts.CheckSameCourse to false. To enable this constraint, add org.cpsolver.coursett.constraint.ExtendedStudentConflicts to General.GlobalConstraints (which contains a semicolon separated list of global constraint classes that should be automatically added to the problem) Room Edit: Room Features & Groups Disabled pre-fetching of room relations (such as departments, features, and groups) when loading the data for the Room Edit page. This fixes a potential Hibernate issue that is causing room groups and features to disappear (not get loaded) in some cases that are hard to explain or reproduce. The pre-fetching can be enabled by setting unitime.rooms.prefetchRelations to true. Multiple Class Setup Multiple Class Setup page rewritten to GWT to make the page faster and more reliable. To use the old (Struts2-based) page, set unitime.legacy.course.multiple_class_setup to true. When managing department is changed, only remove preferences that no longer apply (e.g., keep global room feature/group preferences). Former behavior (clear all room-related preferences) set unitime.legacy.course.clear_preferences to true. Instructional Offering Configuration Instructional Offering Configuration page rewritten to GWT to make the page faster and more reliable. To use the old (Struts2-based) page, set unitime.legacy.course.instr_offering_config to true. When managing department is changed, only remove preferences that no longer apply (e.g., keep global room feature/group preferences). Former behavior (clear all room-related preferences) set unitime.legacy.course.clear_preferences to true. Scheduling Subpart Detail: Classes Show External Id column when there is at least one classes with an external id filled in (instead of showing the column when there is a class with a timetable). Show Student Schedule Note when there is at least one class with a note (instead of always showing the column). Instructional Offering Detail: Configuration Show Timetable column when there is at least one class with a timetable (instead of always showing the Timetable columns). Show External Id column when there is at least one classes with an external id filled in (instead of always showing the column). Show Student Schedule Note when there is at least one class with a note (instead of never showing the column). Scheduling Assistant: Submit Schedule Fixed a possible TransientObjectException when a new course request is added to an existing course demand. The problem seems to be related to the recent Hibernate 6.2.22 update. Student Scheduling: Reservations Student Scheduling Solver: Improved handling of reservations with restrictions from two or more configurations by computing and using configuration-specific limit caps and reservation limits. This makes the computation of reserved and unreserved space for a config or a section much more accurate. Online Student Scheduling: Corrected the computation of reservation limit for reservations with restrictions from two or more configurations. This fixes an issue causing some space not to be reserved when a reservation was set between a configuration and one or more sections of a different config. Online Student Scheduling: The checking of available space (e.g., when a student clicks Submit Schedule) for reservations with restrictions from two or more configurations has been corrected. This is especially applicable to reservations marked as exclusive (to be checked only at the levels they are set). Add/Edit Reservation: Corrected computation of the selected spaces when restrictions from two or more configurations are selected. Examination Timetable When showing data from the database, load the examination grid page faster. This is done by pre-fetching all exams and their relations (like the Examination Reports page already does). Room Splits No longer impose a limit on the number of rooms an exam can use. This fixes the ArrayIndexOutOfBoundsException when an exam is being split into more than 32 rooms. Data Exchange: Last-Like Course Demand Import Open transaction before subject areas are loaded. This fixes a Null exception introduced with Hibernate 6.x changes. Data Exchange: Curriculum Import Added an incremental mode (when incremental="true" in the root element). Only curricula of matching abbreviations are removed. If the XML contains curriculum A/M1, the existing A/M1 curriculum is deleted first. Data Exchange: Reservations Import Added an incremental mode (when incremental="true" in the root element). Only reservations of matching courses and types are removed. If the XML contains a curriculum reservation for ALG 101, all previous curriculum reservations for this course are deleted first. User Context: Test Sessions Added checking for test session status for Advisor, Instructor, and Student roles. The test session is only available when the role has the Allow Test Sessions permission. Technology Upgrade Hibernate upgraded to version 6.4 (from 6.2). Please note that in HQL, = null or != null no longer works (use is null or is not null instead). Apache Struts upgraded to version 6.4 (from 2.5). Authentication: OAuth2 Added an ability to use OAuth2 authentication. See https://help.unitime.org/OAuth2 for more details. Docker Installation Added an ability to install UniTime as a Docker container. See https://help.unitime.org/docker for more details. 4.8.115 Wed, 13 Mar 2024 Scheduling Subparts: Limit, Course Name Do not pre-compute scheduling subpart limits and course names. This fixes an issue of showing an incorrect limit after a class limit change or when a class has been added or removed from a subpart. The drawback is that these fields are no longer available in the reports, to fix this replace ss.limit with (select sum(c.expectedCapacity) from Class_ c where c.schedulingSubpart = s) ss.courseName with (select co.subjectAreaAbbv || ' ' || co.courseNbr from CourseOffering co where co.isControl = true and co.instructionalOffering = ss.instrOfferingConfig.instructionalOffering) Multiple Class Setup Prevent premature submission of the page by only enabling all the submit buttons after the page is fully loaded. This fixes a problem when some classes are deleted because the page is submitted for a massive course configuration while it is still being loaded. Instructional Offering: Limit, Demand Do not compute demand and limit fields within the data model (formula). It does not save anve time and just complicates the query. This is to avoid showing old data, e.g., when an instructional offering configuration is updated. The drawback is that these fields are no longer available in the reports, to fix this replace io.limit with (select sum(ioc.limit) from InstrOfferingConfig ioc where ioc.instructionalOffering = io) io.demand with (select sum(co.demand + (case when cox is null then 0 else cox.demand end)) from CourseOffering co left outer join co.demandOffering cox where co.instructionalOffering = io) This way, the fields are only computed when needed. Batch Student Solver Reports: Export CSV Corrected permission checking for the published student scheduling solver. 4.8.110 Tue, 27 Feb 2024 Instructor Unavailability: Daylight Saving Dates Corrected instructor unavailability on daylight saving days (i.e., days with 23 or 25 hours). Travel Time: Default/Computed Distances Show default/computed distances in blue. Course Timetabling: Multiple Rooms Split Attendance When a class needs two or more rooms, added an ability to set the class as requiring split attendance. When split attendance is set for the class, the class is expected to be split among the assigned rooms (the total room capacity must meet the class limit times room ratio). When split attendance is not set for the class (which is the default), each room must be big enough to fit the class. Split Attendance can be set on the Instructional Offering Configuration page (all classes of a subpart) or the Multiple Class Setup page (individual classes). Course Timetabling: Multiple Rooms With Different Preferences The ability to provide different preferences for each room has been added for classes that need two or more rooms. This includes cases when some rooms are prohibited in some positions, e.g., a class needs a classroom and some other room. Room-related preferences can be only defined on the class or the scheduling subpart level, for rooms, room groups, room features, and buildings. Course Timetabling: Solution Commit Solution commit made a little faster by loading the event date mappings only once. Student Scheduling Assistant / Course Requests: Access Control Added an ability to limit how many users can use the page (Scheduling Assistant and/or Course Requests) at the same time. Automatically leave the page after a given time of inactivity (showing a warning first). Parameters for Scheduling Assistant: unitime.accessControl.sectioning.maxActiveUsers .. Maximal number of users using the page at the same time (not set or zero for disabled). unitime.accessControl.sectioning.activeLimitInMinutes .. Number of minutes of inactivity for the user to get the Inactive Warning (defaults to 15 minutes, set to zero to disable). Parameters for Course Requests: unitime.accessControl.requests.maxActiveUsers .. Maximal number of users using the page at the same time (not set or zero for disabled). unitime.accessControl.requests.activeLimitInMinutes .. Number of minutes of inactivity for the user to get the Inactive Warning (defaults to 15 minutes, set to zero to disable). When the Inactive Warning shows, the user has a minute to dismiss the warning before the page is exited automatically. Universal Reservation Override: Student Filter Added a universal reservation override type that allows to reserve space for students using a student filter. Student filter is a boolean expression that may contain the following attributes: area, classification, campus, major, minor, concentration, degree, program, group, accommodation, student, advisor, status primary-area, primary-classification, primary-major, primary-concentration, primary-degree, primary-program, primary-campus For example, the following filter will match all programs that ends with -OL or -HY: primary-program:%-OL or primary-program:%-HY Student Availability: Check Other Academic Sessions Added an ability to check student schedules from other overlapping academic sessions.The classes of other academic sessions show up as unavailablies (blue color, not clickable). They are also used as unavailabilities: the solver would not assign a class in the current academic session to a time that conflicts with a class of some other academic session that the student has. Unless the class is of scheduling subpart that allows for overlaps, in which case the overlapping time is minimized instead. This feature is not enabled by default, to enable it set the following properties: Batch student scheduling: set the solver parameter Load.IncludeUnavailabilitiesFromOtherSessions to true. Online student scheduling: there are two options, the unavailable times are either loaded from the database (when General.CheckUnavailabilitiesFromOtherSessionsUsingDatabase is true), or from the other online student scheduling solver servers (when General.CheckUnavailabilitiesFromOtherSessions is true). Rooms: Event Email Added event emails on rooms, non-university locations, and event statuses. When sending an event confirmation email, automatically CC all rooms of changed meetings. Event Statuses page can now edit a default event email for a department and a room type pairs. Event Statusess and Add/Edit Room pages can now edit event emails of an individual room. Data Exchange: Academic Session Export Fixed the occasional "Unable to export: No row with the given identifier exists" error on records that do exists. 4.8.98 Fri, 5 Jan 2024 Instructional Offering Detail: Instructor Requirements Ensure that only requirements (instructor surveys) from the correct academic session are listed. Include instructor surveys for assigned instructors that did not fill in course requirements for the course. Classes, Class Assignments: Manager Filter Added an ability to select multiple managers. Timetable: Room Filter Added an option to include the Room Filter (from the Rooms page) in the Filter section. To be enabled by setting unitime.timeGrid.roomFilter to true (defaults to false). When room or class filters are used, do not show instructors, curricula, etc. that have no matching classes. Instructor Survey: Copy Course Requirements Corrected copy of courses from a different academic session (the query filling in the remaining courses that the instructor has currently assigned was wrong). Timetable Grid: Curriculum When showing a saved/committed solution, corrected matching of a curriculum reservation when the displayed curriculum has no major. Class Weights: Number of Weeks Class Weights Added "Nbr Weeks Class Weights" option for the Class Weights solver parameter, weighting classes by the number of weeks they are using. Classes using the default date pattern have a weight of 1.0, a class meeting only every other week would be weighted 0.5. Events Timetable: Curriculum Corrected matching of a curriculum reservation when the displayed curriculum has no major. Instructor Schedule Changes Corrected change detection when assignment changes are disabled (and there is a Lec-Lec combination with the same external id). Timetabling Managers: Update Other Academic Sessions Added an ability to update departments and solver groups in the academic sessions with the same academic initiative. Academic sessions in the finished status are not included. By default, the current and all future sessions (with the same initiative) are selected when a new manager is being added. For existing managers, the academic sessions with the same departments and solver groups are selected by default. Test HQL, Reports: Improved Error Handling When the provided HQL is incorrect, display a more meaningful error message. 4.8.92 Thu, 14 Dec 2023 Instructor Survey Added an ability for departmental schedule managers to unsubmit the survey directly from the Instructor Survey page/dialog (meaning save and unsubmit). Edit Instructor It is now possible to reset the instructor's position. Solver Reports Added Student Priority and Request Priority columns on various reports. Added Not-Assigned LC Course Requests and Not-Assigned Critical Course Requests reports. Added Critical Time Conflicts, Critical Availability Conflicts, and Critical Time & Availability Conflicts reports. Only listing course requests that have Important, Vital, Critical, or LC priority. For time conflicts, only courses with the same or higher priority are considered. Email Notification Types Added an ability to define which email notifications will be set based on the student status. The following options are available: Student Request Change (student made a change using the Student Course Requests page) Student Enrollment Change (student made an enrollment change using the Student Scheduling Assistant page) Admin Request Change (administrator or advisor made a change using the Student Course Requests page) Admin Enrollment Change (administrator or advisor made an enrollment change using the Student Scheduling Assistant page) Enrollment Approval (enrollment requiring a consent has been approved) Course Schedule Change (time or room of one of the classes has changed due to re-scheduling) Course Enrollment Change (an enrollment change was done by wait-listing or re-scheduling) Course Failed Enrollment Change (UniTime failed to make an enrollment change during wait-listing or re-scheduling) External Enrollment Change (there has been an enrollment change done externally, outside of UniTime) Instructor Schedule Changes An email notification can be automatically sent to the instructor when the instructor assignment is changed (instructor is added to/removed from a class), the class that the instructor has is moved in time and/or room, or the class that the instructor has assigned is canceled or reopened. Optionally, an email can be sent when the percent share, check conflicts, or responsibility is changed. Configuration: Enable instructor notifications be setting unitime.notifications.instructorChanges.enabled=true (defaults to false). Include the list of all currently assigned classes that the instructor has in the email notification by setting unitime.notifications.instructorChanges.includeSchedule (defaults to true). Check/display the instructor's percent share, responsibility, and check for conflict changes by setting unitime.notifications.instructorChanges.checkShare (defaults to false). Note: Instructor schedule changes are only available when the online student scheduling server is running, as the offering-reload action (Unlock button) triggers and tracks the changes. Email Notifications Begin/End Dates Added Notification Begin/End Date on the academic session. One or both dates can be null (not set), in which case there is no begin and/or end date defined. Other settings still apply, i.e., email notifications must be enabled for students and/or instructors, and student status must allow for the notifications. It is possible to enable/disable notifications date checking for students and/or instructors. For instructors, by setting unitime.notifications.instructorChanges.checkNotificationDates (defaults to true). For students, by setting unitime.enrollment.email.checkNotificationDates (defaults to true). Or only particular actions can check for dates by setting unitime.enrollment.email.<operation>.checkNotificationDates parameter (not set by default). Name Formats Added the following name formats, adding an external id after the last name or at the end of the name: last-ext-first-middle last-ext-first-middle-title last-first-middle-ext first-middle-last-ext last-first-middle-title-ext title-first-middle-last-ext title-initial-last-ext title-last-initial-ext These can be added on the Administration > Defaults > User Settings, name property (and then selected on Preferences > Settings). Default Solver Configuration Added ability to change the default solver configuration by changing the unitime.solverConfig.defaultXxx application property. Authentication: Active Directory Added a Spring Security configuration compatible with Active Directory (unitime.spring.context.security=securityContextLDAP-AD.xml). Using LDAP server authentication, user search instead of user DN matching, and using user name as the user's external id. Online Scheduling Dashboards: Filter Fixed the query when filtering by course and instructional method at the same time. Corrected the ability to use not assignment:XX in the filter on the Enrollments tab, e.g.: not assignment:Vital Student Scheduling Dashboards: Enrollments When listing individual enrollments on the Courses tab: Request priority column did not show for Vital and LC courses. Adjusted display of request Priority column (include text, not just an icon). Improved sorting by Priority, Alternative, and (request) Priority. Course Timetabling Solver: Export CSV Corrected Export Solution when the class names include external ids/class suffixes (i.e., unitime.solver.showClassSuffixes is true). Multiple Class Setup: Delete Classes When deleting an assignment, remove all related constraint infos to avoid Hibernate cache issues when an orphaned constraint info is automatically deleted. This fixes a No row with the given identifier exists: ConstraintInfo issues. 4.8.67 Fri, 6 Oct 2023 Hibernate 6.2 / JGroups 5.2 UniTime updated to use the latest versions of Hibernate 6.2 and JGroups 5.2. Infinispan 14 is now used for second level cache and cache replication/invalidation when there are multiple web servers. This, however, requires UniTime to use Java 11 or later (Java 8 is no longer supported). Some HQL reports may need to be updated due to the Hibernate upgrade, e.g., table = id no longer works (e.g., Session = %SESSION% must be changed to Session.uniqueId = %SESSION%) x is true needs to be changed to x = true function BIT_AND needs to be changed to BITAND InstructionalOffering.coordinators needs to be changed to InstructionalOffering.offeringCoordinators Assignment.classId needs to be changed to Assignment.clazz.uniqueId CourseOffering.isControl = 1 needs to be changed to CourseOffering.isControl = true mod(x, n) may need to be changed to mod(cast(x as int), n) sysdate - :days (where :days is an integer) may need to be changed to sysdate - numtodsinterval(:days, 'day') Some Scripts may need to be updated due to the Hibernate upgrade, e.g, Query.setLong, setString, setDate, etc., needs to be changed to setParameter QueueIn/QueueOut.setXml/getXML now takes a string (use setDocument/getDocument for XML access) Instructor Survey Added a new page (Instructor Survey) that can be used by instructors to fill in their preferences and course requirements. To be enabled by the Instructor Survey toggle on the academic session status page (Status Types page). See https://help48.unitime.org/instructor-survey for more details. Instructional Offering Cross Lists Fix the instructors and offering coordinators when the controlling department is changed. This means that each instructor/coordinator gets replaced with an instructor/coordinator from the controlling department with the matching external id. An instructor/coordinator assignment gets deleted otherwise (the instructor has no external id or no matching instructor in the new controlling department). Instructional Offering Detail: Make NOT Offered Departmental schedule mangers cannot make a course not offered when it has a class they cannot edit (e.g., there is an externally managed class that is being timetabled). Online Student Scheduling Dashboard: Advisor Recommendation In the table showing the advisor recommendations for a student, added the following two columns: Advised: date and time when the line was added or modified last Advisor: person who advised the student (who added/modified the line last) Course Finder, Online Scheduling Dashboard When showing data direcly from the database (online scheduling server is not running) Correct date pattern formatting (using unitime.pattern.format.useDates property) Include date pattern and required room for arrange hours classes This applies to List of classes on the Course Finder dialog Enrollments of a student on the online dashboard (Student dialog) Classes listed on the Enrollments tab Course Finder: Filter Course Finder dialog on the Scheduling Assistant, Course Requests, and Advisor Course Recommendations pages improved. Added Filter section, which allows for filtering courses by: Class start/end date (given course must have an enrollment that does not start before the given From date, or lasts past the To date) Min/max credit Instructor name (given course must have a class with matching instructor name) Notes: Classes that do not display instructors are not considered by the instructor filter. Classes that are not enabled for student scheduling are ignored (both instructor and class dates filters). The filter is ONLY used for the list of courses, it does not guarantee that the student gets a class with the given instructor or within the given dates. When used on the Student Course Requests page or Advisor Course Recommendations page at the time when the schedule of classes has not been published yet, only allow for credit filter (no filtering by class dates or instructor names until the schedule of classes is published). Student Scheduling Dashboards: Show/Hide Columns Added ability to show/hide columns on the dashboard tables (Enrollments, Students, and Change Log). Student Scheduling Rules Added student scheduling rules that can be used to define which courses a particular group of students can request/enroll in.These rules can be defined on Administration > Other > Student Scheduling Rules page. A group of students can be a student filter (same format as on the dashboards, e.g., group:SpecialStudents or primary-major:%-OL). Each group of students can be restricted to particular course types (provided using a regular expression, e.g., !No Pre-Reg), course names (provided using a regular expression, e.g, .*[0-9]OL for all courses with OL suffix), or instructional methods (provided using a regular expression, e.g., PO|PH for course configurations with PO or PH instructional methods). A course name or instructional method regular expression can be negated by using an exclamation mark as a prefix (e.g., !.*[0-9]OL for all courses without an OL suffix). If multiple expressions are provided (e.g., both course and instructional method), depending on the mode of the rule, all of the expressions must match or just one. Each rule can be restricted by a regular expression matching academic initiative, a regular expression matching term, start and end year. The rules are processed in the given order. For each student, the first matching rule is used (there are no course or instructional method restrictions when no rule applies). A rule can apply only to filter (ability to lookup a course), online scheduling, and/or batch scheduling.Advisors and/or admins may be allowed to ignore the rule (there could be special courses that only advisors and/or admins can put the students in). Solver Load: Replace Pending courses with Substitutes Added ability to treat substitute course demands as primary when a primary course demand was skipped entirely due to one of the following reasons: pending override request (when Load.ReplacePendingWithSubstitute is true, defaults to false) canceled override request (when Load.ReplaceCancelledWithSubstitute is true, defaults to false) rejected override request (when Load.ReplaceRejectedWithSubstitute is true, defaults to false) not offered course (when Load.ReplaceNotOfferedWithSubstitute is true, defaults to false) More precisely, when a course demand is skipped (all its courses are skipped for some reason), and at least one of the courses is skipped due to a reason that is enabled, then Take the top most substitute course demand and treat it as primary. The position of the substitute course is kept (it shows at the bottom of the primary requests instead of at the top of the substitutes). Course demands that do not allow for substitutes (Wait-List or No-Sub toggle is checked) are not replaced with a substitute. Batch Student Solver Reports: Solution Statistics Added Requested Courses - impossible row: percentage of requested courses that have no possible enrollment (e.g., due to having all classes disabled). Academic Sessions Academic Session column: use academic year (instead of session start year) when identifying an academic session. Examination PDF Reports, Enrollment Audit PDF Reports Use academic year (instead of session start year) when naming an output file. Instructor Detail Previous/Next buttons on the Instructor Detail page: follow the order in which the instructors were listed on the Instructors page. Instead of using the default order (instructor names). Also applies to Previous/Next buttons on the Edit Instructor, Instructor Assignment Preferences, and Instructor Preferences pages.