US English (US)
ES Spanish

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Log in
English (US)
US English (US)
ES Spanish
  • Home
  • Help & Support
  • Support
  • Support FAQs
  • FAQ: Program Management

Transitioning Students to a New Program Plan Using the Program Transition Wizard

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • RIO Certification
    RIO Certification Program RIO Academy RIO Challenge RIO Recipe Training
  • Releases
    V3 Release Notes V4 Release Notes
  • Help & Support
    Install RIO Education RIO Insights RIO Recipe Support RIO Graduate/Intern Program Trainee (GPT)
  • Experience RIO in action
  • RIO Insights
+ More

Table of Contents

Overview Purpose Example Scenario Institution replacing an old Program Plan Prerequisites 1. Program Plans belong to the same Academic Program 2. Check Course availability and replacement mappings 3. Configure the Program Transition component 4. Activate the Job Queue configuration 5. Review Job Queue batch sizes How to Use the Program Transition Wizard Step 1: Open the Academic Program Step 2: Create a New Transition Job Step 3: Select the Existing and New Program Plans Step 4: Select the Program Enrollments Step 5: Configure the Transition Rules Step 6: Review the Transition Summary Step 7: Monitor the Transition Jobs Understanding the Transition Results Troubleshooting Issue 1: Program Enrollment has Course Connections referencing Courses not present on the new plan Issue 2: Some Job Queue records do not appear immediately Issue 3: Transition jobs encounter Apex CPU timeout errors Summary

 

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_Transition by 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.

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Is it possible to expose multiple pathways in the student community?
  • How enrolled Course credits are escalated to student's enrolled Pathway
  • Multiple Pathways vs Tracks
  • How to prevent Completion Engine from running Program Enrollment with a specific academic Program
  • Calculate Program Enrollment End Date at early stage of enrollment
RIO Education

RIO Education, a WDCi Company. This information is proprietary, confidential and protected by copyright ©2024.

CONTACT

Get in touch

  • Privacy
  • Terms of service

Knowledge Base Software powered by Helpjuice

Definition by Author

0
0
Expand