Description

Whenever a new Program Enrollment with an in-progress Status is inserted, or whenever an existing Program Enrollment is updated from a draft Status to an in-progress Status, this class creates PE Group records for each of the related Program Plan's group Plan Requirements‍.

It links each new PE Group to the Program Enrollment and Plan Requirement, and sets the PE Group Name, Category, Credits, Description, Max Credits, Hide in Enrollment, Show Child Groups, Courses Required, and Credits equivalent per Course fields using the corresponding values from the Plan Requirement. In the case of shared groups, it will also create a PE Group for reach of the group's child group Plan Requirements.

Furthermore, for each Pathway Unit in the Program Pathway, this class will create a new PE Pathway record, linking it to the Program Enrollment and Program Pathway and setting the Notes, Number of Terms, Study Mode, Recommended Credits, and Max Credits field using the values from the Program Pathway.

If the Program Pathway's Enrollment Method is 'Automatic all terms' or if the My Term field is 1 and the Program Pathway's Enrollment Method is 'Automatic by term/course', then the Automatically Enroll in Courses field is set to true.

If the My Term field is 1, then the Term field is set to the Starting Term field value from the Program Enrollment record. If that field is not set, then it uses the Next Starting Term field from the Program Pathway's related Program Plan‍.

If the My Term field is not 1, then the Term‍ is set based on previous Term hierarchy.

Use case

Suppose a scenario where a student has applied for a Program, but the Program Enrollment is still in draft and not approved by the administrators yet, who are tracking if the application fees have been paid.

Once these are paid, the student is approved to enroll, and the Program Enrollment status is changed from 'Draft' to 'Current'. This trigger will then automatically create records of enrollment to the Plan Requirements.