Skip to main content
CollegeSource Support

Exception Forms


exception.xml is the configuration file for the exception screens in Self-Service. Screens for any exception type that users will be allowed to add or remove must be configured in this file.

Standard view and xml view are compared side-by-side using red numbered labels to draw comparisons.


Student Exception List


The main list screen for a student's exceptions is configured separately from the pages for individual exception types.

The list screen is defined in the StuException page element. Any detailView elements used

within the StuException page will be ignored.



Exception Types

In order for an exception type to be available in Self-Service, it must first be added to the exceptions element, below:

In each ctlcd, the name attribute is the ctlcd value for that exception type in the Gmaster table and the label attribute contains a description of the type. The page attribute is the name of the xml page definition that controls the form for the exception type, which must also be configured in exception.xml.


The exception types that exist in the Gmaster table and have been configured for Self-Service

are shown at the top of the "Choose an Exception Type" page.

The fields displayed on this list are configured in the StuException.Gmaster page element.



A hyperlink at the bottom of the "Choose an Exception Type" type page generates a list of exception types that exist in the Gmaster table,

but do not have a page definition in Self-Service. Click Show Unconfigured Exception Types to view the list.

The display of this list is controlled by the StuException.UnconfiguredGmaster page element.

Specific Exception Types

Each exception page element in Self-Service will look different depending on the action for that exception type. The same field may have different meanings depending upon the exception type. For example, when performing a Course Substitution type of exception (ACTION=S or C), the COURSE field represents a course in the student's record. When performing an exception to enter a Marker association (ACTION=$), the COURSE field represents the requirement name or degree program name associated with that $MARKER in the degree program.


One common type of exception is Course Substitution (see below)

Page elements for exception types are defined in the same way as any other page element, with one exception:

masterview attributes are not used to configure columns for exception pages. This is because the masterview (list screen) is

defined in its own page element. The page for the Course Substitution screen is shown below:


Exception Courses

Certain types of exceptions, such as those with an exception type of "R" (course replacement), have exception courses tied to them.

The StuExcCourse page element controls the fields displayed for exception courses.

A link to add an exception course will appear at the bottom of the form for adding or editing these types of exceptions.

The exception course page is shown below:


  • Was this article helpful?