v2.10 - v2.14 Upgrade Steps
Many things were changed as we moved from v2.10, and some existing data may need to be updated.
1. Install the new version of RIO Education
For security reasons, make sure to install for Administrators Only. Our permission sets and sharing rules will handle giving access to other users.Delete
2. Install the new versions of the metadata package
Like usual, you will need to do the upgrade folders for each version between your old version and the new version.
There may be some layouts that you don't want to update. In that case, you will need to manually add some new fields to your current page layouts.
Upgrade folders can be found in RIO Education Release Notes under Metadata Package Link.
3. Update Term's enrollment open/close date times
We moved from using dates to date/times in v2.12. You should update all the terms with enrollment open/close dates, and populate the enrollment open/close date/times.
You should also remove obsolete date fields from the page layouts, and replace them with the date/time fields.
4. Set Default Program Pathways on Program Plans
We changed how students are assigned program pathways to follow. It’s now based on a field in Program Enrollment, or it follows a default from the Program Plan. If you aren't planning to set the Program Pathway in Program Enrollments through some other means, you will need to populate the Default Program Pathway field on Program Plan.
You can probably assume the full-time program pathway should be the default.
5. Set Program Pathways on Program Enrollments and PE Pathways
We have a Trigger Handler for the class rio_ed.PREN_UpdatedPathway_TDTM that will allow you to just update the Program Enrollment, and this will update the Program Pathway lookup on current and future PE Pathways. Old PE Pathways can be ignored.
Any existing Program Enrollment and PE Pathway should also have their Program Pathway field populated. You can probably assume there is a matching program pathway from PE’s Program Plan and Enrollment Method.
6. Set Student Fee Type on Contact
Contact no longer uses the "Is International?" checkbox to determine student fee types. You need to set the Student Fee Type on Contact. The default values are "Domestic" and "International", which you can set based on the old value in "Is International?"Delete
7. Fee Schedules need to be Approved
Any current Fee Schedules need to be updated to "Approved" for RIO Education to consider them when creating Student Fees. You can update the status field to "Approved", as long as there is at least one related Fee Schedule Term.Delete
8. Update all Course Offerings
Course Offerings need to be updated so we can set the correct Fee Schedule Terms and Fee Amounts on them. Just updating Course Offerings without changing anything is enough to trigger this Fee logic.
9. Program Enrollments with fee method = "Program" need to set the Fee Lookup
We no longer use Fee Amount field, so we need to populate the Fee lookup field. You should be able to find the appropriate Fee by looking at the Program Enrollment's Program Plan.Delete
10. Set Main Term Student Fee checkboxes
If you have any existing Student Fees for Program Enrollments with the Term or Term - Course fee methods, you will need to update those Student Fees. There is a checkbox called "Main Term Student Fee" that needs to be set to true. We use this checkbox to prevent duplicate Student Fees from being created.Delete
11. Existing Fee Lines need to lookup to Fee Schedule Terms
Any existing Fee Lines will need to lookup to their originating Fee Schedule Term (if applicable).
- If there is a related Course Connection, you can find the correct Fee Schedule Term through that.
- If fee method = Program, you can find the correct Fee Schedule Term through the Program Enrollment's Fee and Starting Term.
12. Course fee method Student Fees need to look up to PE Pathway
This step only matters if there are any current Program Enrollments with the "Course" fee method (not "Term - Course", that's different).
Student Fees for the Course fee method now need to lookup to the PE Pathway like the Term based Student Fees do. You should be able to find the correct PE Pathway by looking at the Fee Lines' Course Connections.
13. Discount Funding Allocations
This step only matters if you have any existing Funding Allocations.
If any discount type Funding and Funding Allocations had been created before 2.12, they need to use the Discount Amount field, instead of the regular Amount field.Delete
14. Elective/Optional Course Connection Behavior Change
When a Program Enrollment is created, all the related course type plan requirements defined in the selected program plan will be created as Course Connection. However, the behavior has changed where the automation will only create all course type plan requirements that defined as "Required" only. For "Optional" course type plan requirement, the Course Connection will be created when a student enrolls to a course via the enrollment wizard. This is to save the overuse of Salesforce data storage.
If you have any existing process/automation that relies on the "Optional" Course Connection, you will need to handle the record creation.Delete
15. New Apex Trigger on Session Time object
A new Apex Trigger has been introduced on session time object. If you have implemented a custom Apex Trigger on session time, you will need to deactivate the Apex Trigger to avoid duplicate execution.Delete