Transitioning Students to a New Program Plan Using the Program Transition Wizard
Table of Contents
Overview
The Program Transition Wizard allows administrators to move existing students from an old Program Plan to a new Program Plan within the same Academic Program.
This is useful when an institution retires or replaces a Program Plan but needs to move students who are still studying under the old plan to the new one.
Instead of manually updating each student's Program Enrollment and related records, administrators can use the wizard to perform the transition in batches.
The wizard restructures the following records and assignments:
- Program Enrollment (PE): Updates the Program Plan assigned to the student.
- Course Connections: Reorganises the student's course connections to match the new Program Plan.
- PE Groups: Updates the associated Program Enrollment Groups to reflect the new plan.
- Program Pathway: Assigns the selected new Program Pathway to transitioned students.
The wizard also supports course replacement mappings and can preserve completed course credits when transitioning students.
Purpose
Use the Program Transition Wizard when:
- An existing Program Plan is being retired or replaced.
- Students currently enrolled under the old plan need to continue their studies under a new plan.
- The institution wants to move multiple students without manually updating each Program Enrollment.
- Completed course credits need to be retained when students move to the new plan.
- Courses in the old plan have been replaced with equivalent courses in the new plan.
The wizard processes transitions through a background job queue, allowing administrators to submit and monitor large groups of Program Enrollments.
Example Scenario
Institution replacing an old Program Plan
- An institution has decided to replace its existing Bachelor of Business Administration (BBA) Program Plan with a revised version for the next academic year.
- Some students are already studying under the old plan. The institution wants these students to continue their studies under the revised plan without losing recognition of courses they have already completed.
For example:
| Item | Existing Setup | New Setup |
|---|---|---|
| Academic Program | Bachelor of Business Administration | Bachelor of Business Administration |
| Program Plan | BBA 2025 | BBA 2027 |
| Program Pathway | Standard Pathway 2025 | Standard Pathway 2027 |
| Course | MGT101 – Management Principles | MGT101 – Management Principles |
| Replaced Course | ACC101 – Accounting Fundamentals | ACC111 – Introduction to Accounting |
The institution wants to:
- Move eligible students from BBA 2025 to BBA 2027.
- Assign the students to Standard Pathway 2027.
- Retain completed course credits for courses that have equivalent requirements in the new plan.
- Map ACC101 to its replacement course, ACC111.
- Update the students' associated course connections and PE Groups.
The administrator can use the Program Transition Wizard to perform this transition in batches.
Prerequisites
Before starting a transition, ensure the following requirements are met.
1. Program Plans belong to the same Academic Program
The existing and new Program Plans must belong to the same Academic Program. The new Program Plan must be different from the existing Program Plan.
Example:

2. Check Course availability and replacement mappings
Every Course associated with the old Program Plan must have either:
- The same or an equivalent Course available in the new Program Plan; or
- An Agreement Course mapping to a replacement Course in the new plan, with Use For Auto Credit Transfer enabled.
For example:
| Old Program Plan | New Program Plan | Mapping |
|---|---|---|
| MGT101 – Management Principles | MGT101 – Management Principles | Same Course |
| ACC101 – Accounting Fundamentals | ACC111 – Introduction to Accounting | Agreement Course mapping |
When a replacement mapping is configured correctly, the wizard automatically reparents the relevant Course Connection to the equivalent Course in the new plan and creates a PE Course Replacement record to track the replacement.
Note: A Course Connection that has no matching Course in the new plan and no valid Agreement Course replacement mapping is considered an orphaned Course Connection. Any Program Enrollment containing such a connection will fail the transition.
3. Configure the Program Transition component
Ensure that the RIO Ed - Program Transition component has been added to the Academic Program (Account) Lightning Record Page.
Example:

4. Activate the Job Queue configuration
Navigate to:
Setup > Custom Metadata Types > Job Queue Config
- Ensure that the Program Transition job configuration is active.
-
The job operation should match the component configuration, which uses
Program_Transitionby default.
Example:

5. Review Job Queue batch sizes
Review the following settings in the Job Queue configuration:
| Setting | Default Value | Description |
|---|---|---|
| Job Generator Batch Size | 100 | Number of records queried at a time when generating transition jobs. |
| Job Handler Batch Size | 5 | Number of Program Enrollments processed in each batch. |
If the transition consistently encounters Apex CPU timeout errors, the administrator may need to reduce these batch sizes.
The appropriate values depend on the number of records and other custom automation running in the Salesforce org.
Example:

How to Use the Program Transition Wizard
Step 1: Open the Academic Program
- Navigate to the relevant Academic Program record.
- Locate the Program Transition Wizard component.
- Review the existing transition jobs, if any.
- The main screen displays Program Transition Job Queue records associated with the selected Academic Program.
- By default, the newest jobs appear first.
Step 2: Create a New Transition Job
- Click New to start a new transition.
- The wizard guides the administrator through four steps.
Step 3: Select the Existing and New Program Plans
- Select the plans and pathway for the transition.
| Field | Description |
|---|---|
| Existing Program Plan | The Program Plan that students will be transitioned from. It must belong to the current Academic Program. |
| New Program Plan | The Program Plan that students will be transitioned to. It must be a different plan under the same Academic Program. |
| New Program Pathway | The Program Pathway that will be assigned to all transitioned Program Enrollments. The available options depend on the selected New Program Plan. |
The New Program Pathway field becomes available after selecting the New Program Plan.
Example:
- Existing Program Plan: BBA 2025
- New Program Plan: BBA 2027
- New Program Pathway: Standard Pathway 2027

Step 4: Select the Program Enrollments
Choose which students should be included in the transition.
There are two selection options.
Option A: All
- Select All to include all eligible Program Enrollments assigned to the existing Program Plan.
- The records included are also subject to the Program Enrollment Statuses configured on the component. The default status is Current.
- For example, if the existing plan has 100 Current Program Enrollments, all 100 eligible records will be included.
Option B: Manual Selection
- Select Manual Selection to choose specific Program Enrollments.
- A filterable table will appear, allowing administrators to identify the required students.
-
Optional filters include:
- Program Offering
- Class Year
- Class Standing
- Select the required Program Enrollments from the table before proceeding.
Note: The Program Enrollment table only appears when Manual Selection is selected. The maximum number of records displayed is controlled by the component configuration.
Step 5: Configure the Transition Rules
Choose whether to update credits for existing completed Course Connections.
Update credits of existing completed course connections?
- Yes: Credits are copied from the old Program Plan requirements to the matching requirements in the new Program Plan.
- No: The wizard does not perform this credit update.
For example, if a student has completed MGT101 under BBA 2025, and the matching requirement in BBA 2027 has a different credit value, selecting Yes allows the credit value to be copied from the old plan requirement.
Recommendation: Review the credit structure of both Program Plans before deciding whether to enable this option.
Step 6: Review the Transition Summary
The Summary screen displays the transition selections before submission.
Review the following information:
- Existing Program Plan
- New Program Plan
- New Program Pathway
- Selected Program Enrollments
- Credit update option
- Ensure that the selections are correct.
- Click Add Job to submit the transition.
Example:

Step 7: Monitor the Transition Jobs
After submission, the wizard creates Job Queue records to process the transition.

The jobs are processed through Salesforce's Apex Queue system in the background when resources are available.
Depending on the number of Program Enrollments and other jobs being processed, some Job Queue records may not appear immediately.
If not all jobs are displayed:
- Wait a few seconds.
- Open the dropdown menu next to New.
- Select Refresh.
- Review the latest job statuses.
The transition jobs can have the following statuses:
| Status | Description |
|---|---|
| Pending | The job is waiting to be processed. |
| Processing | The transition is currently being processed. |
| Completed | The transition job has finished processing. |
| Failed | The transition job encountered an error. |
Once processing finishes, each transitioned Program Enrollment stores a summary in its Program Transition Summary field.

The summary includes:
- Job Queue ID
- Existing and new Program Plans
- Whether credits were updated
- Submitted by
- Completion date and time
Administrators can use this information to review the transition history for each Program Enrollment.
Example:

Understanding the Transition Results
Using the example scenario, assume the administrator transitions students from BBA 2025 to BBA 2027.
After a successful transition:
| Record / Information | Expected Result |
|---|---|
| Program Enrollment | Updated to the new Program Plan. |
| Program Pathway | Assigned to Standard Pathway 2027. |
| Course Connections | Restructured to match the new Program Plan. |
| PE Groups | Restructured to reflect the new plan. |
| Matching Courses | Retained and associated with the corresponding requirements in the new plan. |
| Replacement Courses | Reparented to the mapped replacement Course, with a PE Course Replacement record created. |
| Completed Course Credits | Updated according to the selected credit update option. |
| Program Transition Summary | Stores the transition details on the Program Enrollment. |
Important: The wizard does not automatically resolve orphaned Course Connections. These must be addressed before the affected Program Enrollments can be transitioned successfully.
Troubleshooting
Issue 1: Program Enrollment has Course Connections referencing Courses not present on the new plan
Cause
- The Program Enrollment contains a Course Connection referencing a Course that:
- Does not exist on the new Program Plan; and
- Does not have a valid replacement Course mapping through an Agreement Course with Use For Auto Credit Transfer enabled.
- The Program Enrollment is therefore excluded from the successful transition and marked as failed.
Resolution
- Identify the Course Connection causing the failure.
- Check whether the Course should remain available in the new Program Plan.
- If the Course is still required, add the corresponding Plan Requirement Course to the new Program Plan.
- If the Course has been replaced, create or update the Agreement Course mapping.
- Ensure Use For Auto Credit Transfer is enabled on the relevant Agreement Course.
- Return to the Program Transition Wizard.
- Select the failed Job Queue.
- Choose Retry Jobs > Retry Failed Records.
Issue 2: Some Job Queue records do not appear immediately
Cause
The transition jobs are generated and processed asynchronously. Depending on the number of Program Enrollments and available Salesforce processing resources, the records may take some time to appear.
Resolution
- Wait a few seconds.
- Open the dropdown menu.
- Click Refresh.
- Check the Job Queue list again.
Issue 3: Transition jobs encounter Apex CPU timeout errors
Cause
The batch sizes may be too large for the amount of data being processed or the custom automation running in the Salesforce org.
Resolution
- Navigate to Setup > Custom Metadata Types > Job Queue Config.
- Locate the Program Transition job configuration.
- Review the Job Generator Batch Size and Job Handler Batch Size.
- Reduce the batch sizes if necessary.
- Retry the failed transition jobs after reviewing the configuration.
- Consult your Salesforce administrator or RIO Education support team if the timeout continues.
Summary
The Program Transition Wizard simplifies the process of moving students from an old Program Plan to a replacement plan within the same Academic Program.
By preparing the new Program Plan, checking Course mappings, selecting eligible Program Enrollments, and reviewing the transition rules, administrators can transition students in batches while restructuring their associated Course Connections, PE Groups, and Program Pathway assignments.
After submission, administrators can monitor the background jobs, resolve failed records, and retry unsuccessful transitions without having to restart the entire process.