Info

If a specific enhancement or new feature requires configuration, the notes will mention:

• the upgrade notes (steps),
• the components ("RIO Ed - Aura"),
• the attributes (configurable settings), and/or,
• the custom metadata type.

Otherwise, if there is no mention on configuration, attributes, RIO Ed - Aura components, or upgrade notes for a specific enhancement, this means that specific enhancement is automatically available upon installing this new version.

No configuration is needed for a new feature unless stated otherwise.

Upgrade notes

If you are directly upgrading from pre-3.12, make sure to carry out upgrade tasks for the following items below:

ISS-001139 Lightning Web Security readiness for LWC and Aura

Due to the enforcement of Lightning Web Security (LWS), all following Javascripts library used in RIO Education have been upgraded to the version that compatible with LWS:

• FullCalendar
• Jquery
• moment.js
• chartJs

Hence, the LWS needs to be enabled in your Salesforce instance in order for the Appointment Scheduler, Session Scheduler, and Calendar to work properly.

If you still have customized Aura components that utilize third party Javascript library that are not compliant with LWS, it is recommend not to upgrade to this version until the Salesforce Summer'23 release which would have LWS for Aura supported as general release. Please refer to Salesforce release schedule for more info.

Please note that it is important to test the upgrade in sandbox first before rolling out to production to avoid any unforeseen issues.

As part of the change, the following settings have been replaced with the new settings from FullCalendar v5:

If you have customized the Appointment Scheduler or Session Scheduler app page, please follow the steps to update the settings manually:

• Appointment Scheduler:
  • Default Calendar View: agendaWeek > timeGridWeek  
     
• Session Scheduler:
  • Calendar Header Button (Left):
    • timelineWeek > resourceTimelineWeek
    • timelineDay > resourceTimelineDay
    • timelineMonth > resourceTimelineMonth
  • Calendar Header Button (Center):
    • timelineWeek > resourceTimelineWeek
    • timelineDay > resourceTimelineDay
    • timelineMonth > resourceTimelineMonth
  • Calendar Header Button (Right):
    • timelineWeek > resourceTimelineWeek
    • timelineDay > resourceTimelineDay
    • timelineMonth > resourceTimelineMonth
  • These custom buttons are obsolete:
    • cToday
    • cTimelineDay
    • cTimelineWeek
    • cTimelineMonth
    • Please replace them with today, resourceTimelineDay, resourceTimlineWeek, and resourceTimelineMonth respectively.
  • The "prev" and "next" button cannot be placed next to "title" anymore due to the change of CSS on FullCalendar v5.
    • For example, you will need to remove “prev” and “next” from the Calendar Header Button (Center) and leave it with just “title”.
    • Then, in the Calendar Header Button (Left), key in “today prev,next”. This will display the button for you to click and view future and previous days/weeks.
       
  • If you have a customized Session Scheduler page, make sure to check that all attributes (e.g. field sets, info popups) are present after upgrading.
    • It is best to keep track of your attributes on the RIO Ed - Session Scheduler component before upgrading, so that you can update them if any are missing after upgrading.

ISS-001528 Simplify Grade Management

This is ONLY APPLICABLE if you are using grade settings at the university department and academic program level before v3.12.

Since grade settings are now only at the educational institution from v3.12 onwards, existing grade settings at university department and academic program levels need to be modified.

If you are upgrading from before version 3.12, you will need to do some manual upgrade steps. Please take note that it is recommended to perform this upgrade task before or after the grading and grade release period to avoid any data integrity issues.

The upgrade task involves updating the following fields:

• Grade Setting - Grade Setting Type field (formerly called Grade Setting Scope).
• Course - Grade Setting Type.

Please follow the following upgrade steps:

1. Navigate to the Grade Settings tab.

2. Create a new list view and include the following fields:

1. Name
2. Grade Setting Type
3. Educational Institution

3. Review the Grade Setting records:

1. If the “Grade Setting Type” field for all records is “Educational Institution”, complete only step #4a. Please ignore the rest of these steps.  
    
2. If some “Grade Setting Type” have “University Department” or “Academic Program”, please complete all steps.

4. Go to Setup > Picklist Value Sets, and find the Grade Setting Scope picklist values.

1. Deactivate the University Department and Academic Program options.  
    
2. For each unique University Department and Academic Program Grade Setting Type found on step #3b, create a new picklist value.  
   For example, if you have Grade Setting created under 'Department of Business' and 'Department of IT' university department, create two new picklist options: 'Business' and 'IT'.  
    
3. The new picklist options need to be added to the Course Connection Student record type.  
   There should be a checkbox while adding picklist options that says "Add the new picklist values to all Record Types that use this Global Value Set".  
   If you are not given the option to add them automatically, you will need to add that manually.  
   Go to Object Manager > Course Connection > Record Types, select the Student record type, select Grade Setting Type, then add the new picklist options.

5. Go back to the grade setting list view created on step #2

1. Replace the “Grade Setting Type” for both “University Department” and “Academic Program” with the appropriate new values from step #4 using the list view inline editor.  
    
2. Replace the “Educational Institution” for both “University Department” and “Academic Program” with the Educational Institution record.  
   This can be found by the account hierarchy, or looking through the records (they should be set up in the order Academic Program > University Department > Educational Institution).  
    

 6. Navigate to Course tab.

 7. Create a new list view with filter “Grade Setting Type” not equal to “Educational Institution” and include the following fields.

1. Name.
2. Grade Setting Type.
3. Department.
4. (Obsolete) Grading Academic Program.  
   Review the course records, replace the “Grade Setting Type” with the appropriate values from step #4 using the list view inline editor.